La API de Geocoding es un servicio que acepta un lugar como una dirección, coordenadas de latitud y longitud, o un ID de lugar. Convierte la dirección en coordenadas de latitud y longitud, y en un ID de lugar, o bien convierte las coordenadas de latitud y longitud, o un ID de lugar, en una dirección.
Qué puedes hacer con la API de Geocoding
Puedes usar la API de Geocoding para obtener datos de geocodificación de una o más direcciones o lugares, incluidos los siguientes:
Esta versión de la API de Geocoding v4 incluye el lanzamiento de los siguientes extremos:
- (Versión preliminar) Geocodifica una dirección: Coordenadas geográficas de direcciones También se denomina geocodificación directa.
- (Vista previa) Geocodificación de una ubicación: Direcciones para conjuntos de coordenadas de latitud y longitud También se conoce como geocodificación inversa.
- (Versión preliminar) Geocodificación de lugares: Recupera una dirección a partir de un ID de lugar.
- (Versión preliminar) Buscar destinos: Busca un destino a partir de una dirección, un ID de lugar o una ubicación.
Puedes controlar dónde aparecen los resultados y restringirlos a una región, un condado o un código postal en particular.
Cómo funciona la API de Geocoding
La API de Geocoding realiza tanto la geocodificación como la geocodificación inversa:
- Geocodificación: Convierte direcciones, como "1600 Amphitheatre Parkway, Mountain View, CA", en coordenadas de latitud y longitud o IDs de lugar. Puedes usar estas coordenadas para colocar marcadores en un mapa, o bien para centrar o cambiar la posición del mapa dentro del marco de la vista.
- Geocodificación inversa: Convierte las coordenadas de latitud y longitud o un ID de lugar en una dirección legible por humanos. Puedes usar direcciones para diversas situaciones, como entregas o retiros.
En la siguiente tabla, se resumen los recursos disponibles a través de la API de Geocoding, junto con los datos que devuelve cada extremo.
| Recursos de datos | Datos devueltos | Formato de devolución |
|---|---|---|
| Geocoding | Devuelve la dirección, los componentes de la dirección y los tipos de dirección. Consulta la documentación de la respuesta de geocodificación. |
|
| Geocodificación inversa | Devuelve la dirección, los componentes de la dirección y los tipos de dirección. Consulta la documentación de la respuesta de geocodificación inversa. | |
| Geocoding de lugares | Devuelve la dirección, los componentes de la dirección y los tipos de dirección. Consulta la documentación de la respuesta de geocodificación de Place. | |
| Búsqueda de destino | Devuelve información detallada sobre varios destinos según diferentes criterios de entrada, como una dirección, un ID de lugar o coordenadas de latitud y longitud. Consulta la documentación de Búsqueda de destino. |
Funciones de la versión 4 de la API de Geocoding
La versión 4 de la API de Geocoding ofrece estas nuevas funciones.
Extremo de búsqueda de destino
La versión 4 introduce un endpoint de búsqueda de destinos que te permite recuperar información detallada sobre varios destinos según diferentes criterios de entrada, como una dirección, un ID de lugar o coordenadas de latitud y longitud. La respuesta incluye resúmenes potenciados por IA y tokens de puntos de navegación que contienen información contextual que se puede pasar al SDK de Navigation para obtener rutas precisas.
Se implementó en la plataforma estándar de Google Cloud
La API de Geocoding v4 se implementa en la infraestructura de servicio de Google Cloud. Esta implementación trae consigo una plataforma más segura y confiable con opciones de seguridad mejoradas, como OAuth. Este diseño de API estándar aporta un nivel de coherencia en todas las APIs que mejora la eficiencia del desarrollo con la API de Geocoding v4.
Se agregó compatibilidad con OAuth
La API de Geocoding v4 admite el uso de OAuth 2.0 para la autenticación. Google admite situaciones comunes de OAuth 2.0, como las de un servidor web.
Se agregó compatibilidad con máscaras de campo
Usa máscaras de campo para especificar qué información debe devolver la respuesta. En el caso de los endpoints Geocode an address, Geocode a location y Place geocoding, todos los campos del objeto de respuesta se muestran de forma predeterminada. Para el extremo Search for destinations, debes especificar una máscara de campo en la solicitud a la API.
Sin costo por uso durante la versión preliminar
La API de Geocoding v4 se encuentra en la etapa de vista previa previa al lanzamiento de la DG, y no se aplican cargos por el uso de la API durante la vista previa. Las llamadas a la API aparecerán en la página Facturación de la consola de Cloud, pero los cargos serán de USD 0.
Comentarios
Esta es una función de versión preliminar. Agradeceríamos tus comentarios en geocoding-feedback-channel@google.com.