Geocoder

Geocoder

Clase google.maps.Geocoder

Un servicio para la conversión entre una dirección y una LatLng

Cuando se usa v=beta, se puede acceder a él llamando a const {Geocoder} = await google.map.importLibrary("geocoding"). Consulta Bibliotecas en la API de Maps JavaScript.

Geocoder
Geocoder()
Parámetros: ninguno
Crea una instancia nueva de un Geocoder que envíe solicitudes de geocódigo a los servidores de Google.
geocode
geocode(request[, callback])
Parámetros:
Valor que se muestra: Promise<GeocoderResponse>
Geocodificar una solicitud

GeocoderRequest

Interfaz de google.maps.GeocoderRequest

Es la especificación de una solicitud de geocodificación que se enviará a Geocoder.

address optional
Tipo: string optional
Dirección de codificación geográfica. Se debe proporcionar solo uno, address, location y placeId.
bounds optional
LatLngBounds para realizar la búsqueda Opcional.
componentRestrictions optional
Los componentes se usan para restringir los resultados a un área específica. Un filtro consta de uno o más de los siguientes elementos: route, locality, administrativeArea, postalCode, country. Solo se devolverán resultados que coincidan con todos los filtros. Los valores de filtros admiten los mismos métodos de corrección ortográfica y coincidencia parcial que otras solicitudes de geocodificación. Opcional.
language optional
Tipo: string optional
Un identificador de idioma para el idioma en el que se deben mostrar los resultados, cuando sea posible. Consulta la lista de idiomas compatibles.
location optional
Tipo: LatLng|LatLngLiteral optional
LatLng (o LatLngLiteral) para buscar. El geocodificador aplica un geocódigo inverso. Consulta Geocodificación inversa para obtener más información. Se debe proporcionar solo uno, address, location y placeId.
placeId optional
Tipo: string optional
El id. de sitio asociado con la ubicación. Los IDs de lugar identifican de forma exclusiva un sitio en la base de datos de Google Places y en Google Maps. Obtén más información sobre los ID de lugar en la guía para desarrolladores de la API de Places. El geocodificador aplica un geocódigo inverso. Consulta Geocodificación inversa para obtener más información. Se debe proporcionar solo uno, address, location y placeId.
region optional
Tipo: string optional
Código de país utilizado para sesgar la búsqueda, especificado como una subetiqueta regional Unicode de dos caracteres (no numérica) o un identificador CLDR. Opcional. Consulta los detalles de cobertura de Google Maps Platform para conocer las regiones admitidas.

GeocoderComponentRestrictions

Interfaz de google.maps.GeocoderComponentRestrictions

GeocoderComponentRestrictions representa un conjunto de filtros que se resuelven en un área específica. Para obtener detalles sobre cómo funciona esto, consulta Filtrado de componentes de geocodificación.

administrativeArea optional
Tipo: string optional
Coincide con todos los administrative_area levels. Opcional.
country optional
Tipo: string optional
Coincide con un nombre de país o un código de país ISO 3166-1 de dos letras. Opcional.
locality optional
Tipo: string optional
Coincide con los tipos locality y sublocality. Opcional.
postalCode optional
Tipo: string optional
Coincide con postal_code y postal_code_prefix. Opcional.
route optional
Tipo: string optional
Coincide con el nombre largo o corto de un route. Opcional.

Constantes de GeocoderStatus

google.maps.GeocoderStatus constantes

El estado que muestra Geocoder cuando finaliza una llamada a geocode(). Especifícalos por valor o usa el nombre de la constante. Por ejemplo, 'OK' o google.maps.GeocoderStatus.OK.

Cuando se usa v=beta, se puede acceder a él llamando a const {GeocoderStatus} = await google.map.importLibrary("geocoding"). Consulta Bibliotecas en la API de Maps JavaScript.

