Vincular a Google Maps

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

La respuesta de Text Search (nuevo), Nearby Search (nuevo) y Place Details (nuevo) también puede 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, si buscas aeropuertos en San Francisco, California, la respuesta incluye el Aeropuerto Internacional de San Francisco (SFO) en la lista de lugares. El Place objeto para SFO en la respuesta agrega el campo googleMapsUri que contiene vínculos de Google Maps para abrir Google Maps en el lugar, instrucciones para llegar al lugar, opiniones sobre el lugar y fotos del lugar.

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

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

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

El Explorador de APIs te permite realizar solicitudes en tiempo real para que puedas familiarizarte 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:

Incluye todos los vínculos en la respuesta de Places

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

Por ejemplo, la siguiente Text Search (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"
      }
    }
  ]
}

Incluye un vínculo específico en la respuesta

No es necesario que muestres todos los vínculos en la respuesta. Por ejemplo, si solo quieres el vínculo de 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'

Incluye 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 en auto.

En el siguiente ejemplo, se usa Nearby Search (nuevo) para incluir el vínculo de instrucciones 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 de opiniones y fotos

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

Por ejemplo, la siguiente Text Search (nuevo) incluye opiniones y fotos para 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 puedas familiarizarte con la API y sus opciones.

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

2. De manera opcional, expande Mostrar parámetros estándar y establece el fields parámetro 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 Explorador de APIs, selecciona fullscreen

   Pantalla completa para expandir la ventana del Explorador de APIs.