Search - Get Reverse Geocoding

Use para obter um endereço e informações de localização a partir de coordenadas de longitude e latitude.
A API Get Reverse Geocoding é uma solicitação de GET HTTP usada para traduzir uma coordenada (exemplo: 37.786505, -122.3862) em um endereço de rua compreensível por humanos. Útil em aplicações de rastreamento onde você recebe um feed GPS do dispositivo ou ativo e deseja saber o endereço associado às coordenadas. Esse ponto de extremidade retornará informações de endereço para uma determinada coordenada.

GET {endpoint}/reverseGeocode?api-version=2026-01-01&coordinates={coordinates}

GET {endpoint}/reverseGeocode?api-version=2026-01-01&coordinates={coordinates}&resultTypes={resultTypes}&view={view}

Parâmetros do URI

Cabeçalho do Pedido

Respostas

Segurança

AadToken

Estes são os fluxos Microsoft Entra OAuth 2.0. Quando combinado com controlo Azure baseado em funções, pode ser usado para controlar o acesso a APIs REST Azure Maps. Os controlos de acesso baseados em papéis do Azure são usados para designar o acesso a uma ou mais contas ou subrecursos de recursos do Azure Maps. Qualquer usuário, grupo ou entidade de serviço pode receber acesso por meio de uma função interna ou uma função personalizada composta por uma ou mais permissões para APIs REST do Azure Maps.

Para implementar cenários, recomendamos a visualização conceitos de autenticação. Em resumo, essa definição de segurança fornece uma solução para modelar aplicativos(s) por meio de objetos capazes de controle de acesso em APIs e escopos específicos.

Tipo: oauth2
Fluxo: implicit
URL de Autorização: https://login.microsoftonline.com/common/oauth2/authorize

Âmbitos

subscription-key

Esta é uma chave compartilhada que é provisionada quando você Criar uma conta do Azure Maps no portal do Azure ou usando PowerShell, CLI, SDKs do Azure ou API REST.

Com essa chave, qualquer aplicativo pode acessar todas as APIs REST. Em outras palavras, essa chave pode ser usada como uma chave mestra na conta em que eles são emitidos.

Para aplicativos expostos publicamente, nossa recomendação é usar a abordagem de de aplicativos cliente confidenciais para acessar APIs REST do Azure Maps para que sua chave possa ser armazenada com segurança.

Tipo: apiKey
Em: header

SAS Token

Este é um token de assinatura de acesso compartilhado criado a partir da operação Listar SAS no de recursos do Azure Maps por meio do plano de gerenciamento do Azure por meio do portal do Azure, PowerShell, CLI, SDKs do Azure ou APIs REST.

Com esse token, qualquer aplicativo é autorizado a acessar com controles de acesso baseados em função do Azure e controle de grão fino para a expiração, taxa e região(ões) de uso para o token específico. Em outras palavras, o Token SAS pode ser usado para permitir que os aplicativos controlem o acesso de forma mais segura do que a chave compartilhada.

Para aplicativos expostos publicamente, nossa recomendação é configurar uma lista específica de origens permitidas no de recursos da conta do Map para limitar o abuso de renderização e renovar regularmente o Token SAS.

Tipo: apiKey
Em: header

Exemplos

Search point -122.138681, 47.630358

GET https://atlas.microsoft.com/reverseGeocode?api-version=2026-01-01&coordinates=-122.138681,47.630358

Content-Type: application/geo+json

{
  "type": "FeatureCollection",
  "features": [
    {
      "type": "Feature",
      "properties": {
        "address": {
          "countryRegion": {
            "name": "United States"
          },
          "adminDistricts": [
            {
              "name": "Washington",
              "shortName": "WA"
            },
            {
              "name": "King County",
              "shortName": "King Co."
            }
          ],
          "formattedAddress": "15127 NE 24th St, Redmond, Washington 98052",
          "streetName": "NE 24th St",
          "streetNumber": "15127",
          "locality": "Redmond",
          "postalCode": "98052",
          "addressLine": "15127 NE 24th St"
        },
        "type": "Address",
        "confidence": "Medium",
        "matchCodes": [
          "Good"
        ],
        "geocodePoints": [
          {
            "geometry": {
              "type": "Point",
              "coordinates": [
                -122.138681,
                47.630358
              ]
            },
            "calculationMethod": "Rooftop",
            "usageTypes": [
              "Display"
            ]
          },
          {
            "geometry": {
              "type": "Point",
              "coordinates": [
                -122.1386787,
                47.6302179
              ]
            },
            "calculationMethod": "Rooftop",
            "usageTypes": [
              "Route"
            ]
          }
        ]
      },
      "geometry": {
        "type": "Point",
        "coordinates": [
          -122.138681,
          47.630358
        ]
      },
      "bbox": [
        -122.14632282407,
        47.626495282429325,
        -122.13103917593001,
        47.63422071757068
      ]
    }
  ]
}

Definições

Address

O endereço de uma localização geocodificada ou sugerida por autocompletamento, analisada em campos estruturados. A escassez é normal: apenas os campos que a entidade resolvida fornece são povoados. Por exemplo, streetName e streetNumber aparece apenas para endereços ao nível da rua, e intersection aparece apenas para resultados de interseções rodoviárias.

