Search - Get Reverse Geocoding Batch

Referência

Service:: Maps

API Version:: 2023-06-01

Use para enviar um lote de consultas para a API de Geocodificação Reversa em uma única solicitação.

A Get Reverse Geocoding Batch API é uma solicitação HTTP POST que envia lotes de até 100 consultas para a API de Geocodificação Reversa usando uma única solicitação.

Enviar solicitação de lote síncrona

A API síncrona é recomendada para solicitações em lotes leves. Quando o serviço receber uma solicitação, ele responderá assim que os itens do lote forem calculados e não haverá possibilidade de recuperar os resultados posteriormente. A API síncrona retornará um erro de tempo limite (uma resposta 408) se a solicitação levar mais de 60 segundos. O número de itens de lote é limitado a 100 para essa API.

POST https://atlas.microsoft.com/reverseGeocode:batch?api-version=2023-06-01

Corpo POST para solicitação de lote

Para enviar as consultas de geocodificação reversa , você usará uma POST solicitação em que o corpo da solicitação conterá a batchItems matriz no json formato e o Content-Type cabeçalho será definido como application/json. Aqui está um corpo de solicitação de exemplo que contém duas consultas de geocodificação reversa :

{
  "batchItems": [
    {
      "coordinates": [-122.128275, 47.639429],
      "resultTypes": ["Address", "PopulatedPlace"]
    },
    {
      "coordinates": [-122.341979399674, 47.6095253501216]
    }
  ]
}

Um objeto batchItem de geocodificação reversa pode aceitar qualquer um dos parâmetros de URI de geocodificação reversa com suporte.

O lote deve conter pelo menos uma consulta.

Modelo de resposta em lote

A resposta em lote contém um summary componente que indica o totalRequests que fazia parte da solicitação de lote original e, por successfulRequests exemplo, consultas que foram executadas com êxito. A resposta em lote também inclui uma batchItems matriz que contém uma resposta para cada consulta na solicitação em lote. O batchItems conterá os resultados exatamente na mesma ordem em que as consultas originais foram enviadas na solicitação de lote. Cada item é de um dos seguintes tipos:

GeocodingResponse - Se a consulta for concluída com êxito.
Error - Se a consulta falhou. A resposta conterá um code e um message nesse caso.

POST https://atlas.microsoft.com/reverseGeocode:batch?api-version=2023-06-01

Parâmetros de URI

Nome	Em	Obrigatório	Tipo	Description
api-version	query	True	string	Número de versão da API de Mapas Azure.

Cabeçalho da solicitação

Nome	Obrigatório	Tipo	Description
x-ms-client-id		string	Especifica qual conta destina-se ao uso em conjunto com o modelo de segurança Azure AD. Ele representa uma ID exclusiva para a conta Azure Mapas e pode ser recuperado da API de Conta do plano de gerenciamento do Azure Mapas. Para usar Azure AD segurança no Azure Mapas consulte os artigos a seguir para obter diretrizes.
Accept-Language		string	Idioma no qual os resultados da pesquisa devem ser retornados. Consulte Idiomas com suporte para obter detalhes.

Nome

Obrigatório

Tipo

Description

x-ms-client-id

string

Especifica qual conta destina-se ao uso em conjunto com o modelo de segurança Azure AD. Ele representa uma ID exclusiva para a conta Azure Mapas e pode ser recuperado da API de Conta do plano de gerenciamento do Azure Mapas. Para usar Azure AD segurança no Azure Mapas consulte os artigos a seguir para obter diretrizes.

Accept-Language

string

Idioma no qual os resultados da pesquisa devem ser retornados.

Consulte Idiomas com suporte para obter detalhes.

Corpo da solicitação

Nome	Tipo	Description
batchItems	ReverseGeocodingBatchRequestItem[]	A lista de consultas a serem processadas.

Respostas

Nome	Tipo	Description
200 OK	GeocodingBatchResponse	OK
Other Status Codes	ErrorResponse	Erro inesperado.

Segurança

AADToken

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

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

Observação

