Clase Geocoder
Clase google.maps.Geocoder
Es un servicio para convertir entre una dirección y un LatLng
.
Llama al const {Geocoder} = await google.maps.importLibrary("geocoding")
para acceder.
Consulta Bibliotecas en la API de Maps JavaScript.
Constructor | |
---|---|
Geocoder |
Geocoder() Parámetros: Ninguno
Crea una instancia nueva de un Geocoder que envía solicitudes de geocodificación a los servidores de Google. |
Métodos | |
---|---|
geocode |
geocode(request[, callback]) Parámetros:
Valor de devolución:
Promise<GeocoderResponse> Geocodifica una solicitud. |
Interfaz de GeocoderRequest
Interfaz de google.maps.GeocoderRequest
Es la especificación de una solicitud de geocodificación que se enviará al Geocoder
.
Propiedades | |
---|---|
address optional |
Tipo:
string optional Dirección para geocodificar. Se debe proporcionar uno, y solo uno, de los valores address , location y placeId . |
bounds optional |
Tipo:
LatLngBounds|LatLngBoundsLiteral optional LatLngBounds en el que se realizará la búsqueda. Opcional. |
componentRestrictions optional |
Tipo:
GeocoderComponentRestrictions 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. |
|
Tipo:
Array<ExtraGeocodeComputation> optional Es una lista de cálculos adicionales que se pueden usar para completar la solicitud. Nota: Estos cálculos adicionales pueden devolver campos adicionales en la respuesta. |
fulfillOnZeroResults optional |
Tipo:
boolean optional Cumple la promesa con un estado ZERO_RESULT en la respuesta. Esto puede ser conveniente porque, incluso con cero resultados de geocodificación, es posible que se devuelvan campos adicionales a nivel de la respuesta. |
language optional |
Tipo:
string optional Es un identificador del 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 realiza una geocodificación inversa. Consulta Geocodificación inversa para obtener más información. Se debe proporcionar uno, y solo uno, de los valores address , location y placeId . |
placeId optional |
Tipo:
string optional Es el ID de lugar asociado a 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 IDs de lugar en la guía para desarrolladores de la API de Places. El geocodificador realiza una geocodificación inversa. Consulta Geocodificación inversa para obtener más información. Se debe proporcionar uno, y solo uno, de los valores address , location y placeId . |
region optional |
Tipo:
string optional Es el código de país que se usa para sesgar la búsqueda, especificado como una subetiqueta de región Unicode o un identificador CLDR de dos caracteres (no numéricos). Opcional. Consulta los Detalles de la cobertura de Google Maps Platform para conocer las regiones admitidas. |
Interfaz de 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, consulta Filtrado de componentes de geocodificación.
Propiedades | |
---|---|
administrativeArea optional |
Tipo:
string optional Coincide con todos los administrative_area levels . Opcional. |
country optional |
Tipo:
string optional Establece coincidencias con un nombre de país o con un código de país ISO 3166-1 de dos letras. Opcional. |
locality optional |
Tipo:
string optional Establece coincidencias 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 Establece coincidencias con el nombre largo o corto de una route . Opcional. |
Constantes de ExtraGeocodeComputation
Constantes de google.maps.ExtraGeocodeComputation
Son cálculos adicionales que se deben realizar al completar una solicitud de codificación geográfica.
Llama al const {ExtraGeocodeComputation} = await google.maps.importLibrary("geocoding")
para acceder.
Consulta Bibliotecas en la API de Maps JavaScript.
Constantes | |
---|---|
ADDRESS_DESCRIPTORS |
Genera un descriptor de dirección. |
Constantes de GeocoderStatus
Constantes de google.maps.GeocoderStatus
Es el estado que muestra Geocoder
cuando se completa una llamada a geocode()
. Puedes especificarlos por valor o con el nombre de la constante. Por ejemplo, 'OK'
o google.maps.GeocoderStatus.OK
.
Llama al const {GeocoderStatus} = await google.maps.importLibrary("geocoding")
para acceder.
Consulta Bibliotecas en la API de Maps JavaScript.
Constantes | |
---|---|
ERROR |
se produjo un problema al contactar a los servidores de Google. |
INVALID_REQUEST |
Este GeocoderRequest no era válido. |
OK |
La respuesta contiene un GeocoderResponse válido. |
OVER_QUERY_LIMIT |
La página web superó el límite de solicitudes en un período demasiado corto. |
|