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.
La API de Geocoding v4 proporciona inteligencia hiperlocal de destino y llegada, y resolución principal de coordenadas a direcciones. Ya sea que estés creando una experiencia de entrega de última milla, viajes compartidos o navegación paso a paso, o normalizando direcciones de calles en coordenadas, la versión 4 ofrece extremos dedicados adaptados a tu caso de uso.
¿No sabes qué extremo se adapta a tu aplicación? Consulta Cómo elegir un método de geocodificación.
Qué puedes hacer con la API de Geocoding
La API de Geocoding v4 incluye las siguientes funciones y extremos:
- Busca destinos: Recupera detalles de llegada hiperlocales para un destino a partir de una dirección, un ID de lugar o coordenadas, incluidas las entradas de los edificios, los tokens de puntos de navegación enrutables, los contornos de los edificios y los terrenos, los subdestinos y los puntos de referencia cercanos.
- Geocodifica una dirección: Convierte direcciones en coordenadas geográficas y en IDs de lugar (geocodificación directa).
- Geocodifica una ubicación: Convierte coordenadas de latitud y longitud en direcciones o áreas administrativas legibles por humanos (geocodificación inversa).
- Geocodifica un lugar: Recupera detalles de la dirección con formato y las coordenadas de un ID de lugar de Google Maps conocido.
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 v4 admite la búsqueda de destinos junto con la geocodificación básica:
- Búsqueda de destino (
SearchDestinations): Resuelve una dirección, un ID de lugar o un par de coordenadas en un objetoDestinationenriquecido. Usa este método cuando la llegada física sea importante, como para identificar las entradas preferidas de los edificios, dirigir a los conductores a los puntos de partida o llegada designados con tokens de puntos de navegación, renderizar las huellas de los edificios en un mapa o navegar por complejos de varios edificios. - Geocodificación básica: Convierte direcciones, coordenadas y Place IDs:
- Geocodificación: Convierte direcciones, como "1600 Amphitheatre Parkway, Mountain View, CA", en coordenadas de latitud y longitud o IDs de lugar para colocar marcadores en el mapa o centrar el marco de la vista de mapa.
- Geocodificación inversa: Convierte las coordenadas de latitud y longitud o los IDs de lugar en direcciones legibles por humanos para los pines del mapa que colocan los usuarios, los selectores de ubicación o la visualización de la IU.
- Geocodificación de lugares: Recupera los detalles de la dirección y las coordenadas de un ID de lugar de Google Maps conocido.
En la siguiente tabla, se resumen los recursos disponibles a través de la API de Geocoding v4 junto con los datos que devuelve cada método:
| Recursos de datos | Datos devueltos | Formato de devolución |
|---|---|---|
| Buscar destinos ( POST /v4/geocode/destinations)
|
Devuelve información de llegada hiperlocal: polígonos de edificios y terrenos (displayPolygon), entrances físicos, navigationPoints enrutables (con tokens), containingPlaces y subDestinations jerárquicos, landmarks relacionales y Place Details principales. Consulta Cómo buscar destinos.
|
|
| Geocodifica una dirección ( GET /v4/geocode/address)
|
Devuelve la dirección, los componentes de la dirección y los tipos de dirección. Consulta Respuesta de geocodificación. | |
| Geocodifica una ubicación ( GET /v4/geocode/location)
|
Devuelve la dirección, los componentes de la dirección y los tipos de dirección. Consulta Respuesta de geocodificación inversa. | |
| Geocodifica un lugar ( GET /v4/geocode/places)
|
Devuelve la dirección, los componentes de la dirección y los tipos de dirección. Consulta Respuesta de geocodificación de Place. |
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 quieres 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.