Geocoder

Classe Geocoding

Classe google.maps.Geocoder

Um serviço para conversão entre um endereço e um LatLng.

Acesse const {Geocoder} = await google.maps.importLibrary("geocoding") chamando. Consulte Bibliotecas na API Maps JavaScript.

Geocoder
Geocoder()
Parâmetros:nenhum
Cria uma nova instância de um Geocoder que envia solicitações de geocódigo para servidores do Google.
geocode
geocode(request[, callback])
Parâmetros:
Valor de retorno:  Promise<GeocoderResponse>
Geocodifica uma solicitação.

Interface GeocodingRequest

Interface google.maps.GeocoderRequest

A especificação para uma solicitação de geocodificação a ser enviada para o Geocoder.

address optional
Tipo:string optional
Endereço para geocodificação. É necessário fornecer apenas um dos address, location e placeId.
bounds optional
LatLngBounds em que pesquisar. Opcional.
componentRestrictions optional
Os componentes são usados para restringir os resultados a uma área específica. Um filtro consiste em um ou mais dos seguintes itens: route, locality, administrativeArea, postalCode e country. Somente resultados que correspondem a todos os filtros serão retornados. Os valores de filtro são compatíveis com os mesmos métodos de correção ortográfica e correspondência parcial de outras solicitações de geocodificação. Opcional.
language optional
Tipo:string optional
Um identificador de idioma para o idioma em que os resultados devem ser retornados, quando possível. Consulte a lista de idiomas compatíveis.
location optional
Tipo:LatLng|LatLngLiteral optional
LatLng (ou LatLngLiteral) para pesquisar. O geocodificador executa uma geocodificação inversa. Consulte Geocodificação inversa para mais informações. É necessário fornecer apenas um dos address, location e placeId.
placeId optional
Tipo:string optional
O ID do lugar associado ao local. IDs de lugares identificam um local de modo exclusivo no banco de dados do Google Places e no Google Maps. Saiba mais sobre IDs de local no guia do desenvolvedor da API Places. O geocodificador executa uma geocodificação inversa. Consulte Geocodificação inversa para mais informações. É necessário fornecer apenas um dos address, location e placeId.
region optional
Tipo:string optional
Código do país usado para polarizar a pesquisa, especificado como uma subtag de região Unicode de dois caracteres / identificador CLDR. Opcional. Consulte os detalhes da cobertura da Plataforma Google Maps para ver as regiões compatíveis.

Interface GeocodingComponentRestrictions

Interface google.maps.GeocoderComponentRestrictions

GeocoderComponentRestrictions representa um conjunto de filtros que são resolvidos para uma área específica. Para detalhes sobre como isso funciona, consulte Filtragem de componentes de geocodificação.

administrativeArea optional
Tipo:string optional
Corresponde a todas as administrative_area levels. Opcional.
country optional
Tipo:string optional
Corresponde ao nome de um país ou a um código de país ISO 3166-1 de duas letras. Opcional.
locality optional
Tipo:string optional
Corresponde aos tipos locality e sublocality. Opcional.
postalCode optional
Tipo:string optional
Corresponde a postal_code e postal_code_prefix. Opcional.
route optional
Tipo:string optional
Corresponde ao nome longo ou curto de uma route. Opcional.

Constantes GeocodingStatus

google.maps.GeocoderStatus constantes

O status retornado pelo Geocoder na conclusão de uma chamada para geocode(). Especifique-as por valor ou usando o nome da constante. Por exemplo, 'OK' ou google.maps.GeocoderStatus.OK.

Acesse const {GeocoderStatus} = await google.maps.importLibrary("geocoding") chamando. Consulte Bibliotecas na API Maps JavaScript.

