Azure Maps Search API

The Search API from Azure Maps — 2 operation(s) for search.

GitHub OpenAPI

Operations 1

GET /search/polygon Use to get polygon data of a geographical area shape such as a city or a… #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/microsoft-azure-maps:microsoft-azure-maps-search-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

microsoft-azure-maps-search-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Maps Search API
  version: '2026-01-01'
  description: Azure Maps Search REST APIs
  x-typespec-generated:
  - emitter: '@azure-tools/typespec-autorest'
security:
- AadToken:
  - https://atlas.microsoft.com/.default
- AzureKey: []
- SasToken: []
tags:
- name: Search
paths:
  /search/polygon:
    get:
      operationId: Search_GetPolygon
      summary: Use to get polygon data of a geographical area shape such as a city or a…
      description: The `Get Polygon` API is an HTTP `GET` request that supplies polygon data of a geographical area outline such as a city or a country region.
      parameters:
      - $ref: '#/components/parameters/Azure.Core.Foundations.ApiVersionParameter'
      - name: x-ms-client-id
        in: header
        description: Specifies which account is intended for usage in conjunction with the Azure AD security model.  It represents a unique ID for the Azure Maps account and can be retrieved from the Azure Maps management plane Account API. For more information on using Microsoft Entra ID security in Azure Maps, see [Manage authentication in Azure Maps](/azure/azure-maps/how-to-manage-authentication).
        required: false
        x-ms-client-name: clientId
        schema:
          type: string
      - name: Accept-Language
        in: header
        description: 'Language in which search results should be returned.


          Please refer to [Supported Languages](/azure/azure-maps/supported-languages?pivots=service-latest) for details.'
        required: false
        x-ms-client-name: acceptLanguage
        schema:
          type: string
      - name: coordinates
        in: query
        description: 'A point on the earth specified as a longitude and latitude. Example: &coordinates=lon,lat'
        required: true
        style: form
        explode: false
        schema:
          type: array
          items:
            type: number
            format: double
          maxItems: 2
          minItems: 2
      - name: view
        in: query
        description: 'A string that represents an [ISO 3166-1 Alpha-2 region/country code](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2). This will alter Geopolitical disputed borders and labels to align with the specified user region. By default, the View parameter is set to "Auto" even if you haven''t defined it in the request.


          Please refer to [Supported Views](https://aka.ms/AzureMapsLocalizationViews) for details and to see the available Views.'
        required: false
        schema:
          type: string
      - name: resultType
        in: query
        description: The geopolitical concept to return a boundary for. If not specified, the default is `countryRegion` result type.
        required: false
        x-ms-enum:
          name: BoundaryResultTypeEnum
          modelAsString: true
          values:
          - name: countryRegion
            value: countryRegion
            description: A country or region.
          - name: adminDistrict
            value: adminDistrict
            description: First administrative level within the country/region, such as a state or a province.
          - name: adminDistrict2
            value: adminDistrict2
            description: Second administrative level within the country/region, such as a county.
          - name: postalCode
            value: postalCode
            description: The smallest postal code category, such as a zip code.
          - name: postalCode2
            value: postalCode2
            description: 'The next largest postal code category after `postalCode` that is created by aggregating

              `postalCode` areas.'
          - name: postalCode3
            value: postalCode3
            description: 'The next largest postal code category after `postalCode2` that is created by aggregating

              `postalCode2` areas.'
          - name: postalCode4
            value: postalCode4
            description: 'The next largest postal code category after `postalCode3` that is created by aggregating

              `postalCode3` areas.'
          - name: neighborhood
            value: neighborhood
            description: 'A locally recognized area within a populated place, often with informal or culturally

              defined boundaries.'
          - name: locality
            value: locality
            description: A concentrated area of human settlement, such as a city, town or village.
        schema:
          type: string
          enum:
          - countryRegion
          - adminDistrict
          - adminDistrict2
          - postalCode
          - postalCode2
          - postalCode3
          - postalCode4
          - neighborhood
          - locality
          default: countryRegion
      - name: resolution
        in: query
        description: Resolution determines the amount of points to send back. If not specified, the default is medium resolution.
        required: false
        x-ms-enum:
          name: ResolutionEnum
          modelAsString: true
          values:
          - name: small
            value: small
            description: Returns the boundary geometry with the fewest points.
          - name: medium
            value: medium
            description: Returns the boundary geometry with the same number of points as `small` or more.
          - name: large
            value: large
            description: Returns the boundary geometry with the same number of points as `medium` or more.
          - name: huge
            value: huge
            description: Returns the boundary geometry with the same number of points as `large` or more.
        schema:
          type: string
          enum:
          - small
          - medium
          - large
          - huge
          default: medium
      responses:
        '200':
          description: The request has succeeded.
          content:
            application/geo+json:
              schema:
                $ref: '#/components/schemas/Boundary'
            application/json:
              schema:
                $ref: '#/components/schemas/Boundary'
        default:
          description: An unexpected error response.
          headers:
            x-ms-error-code:
              description: String error code indicating what went wrong.
              schema:
                type: string
          content:
            application/geo+json:
              schema:
                $ref: '#/components/schemas/Azure.Core.Foundations.ErrorResponse'
            application/json:
              schema:
                $ref: '#/components/schemas/Azure.Core.Foundations.ErrorResponse'
      tags:
      - Search
components:
  schemas:
    GeoJsonGeometryCollection:
      type: object
      description: 'A valid `GeoJSON GeometryCollection` object type. Please refer to [RFC

        7946](https://tools.ietf.org/html/rfc7946#section-3.1.8) for details.'
      properties:
        geometries:
          type: array
          description: 'Contains a list of valid `GeoJSON` geometry objects. **Note** that coordinates

            in GeoJSON are in x, y order (longitude, latitude).'
          items:
            $ref: '#/components/schemas/GeoJsonGeometry'
      required:
      - geometries
      allOf:
      - $ref: '#/components/schemas/GeoJsonGeometry'
      x-ms-discriminator-value: GeometryCollection
    BoundaryProperties:
      type: object
      description: 'The `properties` payload of a `Boundary`. Carries the display name of the returned

        geographical area along with copyright attribution, both an API-wide notice and

        per-geometry data-provider credits.'
      properties:
        name:
          type: string
          description: The display name of the geographical area, for example, `"Bellevue"` for a city boundary.
        copyright:
          type: string
          description: 'The Azure Maps API copyright and usage notice that applies to this response. Distinct

            from the per-geometry data-provider attributions in `geometriesCopyright`.'
        copyrightUrl:
          type: string
          description: 'A URL to Azure Maps copyright and licensing information for the API and its underlying

            data sources.'
        geometriesCopyright:
          type: array
          description: 'Per-geometry data-provider attribution. Each entry corresponds positionally to the

            matching shape in the parent `Boundary.geometry.geometries` array — entry `i` describes

            the source of geometry `i`.'
          items:
            $ref: '#/components/schemas/GeometryCopyright'
    FeatureTypeEnum:
      type: string
      description: 'The `GeoJSON` object type for `Feature` objects. Tags each entry inside the `features`

        array of a `FeatureCollection` response (geocoding, reverse geocoding, autocomplete) and

        appears at the root of the `Get Polygon` response. The only value is `Feature`, as

        defined in [RFC 7946](https://www.rfc-editor.org/rfc/rfc7946).'
      enum:
      - Feature
      x-ms-enum:
        name: FeatureTypeEnum
        modelAsString: true
        values:
        - name: Feature
          value: Feature
          description: 'The `GeoJSON Feature` object type. Appears on every Feature inside a `FeatureCollection`

            response, and at the root of the `Get Polygon` response.'
    Azure.Core.Foundations.Error:
      type: object
      description: The error object.
      properties:
        code:
          type: string
          description: One of a server-defined set of error codes.
        message:
          type: string
          description: A human-readable representation of the error.
        target:
          type: string
          description: The target of the error.
        details:
          type: array
          description: An array of details about specific errors that led to this reported error.
          items:
            $ref: '#/components/schemas/Azure.Core.Foundations.Error'
        innererror:
          $ref: '#/components/schemas/Azure.Core.Foundations.InnerError'
          description: An object containing more specific information than the current object about the error.
      required:
      - code
      - message
    Azure.Core.Foundations.ErrorResponse:
      type: object
      description: A response containing error details.
      properties:
        error:
          $ref: '#/components/schemas/Azure.Core.Foundations.Error'
          description: The error object.
      required:
      - error
    GeometryCopyright:
      type: object
      description: 'A single per-geometry data-provider attribution entry within

        `BoundaryProperties.geometriesCopyright`. Identifies the source of one geometry in

        the parent `Boundary.geometry.geometries` array.'
      properties:
        sourceName:
          type: string
          description: An identifier for the data provider that supplied this geometry.
        copyright:
          type: string
          description: 'The human-readable attribution string for the data provider. For example, `"TomTom"`.

            May be a vendor name or a fuller copyright notice.'
    Boundary:
      type: object
      description: 'The successful response body returned by `Get Polygon`. Encoded as a

        [`GeoJSON Feature`](https://www.rfc-editor.org/rfc/rfc7946#section-3.2) whose `geometry` is

        a `GeometryCollection` of one or more `Polygon` or `MultiPolygon` shapes describing the

        outline of the requested geographical area, and whose `properties` carry the area''s

        display name and copyright attribution.'
      properties:
        type:
          $ref: '#/components/schemas/FeatureTypeEnum'
          description: 'The `GeoJSON` object type. Always `Feature`, as defined in

            [RFC 7946](https://www.rfc-editor.org/rfc/rfc7946).'
        geometry:
          $ref: '#/components/schemas/GeoJsonGeometryCollection'
          description: 'A `GeometryCollection` of one or more `Polygon` or `MultiPolygon` shapes whose coordinates

            define the outline of the requested area in WGS 84 longitude/latitude order, as defined

            by [RFC 7946](https://www.rfc-editor.org/rfc/rfc7946#section-3.1.8).'
        properties:
          $ref: '#/components/schemas/BoundaryProperties'
          description: 'Display name and copyright attribution for the returned area. See `BoundaryProperties`

            for the per-property shape.'
      required:
      - geometry
    GeoJsonObjectType:
      type: string
      description: 'Specifies the `GeoJSON` type. Must be one of the nine valid GeoJSON object

        types - Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon,

        GeometryCollection, Feature and FeatureCollection.'
      enum:
      - Point
      - MultiPoint
      - LineString
      - MultiLineString
      - Polygon
      - MultiPolygon
      - GeometryCollection
      - Feature
      - FeatureCollection
      x-ms-enum:
        name: GeoJsonObjectType
        modelAsString: false
        values:
        - name: GeoJsonPoint
          value: Point
          description: '`GeoJSON Point` geometry.'
        - name: GeoJsonMultiPoint
          value: MultiPoint
          description: '`GeoJSON MultiPoint` geometry.'
        - name: GeoJsonLineString
          value: LineString
          description: '`GeoJSON LineString` geometry.'
        - name: GeoJsonMultiLineString
          value: MultiLineString
          description: '`GeoJSON MultiLineString` geometry.'
        - name: GeoJsonPolygon
          value: Polygon
          description: '`GeoJSON Polygon` geometry.'
        - name: GeoJsonMultiPolygon
          value: MultiPolygon
          description: '`GeoJSON MultiPolygon` geometry.'
        - name: GeoJsonGeometryCollection
          value: GeometryCollection
          description: '`GeoJSON GeometryCollection` geometry.'
        - name: GeoJsonFeature
          value: Feature
          description: '`GeoJSON Feature` object.'
        - name: GeoJsonFeatureCollection
          value: FeatureCollection
          description: '`GeoJSON FeatureCollection` object.'
    Azure.Core.Foundations.InnerError:
      type: object
      description: An object containing more specific information about the error. As per Azure REST API guidelines - https://aka.ms/AzureRestApiGuidelines#handling-errors.
      properties:
        code:
          type: string
          description: One of a server-defined set of error codes.
        innererror:
          $ref: '#/components/schemas/Azure.Core.Foundations.InnerError'
          description: Inner error.
    GeoJsonGeometry:
      type: object
      description: 'A valid `GeoJSON` geometry object. The type must be one of the seven valid

        GeoJSON geometry types - Point, MultiPoint, LineString, MultiLineString,

        Polygon, MultiPolygon and GeometryCollection. Please refer to [RFC

        7946](https://tools.ietf.org/html/rfc7946#section-3.1) for details.'
      properties:
        type:
          $ref: '#/components/schemas/GeoJsonObjectType'
          description: 'Specifies the `GeoJSON` type. Must be one of the nine valid GeoJSON object

            types - Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon,

            GeometryCollection, Feature and FeatureCollection.'
        bbox:
          type: array
          description: Bounding box. Projection used - EPSG:3857. Please refer to [RFC 7946](https://datatracker.ietf.org/doc/html/rfc7946#section-5) for details.
          minItems: 4
          maxItems: 4
          items:
            type: number
            format: double
      discriminator:
        propertyName: type
      required:
      - type
  parameters:
    Azure.Core.Foundations.ApiVersionParameter:
      name: api-version
      in: query
      description: The API version to use for this operation.
      required: true
      x-ms-parameter-location: method
      x-ms-client-name: apiVersion
      schema:
        type: string
        minLength: 1
  securitySchemes:
    AadToken:
      type: oauth2
      flows:
        implicit:
          scopes:
            https://atlas.microsoft.com/.default: ''
          authorizationUrl: https://login.microsoftonline.com/common/oauth2/authorize
      description: 'These are the [Microsoft Entra OAuth 2.0](https://docs.microsoft.com/azure/active-directory/develop/v1-overview) Flows. When paired with [Azure role-based access](https://docs.microsoft.com/azure/role-based-access-control/overview) control it can be used to control access to Azure Maps REST APIs. Azure role-based access controls are used to designate access to one or more Azure Maps resource account or sub-resources. Any user, group, or service principal can be granted access via a  built-in role or a custom role composed of one or more permissions to Azure Maps REST APIs.


        To implement scenarios, we recommend viewing [authentication concepts](https://aka.ms/amauth). In summary, this security definition provides a solution for modeling application(s) via objects capable of access control on specific APIs and scopes.


        > [!NOTE]

        >

        > * This security definition **requires** the use of the `x-ms-client-id` header to indicate which Azure Maps resource the application is requesting access to. This can be acquired from the [Maps management API](https://aka.ms/amauthdetails).

        > * The `Authorization URL` is specific to the Azure public cloud instance. Sovereign clouds have unique Authorization URLs and Microsoft Entra ID configurations.

        > * The Azure role-based access control is configured from the [Azure management plane](https://aka.ms/amrbac) via Azure portal, PowerShell, CLI, Azure SDKs, or REST APIs.

        > * Usage of the [Azure Maps Web SDK](https://aka.ms/amaadmc) allows for configuration based setup of an application for multiple use cases.

        > * For more information on Microsoft identity platform, see [Microsoft identity platform overview](https://learn.microsoft.com/entra/identity-platform/v2-overview).'
    AzureKey:
      type: apiKey
      description: 'This is a shared key that is provisioned when you [Create an Azure Maps account](https://docs.microsoft.com/azure/azure-maps/quick-demo-map-app#create-an-azure-maps-account) in the Azure portal or using PowerShell, CLI, Azure SDKs, or REST API.


        With this key, any application can access all REST API. In other words, this key can be used as a master key in the account that they are issued in.


        For publicly exposed applications, our recommendation is to use the [confidential client applications](https://docs.microsoft.com/azure/azure-maps/authentication-best-practices#confidential-client-applications) approach to access Azure Maps REST APIs so your key can be securely stored.'
      name: subscription-key
      in: header
    SasToken:
      type: apiKey
      description: 'This is a shared access signature token is created from the List SAS operation on the [Azure Maps resource](https://aka.ms/amauth) through the Azure management plane via Azure portal, PowerShell, CLI, Azure SDKs, or REST APIs.


        With this token, any application is authorized to access with Azure role-based access controls and fine-grain control to the expiration, rate, and region(s) of use for the particular token. In other words, the SAS Token can be used to allow applications to control access in a more secured way than the shared key.


        For publicly exposed applications, our recommendation is to configure a specific list of allowed origins on the [Map account resource](https://aka.ms/amauth) to limit rendering abuse and regularly renew the SAS Token.'
      name: SAS Token
      in: header
x-ms-parameterized-host:
  hostTemplate: '{endpoint}'
  useSchemePrefix: false
  parameters:
  - name: endpoint
    in: path
    description: The Azure Maps service hostname. Use `https://atlas.microsoft.com` for the Azure public cloud. To target a specific Azure Maps geography or a sovereign cloud, see [Azure Maps geographic scope](https://learn.microsoft.com/azure/azure-maps/geographic-scope).
    required: true
    type: string
    format: uri
    default: https://atlas.microsoft.com
    x-ms-skip-url-encoding: true