Vincular a Google Maps

La API de Places acepta solicitudes de datos de lugares a través de una variedad de métodos. La respuesta de la API de Places contiene datos sobre un lugar, incluidos datos y imágenes de ubicación, ubicaciones geográficas y lugares de interés destacados.

Con esta versión, la respuesta de Text Search, Nearby Search y Place Details también puede contener vínculos a Google Maps. Los usuarios pueden explorar estos vínculos de Google Maps para ver información adicional sobre un lugar en la respuesta.

Por ejemplo, buscas aeropuertos en San Francisco, California. Luego, la respuesta incluye el Aeropuerto Internacional de San Francisco (SFO) en la lista de lugares. Con esta versión, el objeto Place para SFO en la respuesta agrega el campo googleMapsUri que contiene vínculos de Google Maps para abrir Google Maps en el lugar, instrucciones sobre cómo llegar al lugar, opiniones sobre el lugar y fotos del lugar.

Junto con los vínculos agregados al objeto Place, esta versión también agrega el campo googleMapsUri a los objetos Reviews y Photos en la respuesta:

  • Reviews.googleMapsUri: Contiene un vínculo de Google Maps a la opinión para que puedas verla en un navegador.

  • Photos.googleMapsUri: Contiene un vínculo de Google Maps a la foto para que puedas verla en un navegador.

El Explorador de APIs te permite realizar solicitudes en vivo para que te familiarices con estas nuevas opciones:

Pruébalo

En la siguiente tabla, se muestran los vínculos de Google Maps que puedes incluir en la respuesta:

Vínculo a Google Maps Descripción Nombre del campo
Lugar Es un vínculo para abrir Google Maps en el lugar. googleMapsLinks.placeUri
Instrucciones Vínculo para abrir instrucciones sobre cómo llegar al lugar en Google Maps googleMapsLinks.directionsUri
Escribir opinión Es un vínculo para escribir una opinión sobre el lugar en Google Maps. googleMapsLinks.writeAReviewUri
Leer opiniones Es un vínculo para mostrar las opiniones de Google Maps sobre el lugar. googleMapsLinks.reviewsUri
Fotos Es un vínculo para mostrar fotos del lugar en Google Maps. googleMapsLinks.photosUri

Precios

Esta función se encuentra en la etapa de vista previa previa a la DG y no se cobra por su uso durante la vista previa, es decir, la facturación es de USD 0. Para obtener detalles sobre los precios propuestos, consulta Uso y facturación de la API de Places.

Los vínculos de la respuesta de lugares se incluyen en el campo googleMapsLinks. Asegúrate de incluir el campo googleMapsLinks en la máscara de campo de la solicitud si deseas que aparezcan en la respuesta.

Por ejemplo, la siguiente Búsqueda de texto incluye todos los vínculos de Maps en la respuesta:

curl -X POST -d '{
  "textQuery" : "San Francisco International Airport"
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \
-H 'X-Goog-FieldMask: places.displayName,places.formattedAddress,places.priceLevel,places.googleMapsLinks' \
'https://places.googleapis.com/v1/places:searchText'

La respuesta tiene el siguiente formato:

{
  "places": [
    {
      "formattedAddress": "San Francisco, CA 94128, USA",
      "displayName": {
        "text": "San Francisco International Airport",
        "languageCode": "en"
      },
      "googleMapsLinks": {
        "placeUri": "https://maps.google.com/?cid=11885663895765773631",
        "directionsUri": "https://www.google.com/maps/dir//''/data=!4m7!4m6!1m1!4e2!1m2!1m1!1s0x808f778c55555555:0xa4f25c571acded3f!3e0",
        "writeAReviewUri": "https://www.google.com/maps/place//data=!4m3!3m2!1s0x808f778c55555555:0xa4f25c571acded3f!12e1",
        "reviewsUri": "https://www.google.com/maps/place//data=!4m4!3m3!1s0x808f778c55555555:0xa4f25c571acded3f!9m1!1b1",
        "photosUri": "https://www.google.com/maps/place//data=!4m3!3m2!1s0x808f778c55555555:0xa4f25c571acded3f!10e5"
      }
    }
  ]
}

No es necesario que devuelvas todos los vínculos en la respuesta. Por ejemplo, si solo quieres que el vínculo de fotos aparezca en la respuesta, modifica la máscara de campo como se muestra a continuación para que solo incluya el campo photosUri:

curl -X POST -d '{
  "textQuery" : "San Francisco International Airport"
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \
-H 'X-Goog-FieldMask: places.displayName,places.formattedAddress,places.priceLevel,places.googleMapsLinks.photosURI' \
'https://places.googleapis.com/v1/places:searchText'

Cómo incluir instrucciones en la respuesta

Todos los métodos de Places admiten la generación del vínculo de instrucciones en la respuesta. La ubicación actual se usa como origen, la ubicación del lugar se usa como destino y el modo de viaje es conducir.

En el siguiente ejemplo, se usa la Búsqueda cercana para incluir el vínculo de instrucciones sobre cómo llegar de Maps en la respuesta del campo directionsUri:

curl -X POST -d '{
  "includedTypes": ["restaurant"],
  "maxResultCount": 10,
  "locationRestriction": {
    "circle": {
      "center": {
        "latitude": -33.8688,
        "longitude": 151.1957362},
      "radius": 500.0
    }
  }
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key:API_KEY' \
-H 'X-Goog-FieldMask: places.displayName,places.googleMapsLinks.directionsUri' \
https://places.googleapis.com/v1/places:searchNearby

Esta versión agrega el campo googleMapsUri a los objetos Reviews y Photos en la respuesta. Si navegas a estos vínculos, se abrirá la opinión o la foto en Google Maps.

Por ejemplo, la siguiente Búsqueda de texto incluye opiniones y fotos de cada lugar en la respuesta:

curl -X POST -d '{
  "textQuery" : "Spicy Vegetarian Food in Sydney, Australia"
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \
-H 'X-Goog-FieldMask: places.displayName,places.reviews,places.photos' \
'https://places.googleapis.com/v1/places:searchText'

En la respuesta, cada elemento del array de opiniones y fotos contiene el campo googleMapsUri para abrir la opinión o la foto en un navegador.

Pruébalo

El explorador de API te permite realizar solicitudes de muestra para que te familiarices con la API y sus opciones.

  1. Selecciona el ícono de API, Expande el Explorador de API., en el lado derecho de la página.

  2. De manera opcional, expande Show standard parameters y establece el parámetro fields en la máscara de campo.

  3. De manera opcional, edita el Cuerpo de la solicitud.

  4. Selecciona el botón Ejecutar. En el cuadro de diálogo, elige la cuenta que deseas usar para realizar la solicitud.

  5. En el panel del Explorador de API, selecciona el ícono de expansión, Expande el Explorador de API., para expandir la ventana del Explorador de API.