Apple Maps Server API
Reduce API calls and conserve device power by streamlining your app’s georelated searches.
Overview
Use this web-based service to streamline your app’s API by moving georelated searches for places, points of interest, geocoding, directions, possible autocompletions for searches, and estimated time of arrival (ETA) calculations from inside your app to your server.
To try the Maps Server API, generate a temporary token as described in Creating a Maps token. Use these credentials to access the API from your app, or use them on Try Maps Server API.
The Apple Maps Server API is a web-based API similar to the MapKit JS API, and uses the same authorization infrastructure. It requires authorization using a JSON Web Token (JWT) for API calls. You obtain a key for creating the token when you complete the setup in your Apple Developer account.
To start using the API, you first need to generate an identifier and a private key, and authenticate with the service, following the steps below:
To create an identifier and private key, follow the steps in Creating a Maps identifier and a private key.
To create tokens from your identifier and private key with the Apple Maps Server API, follow the steps in Creating and using tokens with Maps Server API.
Use the Token API to Generate a Maps token for API access.
The service provides up to 25,000 service calls per day per team between Apple Maps Server API and MapKit JS. If your app exceeds this quota, the service returns an HTTP 429 error (Too Many Requests) and your app needs to retry later. If your app requires a larger daily quota, submit a quota increase request form.
Topics
Essentials
Creating and using tokens with Maps Server APICreating a Maps identifier and a private keyGenerate a Maps tokenDebugging an Invalid tokenCommon objectsIntegrating the Apple Maps Server API into Java server applications
Geocoding
Searching
AddressCategorySearchACResultTypeSearchResultTypeAlternateIdsResponseAlternateIdsResponse.AlternateIdsPlacesResponsePlacesResponse.PlaceLookupErrorSearch for places that match specific criteriaSearch for places that meet specific criteria to autocomplete a place searchSearch for a place using an identifierSearch for places using mulitple identifiersObtain a list of alternate place identifiers