---
title: Apple Maps Server API
framework: Apple Maps Server API
role: collection
role_heading: Web Service
platforms: [apple maps server api 1.2+]
path: applemapsserverapi
---

# Apple Maps Server API

Reduce API calls and conserve device power by streamlining your app’s georelated searches.

## Overview

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 API](applemapsserverapi/creating-and-using-tokens-with-maps-server-api.md)
- [Creating a Maps identifier and a private key](applemapsserverapi/creating-a-maps-identifier-and-a-private-key.md)
- [Generate a Maps token](applemapsserverapi/-v1-token.md)
- [Debugging an Invalid token](applemapsserverapi/debugging-an-invalid-token.md)
- [Common objects](applemapsserverapi/common-objects.md)
- [Integrating the Apple Maps Server API into Java server applications](applemapsserverapi/integrating-the-apple-maps-server-api-into-java-server-applications.md)

### Geocoding

- [Geocode an address](applemapsserverapi/-v1-geocode.md)
- [Reverse geocode a location](applemapsserverapi/-v1-reversegeocode.md)

### Searching

- [AddressCategory](applemapsserverapi/addresscategory.md)
- [SearchACResultType](applemapsserverapi/searchacresulttype.md)
- [SearchResultType](applemapsserverapi/searchresulttype.md)
- [AlternateIdsResponse](applemapsserverapi/alternateidsresponse.md)
- [AlternateIdsResponse.AlternateIds](applemapsserverapi/alternateidsresponse/alternateids.md)
- [PlacesResponse](applemapsserverapi/placesresponse.md)
- [PlacesResponse.PlaceLookupError](applemapsserverapi/placesresponse/placelookuperror.md)
- [Search for places that match specific criteria](applemapsserverapi/-v1-search.md)
- [Search for places that meet specific criteria to autocomplete a place search](applemapsserverapi/-v1-searchautocomplete.md)
- [Search for a place using an identifier](applemapsserverapi/-v1-place-:id.md)
- [Search for places using mulitple identifiers](applemapsserverapi/-v1-place.md)
- [Obtain a list of alternate place identifiers](applemapsserverapi/-v1-place-alternateids.md)

### Directions

- [Search for directions and estimated travel time between locations](applemapsserverapi/-v1-directions.md)
- [Determine estimated arrival times and distances to one or more destinations](applemapsserverapi/-v1-etas.md)