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 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:
- Geocodifica una dirección: Coordenadas geográficas para direcciones. También se denomina geocodificación directa.
- Geocodifica una ubicación: Direcciones para conjuntos de coordenadas de latitud y longitud. También se denomina geocodificación inversa.
- Geocodificación de lugares: Recupera una dirección a partir de un ID de lugar.
- 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.
Probar demostración
Cómo funciona la API de Geocoding
La API de Geocoding realiza tanto la geocodificación como la geocodificación inversa:
- Geocoding: 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 vista.
- Geocodificación inversa: Convierte coordenadas de latitud y longitud o un ID de lugar en una dirección legible por humanos. Puedes usar direcciones para una variedad de situaciones, incluidas las entregas o las recogidas.
En la siguiente tabla, se resumen los recursos disponibles a través de la API de Geocoding junto con los datos que devuelve cada método.
| 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 sobre 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. | |
| Geocodificación 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 lugares. | |
| Búsqueda de destinos | Muestra 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. |
Canales de etapas de lanzamiento
La versión 4 de la API de Geocoding tiene canales independientes para las funciones de DG, versión preliminar y experimentales. Si deseas usar las funciones de versión preliminar o experimentales, asegúrate de especificar el canal correcto en tu solicitud. Por ejemplo,
para acceder a las funciones del extremo Destinations en Experimental, usa esta solicitud
HTTP: https://geocode.googleapis.com/v4alpha/geocode/destinations.
| Etapa de lanzamiento | Nombre del canal |
|---|---|
| DG | /v4/ |
| Vista previa | /v4beta/ |
| Experimental | /v4alpha/ |
- Consulta la referencia de REST para obtener una lista y una descripción de todos los recursos de REST disponibles.
- Consulta las etapas de lanzamiento para obtener más información sobre cada etapa.
Funciones de la API de Geocoding v4
La versión 4 de la API de Geocoding ofrece estas nuevas funciones.
Método de búsqueda de destino
La versión 4 presenta un método de búsqueda de destinos que te permite recuperar información detallada sobre varios destinos en función de 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 implementa en la plataforma estándar de Google Cloud.
La API de Geocoding v4 se implementa en la infraestructura de servicios en 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 entre 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 la máscara de campo
Usa máscaras de campo para especificar qué información debe devolver la respuesta. Para los métodos Geocode an address, Geocode a location y Place geocoding, se devuelven todos los campos del objeto de respuesta de forma predeterminada. Para el método Search for destinations, debes especificar una máscara de campo en la solicitud a la API.
Seguridad de APIs
La API de Geocoding v4 está diseñada como una API de servidor a servidor. Las llamadas directas del cliente desde un navegador exponen las claves de API a un riesgo significativo de robo y uso inadecuado, ya que las restricciones de referencia HTTP no son una protección suficiente para los extremos de servicio web.
Te recomendamos que llames a la API de Geocoding v4 desde tu propio servidor de backend. Para obtener más detalles sobre los patrones de implementación seguros y las alternativas para las necesidades del cliente, consulta Consideraciones de seguridad.