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 https://atlas.microsoft.com/reverseGeocode?api-version=2025-01-01&coordinates={coordinates}

GET https://atlas.microsoft.com/reverseGeocode?api-version=2025-01-01&coordinates={coordinates}&resultTypes={resultTypes}&view={view}

Parâmetros do URI

Cabeçalho do Pedido

Respostas

Segurança

AADToken

Estes são os Microsoft Entra OAuth 2.0 Flows. Quando emparelhado com controle de de acesso baseado em função do Azure, ele pode ser usado para controlar o acesso às APIs REST do Azure Maps. Os controles de acesso baseados em função do Azure são usados para designar o acesso a uma ou mais contas de recursos ou subrecursos 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

Essa é uma chave compartilhada que é provisionada ao criar um 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 essa chave, qualquer aplicativo está autorizado a acessar todas as APIs REST. Por outras palavras, estas podem atualmente ser tratadas como chaves mestras para a conta para a qual foram emitidas.

Para aplicativos expostos publicamente, nossa recomendação é usar o acesso de servidor para servidor das APIs REST do Azure Maps onde essa chave pode 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=2025-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 do resultado

AdminDistricts

O nome da subdivisão no país ou região de um endereço. Este elemento é normalmente tratado como a subdivisão administrativa de primeira ordem, mas em alguns casos também contém a subdivisão de segunda, terceira ou quarta ordem em um país, dependência ou região.

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 esse valor com o código de correspondência para determinar informações mais completas sobre a correspondência.

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.

CountryRegion

ErrorAdditionalInfo

O erro de gerenciamento de recursos informações adicionais.

ErrorDetail

O detalhe do erro.

ErrorResponse

Resposta de erro

FeatureCollectionEnum

O tipo de um objeto FeatureCollection deve ser FeatureCollection.

FeaturesItem

FeatureTypeEnum

O tipo de recurso deve ser Recurso.

GeocodePoints

Uma coleção de pontos de geocódigo que diferem em como eles foram calculados e seu uso sugerido.

GeocodingResponse

Este objeto é retornado de uma chamada de Geocoding bem-sucedida

GeoJsonPoint

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

Intersection

O endereço do resultado.

MatchCodesEnum

Um ou mais valores de código de correspondência que representam o nível de geocodificação para cada local na resposta.

Por exemplo, um local geocodificado com códigos de correspondência de Good e Ambiguous significa que mais de um local de geocódigo foi encontrado para as informações de localização e que o serviço de geocódigo não tinha hierarquia de pesquisa para encontrar uma correspondência.

Da mesma forma, um local geocodificado com códigos de correspondência de Ambiguous e UpHierarchy implica que não foi possível encontrar um local de geocódigo que correspondesse a todas as informações de localização fornecidas, de modo que o serviço de geocódigo teve que pesquisar hierarquia superior e encontrar várias correspondências nesse nível. Um exemplo de Ambiguous e UpHierarchy resultado é quando você fornece informações completas de endereço, mas o serviço de geocodificação não consegue localizar uma correspondência para o endereço e, em vez disso, retorna informações para mais de um valor RoadBlock.

Os valores possíveis são:

Good: O local tem apenas uma partida ou todas as partidas retornadas são consideradas partidas fortes. Por exemplo, uma consulta para Nova York retorna várias correspondências Boas.

Ambiguous: A localização faz parte de um conjunto de possíveis correspondências. Por exemplo, quando você consulta o endereço 128 Main St., a resposta pode retornar dois locais para 128 North Main St. e 128 South Main St. porque não há informações suficientes para determinar qual opção escolher.

UpHierarchy: A localização representa um movimento para cima na hierarquia geográfica. Isso ocorre quando uma correspondência para a solicitação de local não foi encontrada, portanto, um resultado menos preciso é retornado. Por exemplo, se não for possível encontrar uma correspondência para o endereço solicitado, poderá ser devolvido um código de correspondência de UpHierarchy com um tipo de entidade RoadBlock.

Properties

ReverseGeocodingResultTypeEnum

Especifique os tipos de entidade que você deseja na resposta. Somente os tipos especificados serão retornados. Se o ponto não puder ser mapeado para os tipos de entidade especificados, nenhuma informação de localização será retornada na resposta. O valor padrão é todas as entidades possíveis. Uma lista separada por vírgulas dos tipos de entidade selecionados entre as opções a seguir.

• Endereço
• Bairro
• PopulatedPlace
• Código postal1
• AdminDivision1
• AdminDivision2
• País/Região

Estes tipos de entidades são ordenados da entidade mais específica para a entidade menos específica. Quando entidades de mais de um tipo de entidade são encontradas, somente a entidade mais específica é retornada. Por exemplo, se você especificar Address e AdminDistrict1 como tipos de entidade e entidades foram encontradas para ambos os tipos, somente as informações da entidade Address serão retornadas na resposta.

UsageTypeEnum

O melhor uso para o ponto de geocódigo. Cada ponto de geocódigo é definido como um ponto de Route, um ponto de Display ou ambos. Use Route pontos se estiver criando uma rota para o local. Use Display pontos se estiver mostrando a localização em um mapa. Por exemplo, se o local for um parque, um ponto de Route pode especificar uma entrada para o parque onde você pode entrar com um carro, e um ponto de Display pode ser um ponto que especifica o centro do parque.