---
title: "GET /geocode"
method: GET
path: "/geocode"
---

# GET /geocode

`GET /geocode`

**Geocoding**

**Applies to:** see pricing [tiers](https://aka.ms/AzureMapsPricingTier).

In many cases, the complete search service might be too much, for instance if you are only interested in traditional geocoding. Search can also be accessed for address look up exclusively. The geocoding is performed by hitting the geocoding endpoint with just the address or partial address in question. The geocoding search index will be queried for everything above the street level data. No POIs will be returned. Note that the geocoder is very tolerant of typos and incomplete addresses. It will also handle everything from exact street addresses or street or intersections as well as higher level geographies such as city centers, counties, states etc.
>[!Important]
>By using this feature, you agree to the preview legal terms. See the [Preview Supplemental Terms](https://azure.microsoft.com/support/legal/preview-supplemental-terms/) for additional details.

## Query parameters

- `api-version` string, required
- `top` integer
- `addressLine` string
- `countryRegionSet` string[]
- `bbox` number[]
- `view` string
- `location` number[]
- `adminDistrict` string
- `adminDistrict2` string
- `adminDistrict3` string
- `locality` string
- `postalCode` string
- `strictMatch` 'notstrict' | 'strict'

## Headers

- `Accept-Language` string

## Parameters

- `../../../Common/preview/1.0/common.json#/components/parameters/ClientId` — unresolved $ref

## Response `200`

OK

## Other responses

- `default` — unresolved $ref

## Changes

- **2026-07-13** (1.0) `2bfc7c2d192d` — 1 info
  - endpoint added
- **2026-07-13** (1.0) `0e0c2063abbc` — 1 breaking
  - api path removed without deprecation
- **2026-07-13** (1.0) `c6ee214858e9` — 1 info
  - added the new optional `query` request parameter `query`
- **2025-10-15** (1.0) `69718fe8c37a` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/azure/apis/maps-search/changes/geocode/get.md)

---

[API](https://skmtc.dev/azure/apis/maps-search.md) · [All operations](https://skmtc.dev/azure/apis/maps-search/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/azure/maps-search/revisions/2bfc7c2d192d/schema)