Geocoder

Organiza tus páginas con colecciones Guarda y categoriza el contenido según tus preferencias.

Geocoder.

Clase google.maps.Geocoder

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

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

Interfaz de GeocoderRequest

Interfaz google.maps.GeocoderRequest

La especificación de una solicitud de codificación geográfica que se enviará a Geocoder.

address optional
Tipo: string optional
Dirección a geocódigo. Se debe proporcionar el único valor de address, location y placeId.
bounds optional
LatLngBounds para buscar. 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 y 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.
Betalanguage 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 una geocodificación inversa. Consulta Geocodificación inversa para obtener más información. Se debe proporcionar el único valor de address, location y placeId.
placeId optional
Tipo: string optional
El id. de sitio asociado con la ubicación. Los id. de sitio identifican de forma exclusiva un sitio en la base de datos de Google Places y en Google Maps. Obtén más información acerca de los ID de lugar en la guía para desarrolladores de la API de Places. El geocodificador aplica una geocodificación inversa. Consulta Geocodificación inversa para obtener más información. Se debe proporcionar el único valor de address, location y placeId.
region optional
Tipo: string optional
Código de país utilizado para personalizar la búsqueda, especificado como un identificador de CLDR o subetiqueta de región Unicode de dos caracteres (no numérico). Opcional. Consulta los detalles de cobertura de Google Maps Platform para conocer las regiones admitidas.

Interfaz GeocoderComponentRestrictions

Interfaz 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 con 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 el Geocoder al completar una llamada a geocode(). Especifícalos por valor o usa el nombre de la constante. Por ejemplo, 'OK' o google.maps.GeocoderStatus.OK.

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 muy corto.
REQUEST_DENIED La página web no puede utilizar el geocodificador.
UNKNOWN_ERROR No se pudo procesar una solicitud de geocodificación debido a un error del servidor. La solicitud puede tener éxito si realizas un nuevo intento.
ZERO_RESULTS No se encontró ningún resultado para GeocoderRequest.

Interfaz de GeocoderResponse

Interfaz google.maps.GeocoderResponse

Una respuesta de geocodificador que muestra Geocoder y que contiene la lista de GeocoderResult.

results
La lista de GeocoderResult.

GeocoderResult.

Interfaz google.maps.GeocoderResult

Un solo resultado de geocodificador recuperado del servidor de geocodificación. Una solicitud de geocodificación puede mostrar múltiples objetos de resultados. Ten en cuenta que, si bien este resultado es similar a JSON, no es estrictamente JSON, ya que incluye un objeto LatLng de manera indirecta.

address_components
Un arreglo de GeocoderAddressComponent
formatted_address
Tipo: string
Una string que contiene la dirección legible de esta ubicación.
geometry
Un objeto GeocoderGeometry
place_id
Tipo: string
El id. de sitio asociado con la ubicación. Los id. de sitio identifican de forma exclusiva un sitio en la base de datos de Google Places y en Google Maps. Obtén más información acerca de los ID de lugar en la guía para desarrolladores de la API de Places.
types
Tipo: Array<string>
Una matriz de strings que denota el tipo del elemento geocodificado que se muestra. Para obtener una lista de strings posibles, consulta la sección Tipos de componentes de dirección de la Guía para desarrolladores.
partial_match optional
Tipo: boolean optional
Indica si el geocodificador no devolvió una coincidencia exacta para la solicitud original, aunque pudo coincidir con parte de 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
Es una matriz de strings que denota 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 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 determinado
types
Tipo: Array<string>
Es un arreglo de strings que denota el tipo de este componente de dirección. Puedes encontrar una lista de los tipos válidos aquí.

GeocoderGeometry

Interfaz google.maps.GeocoderGeometry

Información de geometría sobre 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 GeocoderLocationType

google.maps.GeocoderLocationType constantes

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

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 calle) 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.