AddressAdminDistrictsItem

Uma subdivisão administrativa que contém um endereço. Por exemplo, um estado, província ou condado. Devolvido como uma entrada no array principal Address.adminDistricts , onde as entradas são ordenadas do mais grosseiro para o mais fino.

AddressCountryRegion

O país ou região que contém o endereço, identificado pelo seu nome de exibição e pelo código de país ISO 3166-1 Alpha-2. Qualquer um dos campos pode ser omitido numa dada resposta.

Azure.Core.Foundations.Error

O objeto de erro.

Azure.Core.Foundations.ErrorResponse

Uma resposta contendo detalhes do erro.

Azure.Core.Foundations.InnerError

Um objeto que contém informações mais específicas sobre o erro. De acordo com Azure diretrizes da API REST - https://aka.ms/AzureRestApiGuidelines#handling-errors.

CalculationMethodEnum

O método que foi usado para calcular o ponto de geocódigo.

ConfidenceEnum

O nível de confiança de que o resultado da localização geocodificada é uma correspondência. Use este valor juntamente com os códigos de correspondência para obter informações mais completas sobre o jogo.

A confiança de uma localização geocodificada baseia-se em muitos fatores, incluindo a importância relativa da localização geocodificada e a localização do utilizador, se especificada.

FeatureCollectionEnum

O GeoJSON tipo de objeto utilizado na raiz das respostas bem-sucedidas das operações de geocodificação direta, geocodificação reversa e autocompletar (incluindo as suas variantes em lote). O único valor é FeatureCollection, conforme definido no RFC 7946. Get Polygon é a única exceção: a sua raiz de resposta é um GeoJSON Feature, veja FeatureTypeEnum.

FeaturesItem

Uma única entrada no features array de um GeocodingResponse, conforme a forma do GeoJSON Feature objeto. Representa uma localização geocodificada: dados estruturados em properties, uma coordenada representativa em geometry, e uma caixa delimitadora opcional em bbox.

FeaturesItemProperties

A properties carga útil de uma funcionalidade num GeocodingResponse. Transporta os indicadores de tipo de entidade e de qualidade de correspondência para a localização geocodificada, os seus componentes de endereço analisados e um ou mais pontos de geocódigo que associam a localização a coordenadas específicas.

FeatureTypeEnum

O GeoJSON tipo de objeto para Feature os objetos. Etiqueta cada entrada dentro do features array de uma FeatureCollection resposta (geocodificação, geocodificação reversa, autocompletamento) e aparece na raiz da Get Polygon resposta. O único valor é Feature, conforme definido no RFC 7946.

GeocodePointsItem

Um ponto de geocódigo para uma localização: uma coordenada mais metadados que descrevem como o ponto foi calculado (calculationMethod) e para que é mais adequado (usageTypes). Uma única funcionalidade normalmente retorna separadas Display e Route aponta para que os chamadores possam escolher a que se adequa à tarefa.

GeocodingResponse

O corpo de resposta bem-sucedida retornou por Get Geocoding e Get Reverse Geocoding, e a forma de sucesso por item por lote transportada dentro GeocodingBatchResponse.batchItemsde . Codificado como um GeoJSON FeatureCollection cujo features array contém um Feature por cada localização geocodificada.

GeoJsonObjectType

Especifica o tipo de GeoJSON. Deve ser um dos nove tipos de objeto GeoJSON válidos - Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon, GeometryCollection, Feature e FeatureCollection.

GeoJsonPoint

Um tipo de geometria GeoJSON Point válido. Consulte RFC 7946 para obter detalhes.

Intersection

Detalhes de interseção para um endereço resolvidos como um cruzamento rodoviário — a esquina onde duas ou mais ruas nomeadas se encontram. Preenchido apenas quando a entidade resolvida é um RoadIntersection; o pai Address.intersection é de outra forma omitido.

MatchCodesEnum

Um valor de código de correspondência que indica como o serviço de geocodificação produziu um determinado resultado de localização. O matchCodes campo numa característica é um array destes valores; combine-os com confidence e type para avaliar a qualidade da correspondência.

ReverseGeocodingResultTypeEnum

Um tipo de entidade devolvido pela Get Reverse Geocoding operação. Fornecido como um ou mais valores no resultTypes parâmetro de consulta para restringir a resposta a tipos específicos de localizações; quando o parâmetro é omitido, todos os tipos de entidade são elegíveis. Quando entidades de mais do que um tipo correspondem a uma coordenada, apenas a mais específica é retornada. Listados do mais específico ao menos específico: Address, Neighborhood, PopulatedPlacePostcode1, AdminDivision1, , AdminDivision2, , . CountryRegion

UsageTypeEnum

O uso pretendido para um ponto de geocódigo. Um ponto de geocódigo devolvido pelo serviço transporta um ou mais tipos de utilização que indicam como uma aplicação cliente deve consumir o ponto: por exemplo, mostrar a localização num mapa versus encaminhar um veículo para ele.