Contents

Reverse geocode a location

Returns an array of addresses present at the coordinates you provide.

URL

GET https://maps-api.apple.com/v1/reverseGeocode

Query Parameters

NameTypeDescription
loc Requiredstring

The coordinate to reverse geocode as a comma-separated string that contains the latitude and longitude. For example: loc=37.3316851,-122.0300674.

lang OptionalLang

The language the server uses when returning the response, specified using a BCP 47 language code. For example, for English, use lang=en-US.

Response Codes

StatusReasonTypeDescription
200OK
Content-Type: application/json
PlaceResults

An array of one or more Place objects.

400Bad Request
Content-Type: application/json
ErrorResponse

An ErrorResponse object that contains an error message and an array of strings that contain additional details.

401Unauthorized
Content-Type: application/json
ErrorResponse

An ErrorResponse object that contains an error message that indicates the Maps access token is missing or invalid, and an array of strings that contains additional details about the error.

429
Content-Type: application/json
ErrorResponse

An ErrorResponse object that indicates the call exceeds the daily service call quota for the authorization token presented. The app should try again later. If your app requires a larger daily quota, submit a quota increase request form.

500Internal Server Error
Content-Type: application/json
ErrorResponse

An ErrorResponse object that contains a server error message and an array of strings that contains additional details about the error.

Discussion

Example

See Also

Geocoding