Essa definição de segurança requer o uso do x-ms-client-id cabeçalho para indicar a qual Azure Mapas recurso o aplicativo está solicitando acesso. Isso pode ser adquirido da API de gerenciamento de Mapas.
O Authorization URL é específico para a instância de nuvem pública do Azure. As nuvens soberanas têm URLs de autorização exclusivas e configurações de Microsoft Entra ID.
O controle de acesso baseado em função do Azure é configurado no plano de gerenciamento do Azure por meio de portal do Azure, PowerShell, CLI, SDKs do Azure ou APIs REST.
O uso do SDK da Web Azure Mapas permite a configuração baseada em configuração de um aplicativo para vários casos de uso.
Para obter mais informações sobre plataforma de identidade da Microsoft, consulte visão geral plataforma de identidade da Microsoft.

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Nome	Description
https://atlas.microsoft.com/.default	https://atlas.microsoft.com/.default

subscription-key

Essa é uma chave compartilhada provisionada ao criar um recurso Azure Mapas por meio do plano de gerenciamento do Azure por meio de portal do Azure, PowerShell, CLI, SDKs do Azure ou APIs REST.

Com essa chave, qualquer aplicativo está autorizado a acessar todas as APIs REST. Em outras palavras, elas podem atualmente ser tratadas como master chaves para a conta para a qual são emitidas.

Para aplicativos expostos publicamente, nossa recomendação é usar o acesso de servidor a servidor de Azure Mapas APIs REST em que essa chave pode ser armazenada com segurança.

Type: apiKey
In: header

SAS Token

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

Com esse token, qualquer aplicativo está autorizado a acessar com controles de acesso baseados em função do Azure e controle refinado à expiração, taxa e regiõ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 maneira mais segura do que a chave compartilhada.

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

Type: apiKey
In: header

Exemplos

A Reverse Geocoding Batch API call containing 2 Reverse Geocoding queries

Sample Request

HTTP

POST https://atlas.microsoft.com/reverseGeocode:batch?api-version=2023-06-01

{
  "batchItems": [
    {
      "coordinates": [
        -122.128275,
        47.639429
      ],
      "resultTypes": [
        "Address",
        "PopulatedPlace"
      ],
      "optionalId": "4C3681A6C8AA4AC3441412763A2A25C81444DC8B"
    },
    {
      "coordinates": [
        -122.341979399674,
        47.6095253501216
      ],
      "optionalId": "6M9W39P12SNHGAIZ4JQ7F57NWJLV2BRYEQRD7OH7"
    }
  ]
}

Sample Response

Status code:: 200

{
  "summary": {
    "successfulRequests": 1,
    "totalRequests": 2
  },
  "batchItems": [
    {
      "type": "FeatureCollection",
      "features": [
        {
          "type": "Feature",
          "properties": {
            "type": "Address",
            "confidence": "High",
            "matchCodes": [
              "Good"
            ],
            "address": {
              "locality": "Redmond",
              "adminDistricts": [
                {
                  "shortName": "WA"
                },
                {
                  "shortName": "King"
                }
              ],
              "countryRegion": {
                "ISO": "US",
                "name": "United States"
              },
              "postalCode": "98052",
              "formattedAddress": "1 Microsoft Way, Redmond, WA 98052",
              "addressLine": "1 Microsoft Way"
            },
            "geocodePoints": [
              {
                "geometry": {
                  "type": "Point",
                  "coordinates": [
                    -122.128275,
                    47.639429
                  ]
                },
                "calculationMethod": "Rooftop",
                "usageTypes": [
                  "Display",
                  "Route"
                ]
              },
              {
                "geometry": {
                  "type": "Point",
                  "coordinates": [
                    -122.127028,
                    47.638545
                  ]
                },
                "calculationMethod": "Rooftop",
                "usageTypes": [
                  "Route"
                ]
              }
            ]
          },
          "geometry": {
            "type": "Point",
            "coordinates": [
              -122.128275,
              47.639429
            ]
          },
          "bbox": [
            -122.1359181505759,
            47.63556628242932,
            -122.1206318494241,
            47.643291717570676
          ]
        }
      ]
    },
    {
      "optionalId": "3K5O3Y832J2YV6D7XNGUSM4ECCUGDEFN172CJQNN",
      "error": {
        "code": "400 Bad Request",
        "message": "The provided coordinates in query are invalid, out of range, or not in the expected format"
      }
    }
  ]
}

