Classe Geocoding
Classe
google.maps.Geocoder
Um serviço para conversão entre um endereço e um LatLng
.
Construtor | |
---|---|
Geocoder |
Geocoder() Parâmetros:nenhum
Cria uma nova instância de um Geocoder que envia solicitações de geocódigo para servidores do Google. |
Métodos | |
---|---|
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
.
Propriedades | |
---|---|
address optional |
Tipo:
string optional Endereço para geocodificação. É necessário fornecer apenas um dos address , location e placeId . |
bounds optional |
Tipo:
LatLngBounds|LatLngBoundsLiteral optional LatLngBounds em que pesquisar. Opcional. |
componentRestrictions optional |
Tipo:
GeocoderComponentRestrictions 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. |
|
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.
Propriedades | |
---|---|
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
.
Constantes | |
---|---|
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 GeocoderResult
s.
Propriedades | |
---|---|
results |
Tipo:
Array<GeocoderResult> A lista de GeocoderResult s. |
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
.
Propriedades | |
---|---|
address_components |
Uma matriz de GeocoderAddressComponent s. |
formatted_address |
Tipo:
string Uma string que contém o endereço legível deste local. |
geometry |
Tipo:
GeocoderGeometry 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.
Propriedades | |
---|---|
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
Propriedades | |
---|---|
location |
Tipo:
LatLng As coordenadas de latitude/longitude deste resultado. |
location_type |
Tipo:
GeocoderLocationType O tipo de local retornado em location . |
viewport |
Tipo:
LatLngBounds 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
.
Constantes | |
---|---|
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. |