Mobile native

Maps Service

Map service features include geocoding, reverse geocoding, place searching, and route calculation.

This feature is supported in mobile applications only.

The main Maps Service API features are:

  • Discovering and selecting a map provider

    You can also specifying basic maps preferences.

  • Geocoding and reverse geocoding

    You can get the geocode (geographical coordinates) of a place based on an address, or the reverse geocode (address) based on the geographical coordinates (latitude and longitude).

  • Searching places

    You can query place information, corresponding to specified search keys and filters.

  • Searching routes

    You can query a route that defines a path between a start and destination point, passing optionally through specific intermediate locations and calculated using a specified transportation method.

  • Handling map service responses

    You can receive responses from the map service through various callbacks.

The following map provider is supported:

Note
To use the map service, you must get an access key to the map provider from the provider developer site. The service must be used according to the provider's Term of Use.

Geocodes

The following geocode request types are provided:

  • Get place coordinates based on a free text address.
  • Get place coordinates based on a free text address within a specified geographical area.
  • Get place coordinates based on a structured address (a structure with fields, such as city, street, and building number).

The geocode response is a geographical location, specified with latitude and longitude values.

Only 1 type of reverse geocode request is provided:

  • Get a structured address based on place coordinates.

The reverse geocode response is structured address information, comprising, for example, of a street name, building number, city name, postal code, district name, state name, and country.

Place Search

The following place search request types are provided:

  • Query place information within a specific distance around a specified geographical location.
  • Query place information within a specified geographical area.
  • Query place information based on a free text address within a specified geographical area.

The place search response is structured place information, comprising, for example, of a place ID, name and URL, address, geographical location and distance from the center of the search area, place category, rating, review, and image.

Note
Depending on the map provider, some types of place information can be unavailable.

Route Search

The following route search request types are provided:

  • Query a route from a starting point to a destination specified as a geographical location.
  • Query a route passing through a number of geographical locations.

The route calculation response is structured route information, comprising, for example, of a route ID, geographical coordinates of the start and destination point, route bounding box, transportation mode, and total distance and duration.

Note
Depending on the map provider, the route can be presented as a list of geographical points or segments. The segment list can also be presented as a list of geographical points or maneuvers.

Map Service Responses

The asynchronous map service responses are implemented with callback interfaces (functions whose names end with cb).

To handle the responses, you can use the map service response states:

  • MAPS_SERVICE_ERROR_NONE: The map service is working correctly.
  • MAPS_ERROR_PERMISSION_DENIED: The user has revoked a permission for the application to use the map service.
  • MAPS_ERROR_NOT_SUPPORTED: The map request or feature you are trying to use is not supported in the map provider.
  • MAPS_ERROR_NETWORK_UNREACHABLE, MAPS_ERROR_SERVICE_NOT_AVAILABLE, or MAPS_ERROR_CONNECTION_TIME_OUT: The map provider cannot access the map server for various reasons.
Go to top