# 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 . Use these credentials to access the API from your app, or use them on [Try Maps Server API](https://developer.apple.com/maps/try-maps-server-api/). The Apple Maps Server API is a web-based API similar to the 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 . - To create tokens from your identifier and private key with the Apple Maps Server API, follow the steps in . - Use the Token API to ``doc://com.apple.applemapsserverapi/documentation/AppleMapsServerAPI/-v1-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](https://developer.apple.com/contact/request/mapkitjs/). ## Topics ### Essentials [Creating and using tokens with Maps Server API](/documentation/AppleMapsServerAPI/creating-and-using-tokens-with-maps-server-api) Sign JSON Web Tokens to use Maps Server API and debug common signing errors. [Creating a Maps identifier and a private key](/documentation/AppleMapsServerAPI/creating-a-maps-identifier-and-a-private-key) Create a Maps identifier and a private key before generating tokens for MapKit JS. [`Generate a Maps token`](/documentation/AppleMapsServerAPI/-v1-token) Returns a JWT maps access token that you use to call the service API. [Debugging an Invalid token](/documentation/AppleMapsServerAPI/debugging-an-invalid-token) Inspect the JavaScript console logs, the token, and events to determine why a token is invalid. [Common objects](/documentation/AppleMapsServerAPI/common-objects) Understand the common JSON objects that API responses contain. [Integrating the Apple Maps Server API into Java server applications](/documentation/AppleMapsServerAPI/integrating-the-apple-maps-server-api-into-java-server-applications) Streamline your app’s API by moving georelated searches from inside your app to your server. ### Geocoding [`Geocode an address`](/documentation/AppleMapsServerAPI/-v1-geocode) Returns the latitude and longitude of the address you specify. [`Reverse geocode a location`](/documentation/AppleMapsServerAPI/-v1-reverseGeocode) Returns an array of addresses present at the coordinates you provide. ### Searching [`AddressCategory`](/documentation/AppleMapsServerAPI/AddressCategory) Search categories related to political geographical boundaries. [`SearchACResultType`](/documentation/AppleMapsServerAPI/SearchACResultType) An enumerated string that indicates the result type for the search request. [`SearchResultType`](/documentation/AppleMapsServerAPI/SearchResultType) An enumerated string that indicates the result type for the search autocomplete request. [`AlternateIdsResponse`](/documentation/AppleMapsServerAPI/AlternateIdsResponse) A list of alternate Place IDs and associated errors. [`AlternateIdsResponse.AlternateIds`](/documentation/AppleMapsServerAPI/AlternateIdsResponse/AlternateIds) Contains a list of alternate Place IDs for a given Place ID. [`PlacesResponse`](/documentation/AppleMapsServerAPI/PlacesResponse) A list of Place IDs and errors. [`PlacesResponse.PlaceLookupError`](/documentation/AppleMapsServerAPI/PlacesResponse/PlaceLookupError) An error associated with a lookup call. [`Search for places that match specific criteria`](/documentation/AppleMapsServerAPI/-v1-search) Find places by name or by specific search criteria. [`Search for places that meet specific criteria to autocomplete a place search`](/documentation/AppleMapsServerAPI/-v1-searchAutocomplete) Find results that you can use to autocomplete searches. [`Search for a place using an identifier`](/documentation/AppleMapsServerAPI/-v1-place-:id) Obtain a Place object for a given Place ID. [`Search for places using mulitple identifiers`](/documentation/AppleMapsServerAPI/-v1-place) Obtain a set of Place objects for a given set of Place IDs. [`Obtain a list of alternate place identifiers`](/documentation/AppleMapsServerAPI/-v1-place-alternateIds) Get a list of alternate Place IDs given one or more Place IDs. ### Directions [`Search for directions and estimated travel time between locations`](/documentation/AppleMapsServerAPI/-v1-directions) Find directions by specific criteria. [`Determine estimated arrival times and distances to one or more destinations`](/documentation/AppleMapsServerAPI/-v1-etas) Returns the estimated time of arrival (ETA) and distance between starting and ending locations. --- Copyright © 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)