---
title: "Reverse-geocode a coordinate with Apple Maps"
method: GET
path: "/apple-maps/reverse-geocode"
tags: ["Apple Maps"]
---

# Reverse-geocode a coordinate with Apple Maps

`GET /apple-maps/reverse-geocode`

## Request

- Base URL: `https://api.crawlora.net/api/v1`
- URL: `https://api.crawlora.net/api/v1/apple-maps/reverse-geocode`
- Auth: API key in header `x-api-key`

Returns Apple Maps' address record for a coordinate: the matched place name and type (an address, street, or area of interest such as a neighborhood), the formatted and structured address, the matched center, the IANA timezone, and the display region.

## Query parameters

- `latitude` number, required
- `longitude` number, required
- `lang` string
- `country` string

## Headers

- `x-api-key` string, required

## Response `200`

OK

- ApplemapsReverseGeocodeResponseDoc
  - `code` integer: Code is the HTTP status code or a custom code used to indicate the result of the request @example 200
  - `data` ApplemapsReverseGeocodeResponse
    - `address` string
    - `address_info` ApplemapsAddress
      - `city` string
      - `country` string
      - `country_code` string
      - `county` string
      - `neighborhood` string
      - `postal_code` string
      - `state` string
      - `state_code` string
      - `street` string
    - `latitude` number
    - `longitude` number
    - `matched_latitude` number
    - `matched_longitude` number
    - `name` string
    - `region` ApplemapsRegion
      - `east` number
      - `north` number
      - `south` number
      - `west` number
    - `timezone` string
    - `type` string
  - `msg` unknown

## Other responses

- `400`: Bad Request
- `404`: Not Found
- `503`: Service Unavailable

---

[API](https://skmtc.dev/crawlora/apis/crawlora-api.md) · [All operations](https://skmtc.dev/crawlora/apis/crawlora-api/llms.txt) · [OpenAPI document](https://skmtc.dev/crawlora/apis/crawlora-api/revisions/0497899e2016?raw)
