<!--
{
  "documentType" : "article",
  "framework" : "AppleMapsServerAPI",
  "identifier" : "/documentation/AppleMapsServerAPI/common-objects",
  "metadataVersion" : "0.1.0",
  "role" : "collectionGroup",
  "title" : "Common objects"
}
-->

# Common objects

Understand the common JSON objects that API responses contain.

## Topics

### Getting an access token

[`TokenResponse`](/documentation/AppleMapsServerAPI/TokenResponse)

An object that contains an access token and an expiration time in seconds.

### Getting common object information

[`AutocompleteResult`](/documentation/AppleMapsServerAPI/AutocompleteResult)

An object that contains information you can use to suggest addresses and further refine search results.

[`DirectionsResponse`](/documentation/AppleMapsServerAPI/DirectionsResponse)

An object that describes the directions from a starting location to a destination in terms routes, steps, and a series of waypoints.

[`EtaResponse`](/documentation/AppleMapsServerAPI/EtaResponse)

An object that contains an array of one or more estimated times of arrival (ETAs).

[`Location`](/documentation/AppleMapsServerAPI/Location)

An object that describes a location in terms of its longitude and latitude.

[`MapRegion`](/documentation/AppleMapsServerAPI/MapRegion)

An object that describes a map region in terms of its upper-right and lower-left corners as a pair of geographic points.

[`Place`](/documentation/AppleMapsServerAPI/Place)

An object that describes a place in terms of a variety of spatial, administrative, and qualitative properties.

[`PlaceResults`](/documentation/AppleMapsServerAPI/PlaceResults)

An object that contains an array of places.

[`SearchAutocompleteResponse`](/documentation/AppleMapsServerAPI/SearchAutocompleteResponse)

An array of autocomplete results.

[`SearchMapRegion`](/documentation/AppleMapsServerAPI/SearchMapRegion)

An object that describes an area to search in terms of its upper-right and lower-left corners as a pair of geographic points.

[`SearchResponse`](/documentation/AppleMapsServerAPI/SearchResponse)

An object that contains the search region and an array of place descriptions that a search returns.

[`StructuredAddress`](/documentation/AppleMapsServerAPI/StructuredAddress)

An object that describes the detailed address components of a place.

### Getting common type information

[`CountryCode`](/documentation/AppleMapsServerAPI/CountryCode)

A string that represents a two-letter country code.

[`DirectionsAvoid`](/documentation/AppleMapsServerAPI/DirectionsAvoid)

A list of the features you can request to avoid when calculating directions.

[`Lang`](/documentation/AppleMapsServerAPI/Lang)

A string that represents a standard tag for identifying languages.

[`PoiCategory`](/documentation/AppleMapsServerAPI/PoiCategory)

A string that describes a specific point of interest (POI) category.

[`SearchLocation`](/documentation/AppleMapsServerAPI/SearchLocation)

A string that describes a geographic location in the form of longitude and latitude.

[`SearchRegion`](/documentation/AppleMapsServerAPI/SearchRegion)

A string that describes a region to search in terms of its upper-right and lower-left corners as a pair of geographic points.

[`UserLocation`](/documentation/AppleMapsServerAPI/UserLocation)

A string that describes the user’s location in terms of longitude and latitude.

### Handling errors

[`ErrorResponse`](/documentation/AppleMapsServerAPI/ErrorResponse)

Information about an error that occurs while processing a request.


---

Copyright &copy; 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)