ERROR se produjo un problema al contactar a los servidores de Google.
INVALID_REQUEST Este GeocoderRequest no es válido.
OK La respuesta contiene un GeocoderResponse válido.
OVER_QUERY_LIMIT La página web excedió el límite de solicitudes en un período demasiado corto.
REQUEST_DENIED La página web no puede usar el geocodificador.
UNKNOWN_ERROR No se pudo procesar una solicitud de geocodificación debido a un error en el servidor. La solicitud podría completarse si realizas un nuevo intento.
ZERO_RESULTS No se encontraron resultados para este GeocoderRequest.

GeocoderResponse

Interfaz de google.maps.GeocoderResponse

Una respuesta del geocodificador que muestra el Geocoder con la lista de GeocoderResult

results
La lista de GeocoderResult.

GeocoderResult

Interfaz de google.maps.GeocoderResult

Se obtiene un solo resultado del geocodificador del servidor. Una solicitud de geocódigo puede devolver múltiples objetos de resultados. Ten en cuenta que, si bien este resultado es "similar a JSON", no es estrictamente JSON, ya que incluye de manera indirecta un objeto LatLng.

address_components
Un arreglo de GeocoderAddressComponent
formatted_address
Tipo: string
Una string que contiene la dirección de esta ubicación en lenguaje natural.
geometry
Un objeto GeocoderGeometry
place_id
Tipo: string
El id. de sitio asociado con la ubicación. Los IDs de lugar identifican de forma exclusiva un sitio en la base de datos de Google Places y en Google Maps. Obtén más información sobre los ID de lugar en la guía para desarrolladores de la API de Places.
types
Tipo: Array<string>
Matriz de strings que denota el tipo del elemento geocodificado que se muestra. Para obtener una lista de posibles strings, consulta la sección Tipos de componentes de dirección de la Guía para programadores.
partial_match optional
Tipo: boolean optional
Indica si el geocodificador no devolvió una coincidencia exacta para la solicitud original, aunque sí encontró una coincidencia parcial para la dirección solicitada. Si hay una coincidencia exacta, el valor será undefined.
plus_code optional
Tipo: PlacePlusCode optional
El código plus asociado con la ubicación
postcode_localities optional
Tipo: Array<string> optional
Una matriz de strings que denotan todas las localidades que contiene un código postal. Esto solo se presenta cuando el resultado es un código postal que contiene varias localidades.

GeocoderAddressComponent

Interfaz de google.maps.GeocoderAddressComponent

Un solo componente de dirección dentro de un GeocoderResult. Una dirección completa puede constar de varios componentes de dirección.

long_name
Tipo: string
El texto completo del componente de la dirección
short_name
Tipo: string
Texto abreviado del componente de dirección dado
types
Tipo: Array<string>
Una matriz de strings que denotan el tipo de este componente de dirección. Puedes encontrar una lista de los tipos válidos aquí.

GeocoderGeometry

Interfaz de google.maps.GeocoderGeometry

Información sobre la geometría de este GeocoderResult

location
Tipo: LatLng
Las coordenadas de latitud y longitud de este resultado
location_type
El tipo de ubicación que se muestra en location
viewport
Los límites del viewport recomendado para mostrar este GeocoderResult
bounds optional
Tipo: LatLngBounds optional
Los límites precisos de este GeocoderResult, si corresponde

Constantes de GeocoderLocationType

google.maps.GeocoderLocationType constantes

Describe el tipo de ubicación mostrada en un geocódigo. Especifícalos por valor o usa el nombre de la constante. Por ejemplo, 'ROOFTOP' o google.maps.GeocoderLocationType.ROOFTOP.

Cuando se usa v=beta, se puede acceder a él llamando a const {GeocoderLocationType} = await google.map.importLibrary("geocoding"). Consulta Bibliotecas en la API de Maps JavaScript.

APPROXIMATE El resultado que se muestra es aproximado.
GEOMETRIC_CENTER El resultado que se muestra es el centro geométrico de un resultado como una línea (p.ej., una calle) o un polígono (región).
RANGE_INTERPOLATED El resultado que se muestra refleja una aproximación (generalmente en una ruta) interpolada entre dos puntos precisos (como intersecciones). Generalmente se devuelven resultados interpolados cuando no se encuentran disponibles geocódigos exactos para una dirección.
ROOFTOP El resultado que se muestra refleja un geocódigo preciso.