Vincular a Google Maps

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

Las respuestas de Text Search (nuevo), Nearby Search (nuevo) y Place Details (nuevo) también pueden contener vínculos a Google Maps. Tus usuarios pueden navegar a 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. 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, también se 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 tiempo real para que te familiarices con estas nuevas opciones:

Pruébalo

Vínculos de Google Maps admitidos para un lugar

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

Incluir todos los vínculos en la respuesta de Places

Los vínculos en la respuesta de lugares se encuentran 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 (nuevo) 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"
      }
    }
  ]
}

Incluir un vínculo específico en la respuesta

No es necesario que devuelvas todos los vínculos en la respuesta. Por ejemplo, si solo deseas el vínculo de las fotos en la respuesta, modifica la máscara de campo como se muestra a continuación para incluir solo 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'

Incluir instrucciones sobre cómo llegar en la respuesta

Todos los métodos de Places admiten la generación del vínculo de direcciones 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 en automóvil.

En el siguiente ejemplo, se usa Nearby Search (nuevo) para incluir el vínculo a las indicaciones de Maps en la respuesta en el 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

Incluye vínculos a opiniones y fotos

En esta versión, se agregó el campo googleMapsUri a los objetos Reviews y Photos de 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 (nueva) 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 APIs te permite realizar solicitudes de muestra para que te familiarices con la API y sus opciones.

1. Selecciona el ícono de la API de api en el lado derecho de la página.

2. De manera opcional, expande Mostrar parámetros estándar 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 APIs, selecciona fullscreen .

   Pantalla completa para expandir la ventana del Explorador de API