ERROR houve um problema no contato com os servidores da Google.
INVALID_REQUEST Esta GeocoderRequest era inválida.
OK A resposta contém um GeocoderResponse válido.
OVER_QUERY_LIMIT A página web ultrapassou o limite de solicitações em um período muito curto.
REQUEST_DENIED A página web não tem permissão para usar o geocodificador.
UNKNOWN_ERROR Não foi possível processar uma solicitação de geocodificação devido a um erro no servidor. Se você tentar novamente, a solicitação poderá dar certo.
ZERO_RESULTS Nenhum resultado encontrado para GeocoderRequest.

InterfaceResponse

Interface google.maps.GeocoderResponse

Uma resposta do geocodificador retornada pelo Geocoder contendo a lista de GeocoderResults.

results
A lista de GeocoderResults.

InterfaceResult.

Interface google.maps.GeocoderResult

Um único resultado do geocodificador recuperado do servidor do geocódigo. Uma solicitação do geocódigo pode retornar diversos objetos de resultado. Embora esse resultado seja semelhante a JSON, ele não é estritamente JSON, já que inclui indiretamente um objeto LatLng.

address_components
Uma matriz de GeocoderAddressComponents.
formatted_address
Tipo:string
Uma string que contém o endereço legível deste local.
geometry
Um objeto GeocoderGeometry
place_id
Tipo:string
O ID do lugar associado ao local. IDs de lugares identificam um local de modo exclusivo no banco de dados do Google Places e no Google Maps. Saiba mais sobre IDs de lugar no guia do desenvolvedor da API Places.
types
Tipo:Array<string>
Uma matriz de strings que denotam o tipo do elemento geocodificado retornado. Para ver uma lista de possíveis strings, consulte a seção Tipos de componentes de endereço do Guia do desenvolvedor.
partial_match optional
Tipo:boolean optional
Se o geocodificador não retornou uma correspondência exata para a solicitação original, embora tenha conseguido corresponder parte do endereço solicitado. Se for uma correspondência exata, o valor será undefined.
plus_code optional
Tipo:PlacePlusCode optional
O Plus Code associado ao local.
postcode_localities optional
Tipo:Array<string> optional
Uma matriz de strings que indicam todas as localidades contidas em um código postal. Esse elemento só está presente quando o resultado é um código postal que contém várias localidades.

interface GeocodingAddressComponent.

Interface google.maps.GeocoderAddressComponent

Um único componente de endereço em um GeocoderResult. Um endereço completo pode ser composto de vários componentes de endereço.

long_name
Tipo:string
O texto completo do componente de endereço.
short_name
Tipo:string
O texto curto, abreviado, do componente de endereço especificado.
types
Tipo:Array<string>
Uma matriz de strings que indica o tipo deste componente de endereço. Veja uma lista de tipos válidos aqui.

Interface geocodificadorGeo

Interface google.maps.GeocoderGeometry

Informações de geometria sobre este GeocoderResult

location
Tipo:LatLng
As coordenadas de latitude/longitude deste resultado.
location_type
O tipo de local retornado em location.
viewport
Os limites da janela de visualização recomendada para exibir a GeocoderResult.
bounds optional
Tipo:LatLngBounds optional
Os limites exatos deste GeocoderResult, se aplicável.

MapLocationType

google.maps.GeocoderLocationType constantes

Descreve o tipo de local retornado de um geocódigo. Especifique-as por valor ou usando o nome da constante. Por exemplo, 'ROOFTOP' ou google.maps.GeocoderLocationType.ROOFTOP.

Acesse const {GeocoderLocationType} = await google.maps.importLibrary("geocoding") chamando. Consulte Bibliotecas na API Maps JavaScript.

APPROXIMATE O resultado retornado é aproximado.
GEOMETRIC_CENTER O resultado retornado é o centro geométrico de um resultado, como uma linha (por exemplo, uma rua) ou polígono (região).
RANGE_INTERPOLATED O resultado retornado reflete uma aproximação (normalmente em uma estrada) interpolada entre dois pontos precisos (como interseções). Resultados interpolados geralmente são retornados quando códigos geográficos de rooftop não estão disponíveis para um endereço.
ROOFTOP O resultado retornado reflete um geocódigo preciso.