Definições

Nome	Description
Address	O endereço do resultado
AdminDistricts	O nome da subdivisão no país ou região de um endereço. Esse elemento normalmente é tratado como a subdivisão administrativa de primeira ordem, mas em alguns casos também contém a segunda, terceira ou quarta subdivisão de 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 para obter informações mais completas sobre a correspondência. A confiança de uma localização geocódigo baseia-se em muitos fatores, incluindo a importância relativa da localização geocódigo e da localização do usuário, se especificado.
CountryRegion
ErrorAdditionalInfo	As informações adicionais do erro de gerenciamento de recursos.
ErrorDetail	O detalhe do erro.
ErrorResponse	Resposta de erro
FeatureCollectionEnum	O tipo de um objeto FeatureCollection deve ser FeatureCollection.
FeaturesItem
FeatureTypeEnum	O tipo de um recurso deve ser Recurso.
GeocodePoints	Uma coleção de pontos de geocódigo que diferem em como eles foram calculados e seu uso sugerido.
GeocodingBatchResponse	Esse objeto é retornado de uma chamada de serviço do Lote de Geocodificação bem-sucedida.
GeocodingBatchResponseItem
GeoJsonPoint	Um tipo de geometria válido `GeoJSON Point` . 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 e `Ambiguous` significa que mais de `Good` um local de código geográfico foi encontrado para as informações de localização e que o serviço de geocódigo não tinha pesquisa na hierarquia 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 uma localização de código geográfico que correspondesse a todas as informações de localização fornecidas, portanto, o serviço de geocódigo teve que pesquisar a hierarquia superior e encontrou várias correspondências nesse nível. Um exemplo de `Ambiguous` um resultado e é `UpHierarchy` quando você fornece informações de endereço completas, mas o serviço de geocódigo não pode localizar uma correspondência para o endereço de rua 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 correspondência ou todas as correspondências retornadas são consideradas correspondências fortes. Por exemplo, uma consulta para Nova York retorna várias correspondências boas. `Ambiguous`: o local é um de um conjunto de possíveis correspondências. Por exemplo, quando você consulta o endereço da rua 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`: o local representa uma movimentação 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 uma correspondência para o endereço solicitado não puder ser encontrada, um código de correspondência de `UpHierarchy` com um tipo de entidade RoadBlock poderá ser retornado.
Properties
ResultTypeEnum	Especifique os tipos de entidade desejados 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 local será retornada na resposta. O valor padrão é todas as entidades possíveis. Uma lista separada por vírgulas de tipos de entidade selecionada nas opções a seguir. Endereço Vizinhança PopulatedPlace Postcode1 AdminDivision1 AdminDivision2 CountryRegion Esses tipos de entidade 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, apenas a entidade mais específica é retornada. Por exemplo, se você especificar Address e AdminDistrict1 como tipos de entidade e entidades foram encontrados para ambos os tipos, somente as informações da entidade Address serão retornadas na resposta.
ReverseGeocodingBatchRequestBody	A lista de consultas/solicitações de geocodificação reversa a serem processadas. A lista pode conter no máximo 100 consultas e deve conter pelo menos 1 consulta.
ReverseGeocodingBatchRequestItem	Objeto Batch Query
Summary	Resumo da solicitação em lote
UsageTypeEnum	O melhor uso para o ponto de código geográfico. Cada ponto de código geográfico é definido como um `Route` ponto, um `Display` ponto ou ambos. Use `Route` pontos se você estiver criando uma rota para o local. Use `Display` pontos se você estiver mostrando o local em um mapa. Por exemplo, se o local for um parque, um `Route` ponto poderá especificar uma entrada para o parque onde você pode entrar com um carro e um `Display` ponto pode ser um ponto que especifica o centro do parque.

Address

O endereço do resultado

Nome	Tipo	Description
addressLine	string	AddressLine que inclui Nome e Número da Rua
adminDistricts	AdminDistricts[]	O nome da subdivisão no país ou região de um endereço. Esse elemento normalmente é tratado como a subdivisão administrativa de primeira ordem, mas em alguns casos também contém a segunda, terceira ou quarta subdivisão de ordem em um país, dependência ou região.
countryRegion	CountryRegion
formattedAddress	string	Propriedade Address formatada
intersection	Intersection	O endereço do resultado.
locality	string	propriedade locality
neighborhood	string	propriedade neighborhood
postalCode	string	Propriedade Cep

AdminDistricts

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

Nome	Tipo	Description
name	string	O nome do campo adminDistrict correspondente, Para adminDistrict[0], esse pode ser o nome completo do estado, como Washington, Para adminDistrict[1], esse pode ser o nome completo do município
shortName	string	O nome curto do campo adminDistrict correspondente, Para adminDistrict[0], esse pode ser um nome curto de estado, como WA, Para adminDistrict[1], esse pode ser o nome curto do município

CalculationMethodEnum

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

Nome	Tipo	Description
Interpolation	string	O ponto de código geográfico foi correspondido a um ponto em uma estrada usando interpolação.
InterpolationOffset	string	O ponto de geocódigo foi correspondido a um ponto em uma estrada usando interpolação com um deslocamento adicional para deslocar o ponto para o lado da rua.
Parcel	string	O ponto de código geográfico foi correspondido ao centro de uma parcela.
Rooftop	string	O ponto de geocódigo foi correspondido ao telhado de um prédio.

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 para obter informações mais completas sobre a correspondência.

A confiança de uma localização geocódigo baseia-se em muitos fatores, incluindo a importância relativa da localização geocódigo e da localização do usuário, se especificado.

Nome Tipo Description

High

Nome	Tipo	Description
High	string	Se a confiança estiver definida como `High`, uma ou mais correspondências fortes foram encontradas. Várias `High` correspondências de confiança são classificadas em ordem classificada por importância quando aplicável. Por exemplo, os pontos de referência têm importância, mas os endereços não. Se uma solicitação incluir um local ou uma exibição, a classificação poderá ser alterada adequadamente. Por exemplo, uma consulta de localização para "Paris" retorna "Paris, França" e "Paris, TX" ambos com `High` confiança. "Paris, França" é sempre classificada em primeiro lugar devido à importância, a menos que um local de usuário indique que o usuário está em Paris, TX ou a exibição de mapa indica que o usuário está pesquisando nessa área.
Low	string
Medium	string	Em algumas situações, a correspondência retornada pode não estar no mesmo nível que as informações fornecidas na solicitação. Por exemplo, uma solicitação pode especificar informações de endereço e o serviço de geocódigo só pode corresponder a um código postal. Nesse caso, se o serviço de geocódigo tiver uma confiança de que o cep corresponde aos dados, a confiança será definida `Medium` como e o código de correspondência será definido como `UpHierarchy` para especificar que ele não pôde corresponder a todas as informações e teve que pesquisar na hierarquia. Se as informações de localização na consulta forem ambíguas e não houver informações adicionais para classificar os locais (como o local do usuário ou a importância relativa do local), a confiança será definida `Medium`como . Por exemplo, uma consulta de localização para "148th Ave, Bellevue" pode retornar "148th Ave SE" e "148th Ave NE" ambos com `Medium` confiança. Se as informações de localização na consulta não fornecerem informações suficientes para geocodificar um local específico, um valor de localização menos preciso poderá ser retornado e a confiança será definida `Medium`como . Por exemplo, se um endereço for fornecido, mas uma correspondência não for encontrada para o número da casa, o resultado do código geográfico com um tipo de entidade de bloqueio poderá ser retornado.

string

Se a confiança estiver definida como High, uma ou mais correspondências fortes foram encontradas. Várias High correspondências de confiança são classificadas em ordem classificada por importância quando aplicável. Por exemplo, os pontos de referência têm importância, mas os endereços não.

Se uma solicitação incluir um local ou uma exibição, a classificação poderá ser alterada adequadamente. Por exemplo, uma consulta de localização para "Paris" retorna "Paris, França" e "Paris, TX" ambos com High confiança. "Paris, França" é sempre classificada em primeiro lugar devido à importância, a menos que um local de usuário indique que o usuário está em Paris, TX ou a exibição de mapa indica que o usuário está pesquisando nessa área.

Low

string

Medium

string

Em algumas situações, a correspondência retornada pode não estar no mesmo nível que as informações fornecidas na solicitação. Por exemplo, uma solicitação pode especificar informações de endereço e o serviço de geocódigo só pode corresponder a um código postal. Nesse caso, se o serviço de geocódigo tiver uma confiança de que o cep corresponde aos dados, a confiança será definida Medium como e o código de correspondência será definido como UpHierarchy para especificar que ele não pôde corresponder a todas as informações e teve que pesquisar na hierarquia.

Se as informações de localização na consulta forem ambíguas e não houver informações adicionais para classificar os locais (como o local do usuário ou a importância relativa do local), a confiança será definida Mediumcomo . Por exemplo, uma consulta de localização para "148th Ave, Bellevue" pode retornar "148th Ave SE" e "148th Ave NE" ambos com Medium confiança.

Se as informações de localização na consulta não fornecerem informações suficientes para geocodificar um local específico, um valor de localização menos preciso poderá ser retornado e a confiança será definida Mediumcomo . Por exemplo, se um endereço for fornecido, mas uma correspondência não for encontrada para o número da casa, o resultado do código geográfico com um tipo de entidade de bloqueio poderá ser retornado.

CountryRegion

Nome	Tipo	Description
ISO	string	ISO do país/região
name	string	nome do país/região

ErrorAdditionalInfo

As informações adicionais do erro de gerenciamento de recursos.

Nome	Tipo	Description
info	object	As informações adicionais.
type	string	O tipo de informação adicional.

ErrorDetail

O detalhe do erro.

Nome	Tipo	Description
additionalInfo	ErrorAdditionalInfo[]	As informações adicionais do erro.
code	string	O código de erro.
details	ErrorDetail[]	Os detalhes do erro.
message	string	A mensagem de erro.
target	string	O destino do erro.

ErrorResponse

Resposta de erro

Nome	Tipo	Description
error	ErrorDetail	O objeto de erro.

FeatureCollectionEnum

O tipo de um objeto FeatureCollection deve ser FeatureCollection.

Nome	Tipo	Description
FeatureCollection	string

FeaturesItem

Nome	Tipo	Description
bbox	number[]	Caixa delimitadora. Projeção usada – EPSG:3857. Consulte RFC 7946 para obter detalhes.
geometry	GeoJsonPoint	Um tipo de geometria válido `GeoJSON Point` . Consulte RFC 7946 para obter detalhes.
id	string	ID do recurso retornado
properties	Properties
type	FeatureTypeEnum	O tipo de um recurso deve ser Recurso.

FeatureTypeEnum

O tipo de um recurso deve ser Recurso.

Nome	Tipo	Description
Feature	string

GeocodePoints

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

Nome	Tipo	Description
calculationMethod	CalculationMethodEnum	O método que foi usado para calcular o ponto de geocódigo.
geometry	GeoJsonPoint	Um tipo de geometria válido `GeoJSON Point` . Consulte RFC 7946 para obter detalhes.
usageTypes	UsageTypeEnum[]	O melhor uso para o ponto de código geográfico. Cada ponto de código geográfico é definido como um `Route` ponto, um `Display` ponto ou ambos. Use `Route` pontos se você estiver criando uma rota para o local. Use `Display` pontos se você estiver mostrando o local em um mapa. Por exemplo, se o local for um parque, um `Route` ponto poderá especificar uma entrada para o parque onde você pode entrar com um carro e um `Display` ponto pode ser um ponto que especifica o centro do parque.

GeocodingBatchResponse

Esse objeto é retornado de uma chamada de serviço do Lote de Geocodificação bem-sucedida.

Nome	Tipo	Description
batchItems	GeocodingBatchResponseItem[]	Matriz que contém os resultados do lote.
nextLink	string	O é o link para a próxima página dos recursos retornados. Se for a última página, não este campo.
summary	Summary	Resumo da solicitação em lote

GeocodingBatchResponseItem

Nome	Tipo	Description
error	ErrorDetail	O detalhe do erro.
features	FeaturesItem[]
nextLink	string	O é o link para a próxima página dos recursos retornados. Se for a última página, não este campo.
optionalId	string	id do batchItem que seria o mesmo que a ID na solicitação
type	FeatureCollectionEnum	O tipo de um objeto FeatureCollection deve ser FeatureCollection.

GeoJsonPoint

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

Nome	Tipo	Description
bbox	number[]	Caixa delimitadora. Projeção usada – EPSG:3857. Consulte RFC 7946 para obter detalhes.
coordinates	number[]	Um `Position` é uma matriz de números com dois ou mais elementos. Os dois primeiros elementos são longitude e latitude, precisamente nessa ordem. Altitude/Elevação é um terceiro elemento opcional. Consulte RFC 7946 para obter detalhes.
type	string: Point	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.

Intersection

O endereço do resultado.

Nome	Tipo	Description
baseStreet	string	Rua primária para a localização.
displayName	string	Nome completo da interseção.
intersectionType	string	Tipo de interseção.
secondaryStreet1	string	A primeira rua intersecciona.
secondaryStreet2	string	Se houver, a segunda rua intersecciona.

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 e Ambiguous significa que mais de Good um local de código geográfico foi encontrado para as informações de localização e que o serviço de geocódigo não tinha pesquisa na hierarquia 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 uma localização de código geográfico que correspondesse a todas as informações de localização fornecidas, portanto, o serviço de geocódigo teve que pesquisar a hierarquia superior e encontrou várias correspondências nesse nível. Um exemplo de Ambiguous um resultado e é UpHierarchy quando você fornece informações de endereço completas, mas o serviço de geocódigo não pode localizar uma correspondência para o endereço de rua 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 correspondência ou todas as correspondências retornadas são consideradas correspondências fortes. Por exemplo, uma consulta para Nova York retorna várias correspondências boas.

Ambiguous: o local é um de um conjunto de possíveis correspondências. Por exemplo, quando você consulta o endereço da rua 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: o local representa uma movimentação 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 uma correspondência para o endereço solicitado não puder ser encontrada, um código de correspondência de UpHierarchy com um tipo de entidade RoadBlock poderá ser retornado.

Nome	Tipo	Description
Ambiguous	string
Good	string
UpHierarchy	string

Properties

Nome	Tipo	Description
address	Address	O endereço do resultado
confidence	ConfidenceEnum	O nível de confiança de que o resultado da localização geocódigo é uma correspondência. Use esse valor com o código de correspondência para determinar para obter informações mais completas sobre a correspondência. A confiança de um local geocódigo baseia-se em muitos fatores, incluindo a importância relativa da localização geocódigo e a localização do usuário, se especificado.
geocodePoints	GeocodePoints[]	Uma coleção de pontos de geocódigo que diferem em como eles foram calculados e seu uso sugerido.
matchCodes	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 geocódigo com códigos de correspondência de e `Ambiguous` significa que mais de `Good` um local de código geográfico foi encontrado para as informações de localização e que o serviço de geocódigo não tinha a hierarquia de pesquisa para encontrar uma correspondência. Da mesma forma, um local geocódigo com códigos de correspondência de `Ambiguous` e `UpHierarchy` implica que não foi possível encontrar uma localização de código geográfico que correspondesse a todas as informações de localização fornecidas, portanto, o serviço de geocódigo teve que pesquisar a hierarquia e encontrou várias correspondências nesse nível. Um exemplo de `Ambiguous` um resultado e `UpHierarchy` é quando você fornece informações de endereço completas, mas o serviço de geocódigo não pode localizar uma correspondência para o endereço de rua 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 correspondência ou todas as correspondências retornadas são consideradas correspondências fortes. Por exemplo, uma consulta para Nova York retorna várias correspondências boas. `Ambiguous`: o local é um de um conjunto de possíveis correspondências. Por exemplo, quando você consulta o endereço da rua 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`: o local representa um movimento para cima da hierarquia geográfica. Isso ocorre quando uma correspondência para a solicitação de localização não foi encontrada, portanto, um resultado menos preciso é retornado. Por exemplo, se uma correspondência para o endereço solicitado não puder ser encontrada, um código de correspondência de com um tipo de `UpHierarchy` entidade RoadBlock poderá ser retornado.
type	string	Um destes: Endereço Bloqueio RoadIntersection Vizinhança PopulatedPlace Postcode1 AdminDivision1 AdminDivision2 CountryRegion

