| MobileForms Toolkit Documentation |
|
Resco.Location.Services Namespace
Location Services Overview
Resco.Location.Services contains .Net classes that allow the use of selected Google/Bing map services. The services are organized by namespaces:
- Namespace Resco.Location.Services contains general classes shared by all services.
- Resco.Location.Services.GeoCode uses Bing Locations API, resp. Google Geocoding API
- Resco.Location.Services.GeoRoute uses Bing Routes API, resp. Google Directions API
- Resco.Location.Services.Map uses Bing Imagery API, resp. Google Static Maps API
Notes:
- All the service classes do is the communication with suitable web service. They don't need GPS receiver. In fact GPS tracking and location services are unrelated activities.
- All Location services require Internet connection.
- There are different limitations for the map services.
Google Maps Services
Usage Limits
Following restrictions apply (for ordinary users):
- 1000 unique (different) image requests per viewer per day.
- Geocoding API: 2500 requests per day
- Directions API: 2500 requests per day, with up to 8 intermediate waypoints
Additionally:
- Maps may only be displayed in the browser; use outside of the browser is not allowed.
- Directions/Geocoding results may only be used to display the results in relation to a Google map; unrelated uses are prohibited.
- Directions API generates copyrights which must be displayed to the user in some fashion.
- All URLs (maps/geocode/georoute) are restricted to 2048 characters in size (before URL encoding). (Problems: Too many markers etc.)
See more about Google Limits
Google Maps API Premier
You can purchase Google Maps API Premier with several advantages:
- Service Level Agreement provides 99.9% uptime guarantee
- Price is based on the number of map views and starts at $10/year.
- Https support (unsupported by Resco.Location)
Premier API limitations (Higher limits can be purchased.):
- Geocoding API: 100,000 requests per day
- Directions API: 100,000 requests per day and a maximum of 23 waypoints per request
- Maps: Image display outside viewer allowed.
After you purchase Google Maps API Premier, you will receive special key - a string that has to be set to
GoogleApiKey
See more about Maps API Premier
Microsoft BING Services
Bing Maps API represents numerous interfaces.
One of them - Bing Maps REST Services - is used in Resco.Location library.
(Another interesting example is Bing Maps Silverlight Control available f.e. on Windows Phone 7.)
You must have a Bing Maps Developer Account to get a Bing Maps Key. This key is used in every web service request and is used for transaction counting.
For more information see Getting a Bing Maps Key.
Bing Maps Key has to be set to
BingApiKey
Usage Limits
Microsoft imposes rather liberal limits on the free transactions, f.e.
- 50,000 transactions per day
- 500,000 transactions per year
Additionally
- You have to display Bing logo and copyrights.
- “Real-time” navigation is forbidden
- You may not integrate Bing maps with other map platforms (i.e. use either Bing or Google, but not both)
(See the Terms of use for Bing Maps.)
Higher limits and more liberal conditions can be negotiated.
Namespace hierarchy
Classes
| Class |
Description |
|
ServiceRequestException
|
Represents an exception which may be thrown during the location service request. |
|
ServiceSettings
|
Represents global options used by all location service requests. |
Enumerations