Git Product home page Git Product logo

muhammad-ismaieel / bing-maps-fleet-tracker Goto Github PK

View Code? Open in Web Editor NEW

This project forked from microsoft/bing-maps-fleet-tracker

0.0 0.0 0.0 3.37 MB

The Bing Maps Fleet Tracker is a tracking solution for small to medium sized teams. Easily track vehicles and mobile devices. Previously known as "Project Hurghada".

License: MIT License

C# 62.67% TypeScript 28.00% JavaScript 0.77% CSS 1.70% HTML 6.85%

bing-maps-fleet-tracker's Introduction

Bing Maps Fleet Tracker

Bing Maps Fleet Tracker is a fleet management solution based on the Bing Maps APIs. It offers functionalities that enable tracking and managing a fleet of vehicles in real time. For more details, read this blog post.

Getting Started

To get this project up and running, the easiest way is to use the Bing Maps Fleet Tracker Deployment Portal, which one-click deploy the Bing Maps Fleet Tracker solution into your Azure subscription. For a step by step walkthrough of how to deploy use the deployment portal, see out of the box deployment. None of the data entered on the deployment portal is stored by Bing Maps Fleet Tracker. It is only used to configure your deployment.

You can obtain a prebuilt apk of the Android client here. For the iOS client, you will need to build it from source.

You can also build and run the project from source as detailed here.

For a walkthrough of using the Bing Maps Fleet Tracker solution, see WALKTHROUGH.md.

Build and Run

The Bing Maps Fleet Tracker solution consist of 3 major components:

Each of these components can be built and run separately, and each can be replaced with implementations of your own.

Backend Services

The backend services are responsible for the collection and processing of location information, the provisioning of tracking devices and assets, dispatching, and report generation. They are made up of an ASP.NET Core 2 service, and two Azure Functions. For more information on building an running the backend services see Backend\README.md.

Administration Portal

The administration portal is an angular application that exposes the functionalities of the backend to the deployment administrators. It can be used to view reports, track and provision assets, and compare dispatching routes. For more information on building an running the administration portal see Frontend\README.md.

Mobile Client

The mobile client is an ionic mobile application responsible for collection of asset location information and the forwarding of this information to the backend. It is meant to provide an out of the box background tracking solution but it is not the only way to integrate with Bing Maps Fleet Tracker; any GPS device with an internet connection can be used to provide the background tracking (see Using the Rest APIs). For more information on building and running the mobile client see MobileClient\README.md.

Telemetry collected by Bing Maps Fleet Tracker

After deployment, on your first use of the application, you will be prompted to allow us to collect anonymous aggregate telemetry and error/warning log data. We use the telemetry data to get a feel for the usage of this project. Error log data are used to focus our efforts on fixing the issues you face.

Here is a list of all the telemetry items we collect:

  • Deployment Id: this is a random GUID that is unique for each deployment.
  • Assets count: the total number of vehicles registered.
  • Locations count: the total number of locations stored.
  • Auto locations count: the number of automatically detected locations.
  • Tracking devices count: the total number of tracking devices.
  • Geo-fences count: the number of geo-fences setup.
  • Tracking points count: the number of tracking points stored on the system.

Error/warning log data collected consist of:

  • Deployment Id: this is a random GUID that is unique for each deployment.
  • Software version: the version of the software causing the error/warning.
  • Error/warning message: the error/warning message.

You can always enable/disable the data collection from the settings tab in your administration portal.

Contributing

This project welcomes contributions and suggestions. Most contributions require you to agree to a Contributor License Agreement (CLA) declaring that you have the right to, and actually do, grant us the rights to use your contribution. For details, visit https://cla.microsoft.com.

When you submit a pull request, a CLA-bot will automatically determine whether you need to provide a CLA and decorate the PR appropriately (e.g., label, comment). Simply follow the instructions provided by the bot. You will only need to do this once across all repos using our CLA.

This project has adopted the Microsoft Open Source Code of Conduct. For more information see the Code of Conduct FAQ or contact [email protected] with any additional questions or comments.

History

See release history.

bing-maps-fleet-tracker's People

Contributors

mustafaleithy avatar momohs avatar microsoftopensource avatar manojattal avatar msftgits avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.