ResultTypeEnum

Especifique os tipos de entidade desejados 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 local será retornada na resposta. O valor padrão é todas as entidades possíveis. Uma lista separada por vírgulas de tipos de entidade selecionada nas opções a seguir.

Endereço
Vizinhança
PopulatedPlace
Postcode1
AdminDivision1
AdminDivision2
CountryRegion

Esses tipos de entidade 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, apenas a entidade mais específica é retornada. Por exemplo, se você especificar Address e AdminDistrict1 como tipos de entidade e entidades foram encontrados para ambos os tipos, somente as informações da entidade Address serão retornadas na resposta.

Nome	Tipo	Description
Address	string
AdminDivision1	string
AdminDivision2	string
CountryRegion	string
Neighborhood	string
PopulatedPlace	string
Postcode1	string

ReverseGeocodingBatchRequestBody

A lista de consultas/solicitações de geocodificação reversa a serem processadas. A lista pode conter no máximo 100 consultas e deve conter pelo menos 1 consulta.

Nome	Tipo	Description
batchItems	ReverseGeocodingBatchRequestItem[]	A lista de consultas a serem processadas.

ReverseGeocodingBatchRequestItem

Objeto Batch Query

Nome	Tipo	Description
coordinates	number[]	As coordenadas do local que você deseja reverter geocódigo. Exemplo: [lon,lat]
optionalId	string	id da solicitação que seria mostrada em batchItem correspondente
resultTypes	ResultTypeEnum[]	Especifique os tipos de entidade desejados 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 local será retornada na resposta. O valor padrão é todas as entidades possíveis. Uma lista separada por vírgulas de tipos de entidade selecionada nas opções a seguir. Endereço Vizinhança PopulatedPlace Postcode1 AdminDivision1 AdminDivision2 CountryRegion Esses tipos de entidade 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, apenas a entidade mais específica é retornada. Por exemplo, se você especificar Address e AdminDistrict1 como tipos de entidade e entidades foram encontrados para ambos os tipos, somente as informações da entidade Address serão retornadas na resposta.
view	string	Uma cadeia de caracteres que especifica um código de região/país ISO 3166-1 Alpha-2. Isso alterará as bordas e rótulos geopolíticos disputados para se alinharem à região de usuário especificada.

Summary

Resumo da solicitação em lote

Nome	Tipo	Description
successfulRequests	integer	Número de solicitações bem-sucedidas no lote
totalRequests	integer	Número total de solicitações no lote

UsageTypeEnum

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

Nome	Tipo	Description
Display	string
Route	string

Share via

Search - Get Reverse Geocoding Batch

Enviar solicitação de lote síncrona

Corpo POST para solicitação de lote

Modelo de resposta em lote

Parâmetros de URI

Cabeçalho da solicitação

Corpo da solicitação

Respostas

Segurança

AADToken

Scopes

subscription-key

SAS Token

Exemplos

A Reverse Geocoding Batch API call containing 2 Reverse Geocoding queries

Sample Request

Sample Response

Definições

Address

AdminDistricts

CalculationMethodEnum

ConfidenceEnum

CountryRegion

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

FeatureCollectionEnum

FeaturesItem

FeatureTypeEnum

GeocodePoints

GeocodingBatchResponse

GeocodingBatchResponseItem

GeoJsonPoint

Intersection

MatchCodesEnum

Properties

ResultTypeEnum

ReverseGeocodingBatchRequestBody

ReverseGeocodingBatchRequestItem

Summary

UsageTypeEnum

Recursos adicionais