Place Details (nuevo)

Selecciona la plataforma: Android iOS JavaScript Servicio web
Desarrolladores del Espacio Económico Europeo (EEE)

Introducción

Una vez que tengas un ID de lugar, podrás iniciar una solicitud de Place Details (nuevo) para obtener más detalles sobre un establecimiento o lugar de interés en particular. Una solicitud de Place Details (nuevo) devuelve información más completa sobre el lugar indicado, como su dirección completa, número de teléfono, calificación y opiniones de los usuarios.

Existen muchas formas de obtener un ID de lugar. Puedes usar lo siguiente:

El Explorador de APIs te permite realizar solicitudes en tiempo real para que puedas familiarizarte con la API y sus opciones:

Solicitudes de Place Details (nuevo)

Una solicitud de Place Details (nuevo) es una solicitud GET HTTP con el siguiente formato:

https://places.googleapis.com/v1/places/PLACE_ID

Pasa todos los parámetros como parámetros de URL o en encabezados como parte de la solicitud GET. Por ejemplo:

https://places.googleapis.com/v1/places/ChIJj61dQgK6j4AR4GeTYWZsKWw?fields=id,displayName&key=API_KEY

O en un comando curl:

curl -X GET -H 'Content-Type: application/json' \
-H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: id,displayName" \
https://places.googleapis.com/v1/places/ChIJj61dQgK6j4AR4GeTYWZsKWw

Respuestas de Place Details (nuevo)

Place Details (nuevo) devuelve un objeto JSON como respuesta. En la respuesta, figura lo siguiente:

  • La respuesta se representa con un objeto Place. El objeto Place contiene información detallada sobre el lugar.
  • La FieldMask que se pasa en la solicitud especifica la lista de campos que se devuelven en el objeto Place.

El objeto JSON completo tiene el siguiente formato:

{
  "name": "places/ChIJkR8FdQNB0VQRm64T_lv1g1g",
  "id": "ChIJkR8FdQNB0VQRm64T_lv1g1g",
  "displayName": {
    "text": "Trinidad"
  }
  ...
}

Parámetros obligatorios

  • FieldMask

    Especifica la lista de campos que se mostrarán en la respuesta creando una máscara de campo de respuesta. Pasa la máscara de campo de respuesta al método con el parámetro de URL $fields o fields, o con el encabezado HTTP X-Goog-FieldMask. No hay una lista predeterminada de campos devueltos en la respuesta. Si omites la máscara de campo, el método devuelve un error.

    El enmascaramiento de campos es una práctica de diseño recomendada para garantizar que no solicites datos innecesarios, lo que ayuda a evitar tiempos de procesamiento y cargos de facturación adicionales.

    Especifica una lista separada por comas de los tipos de datos de lugar que deseas que se muestren. Por ejemplo, para recuperar el nombre visible y la dirección del lugar.

    X-Goog-FieldMask: displayName,formattedAddress

    Usa * para recuperar todos los campos.

    X-Goog-FieldMask: *

    Especifica uno o más de los siguientes campos:

    • Los siguientes campos activan el SKU de Place Details Essentials IDs Only:

      attributions
      consumerAlert
      id
      movedPlace
      movedPlaceId
      name*
      photos

      * El campo name contiene el nombre de recurso del lugar expresado de la siguiente forma: places/PLACE_ID. Para obtener el nombre del lugar en forma de texto, solicita el campo displayName en el SKU Pro.

      Para obtener una lista completa de los campos y sus SKUs asociados, consulta Campos de datos de Place (nuevo).

    • Los siguientes campos activan el SKU de Place Details Essentials:

      addressComponents
      addressDescriptor*
      adrFormatAddress
      formattedAddress
      location
      plusCode
      postalAddress
      shortFormattedAddress
      types
      viewport

      * Los descriptores de direcciones están disponibles de forma general para los clientes de India y son experimentales en otros lugares.

      Para obtener una lista completa de los campos y sus SKUs asociados, consulta Campos de datos de Place (nuevo).

    • Los siguientes campos activan el SKU de Place Details Pro:

      accessibilityOptions
      businessStatus
      containingPlaces
      displayName
      googleMapsLinks
      googleMapsTypeLabel
      googleMapsUri
      iconBackgroundColor
      iconMaskBaseUri
      openingDate
      primaryType
      primaryTypeDisplayName
      pureServiceAreaBusiness
      subDestinations
      timeZone
      utcOffsetMinutes

      Para obtener una lista completa de los campos y sus SKUs asociados, consulta Campos de datos de Place (nuevo).

    • Los siguientes campos activan el SKU de Place Details Enterprise:

      currentOpeningHours
      currentSecondaryOpeningHours
      internationalPhoneNumber
      nationalPhoneNumber
      priceLevel
      priceRange
      rating
      regularOpeningHours
      regularSecondaryOpeningHours
      transitStation
      userRatingCount
      websiteUri

      Para obtener una lista completa de los campos y sus SKUs asociados, consulta Campos de datos de Place (nuevo).

    • Los siguientes campos activan el SKU de Place Details Enterprise + Atmosphere:

      allowsDogs
      curbsidePickup
      delivery
      dineIn
      editorialSummary
      evChargeAmenitySummary
      evChargeOptions
      fuelOptions
      generativeSummary
      goodForChildren
      goodForGroups
      goodForWatchingSports
      liveMusic
      menuForChildren
      neighborhoodSummary
      parkingOptions
      paymentOptions
      outdoorSeating
      reservable
      restroom
      reviews
      reviewSummary
      routingSummaries*
      servesBeer
      servesBreakfast
      servesBrunch
      servesCocktails
      servesCoffee
      servesDessert
      servesDinner
      servesLunch
      servesVegetarianFood
      servesWine
      takeout

      * Solo Text Search y Nearby Search

      Para obtener una lista completa de los campos y sus SKUs asociados, consulta Campos de datos de Place (nuevo).

  • placeId

    Es un identificador textual que identifica un lugar de forma exclusiva y que se devuelve desde una Text Search (nueva) o Nearby Search (nueva). Para obtener más información sobre los IDs de lugar, consulta la descripción general de los IDs de lugar.

    La cadena places/PLACE_ID también se denomina nombre del recurso del lugar. En la respuesta de una solicitud de Place Details (nuevo), Nearby Search (nuevo) y Text Search (nuevo), esta cadena se incluye en el campo name de la respuesta. El ID de lugar independiente se incluye en el campo id de la respuesta.

Parámetros opcionales

  • languageCode

    Es el idioma en el que se devolverán los resultados.

    • Consulta la lista de idiomas disponibles. Google suele actualizar los idiomas admitidos, por lo que es posible que esta lista no sea exhaustiva.
    • Si no se proporciona languageCode, la API se establece de forma predeterminada en en. Si especificas un código de idioma no válido, la API devolverá un error INVALID_ARGUMENT.
    • La API hace todo lo posible para proporcionar una dirección que sea legible tanto para el usuario como para los residentes locales. Para lograr ese objetivo, devuelve direcciones en el idioma local, transliteradas a una escritura legible por el usuario si es necesario, respetando el idioma preferido. Todas las demás direcciones se devuelven en el idioma preferido. Todos los componentes de la dirección se devuelven en el mismo idioma, que se elige a partir del primer componente.
    • Si no hay un nombre disponible en el idioma preferido, la API usa la coincidencia más cercana.
    • El idioma preferido tiene una pequeña influencia en el conjunto de resultados que la API elige mostrar y en el orden en que se muestran. El geocodificador interpreta las abreviaturas de manera diferente según el idioma, como las abreviaturas de los tipos de calles o los sinónimos que pueden ser válidos en un idioma, pero no en otro.

  • regionCode

    Es el código de región que se usa para dar formato a la respuesta, especificado como un valor de código CLDR de dos caracteres. No hay un valor predeterminado.

    Si el nombre del país del campo formattedAddress en la respuesta coincide con el regionCode, el código de país se omite de formattedAddress. Este parámetro no tiene efecto en adrFormatAddress, que siempre incluye el nombre del país, ni en shortFormattedAddress, que nunca lo incluye.

    La mayoría de los códigos CLDR son idénticos a los códigos ISO 3166-1, con algunas excepciones notables. Por ejemplo, el ccTLD del Reino Unido es "uk" (.co.uk), mientras que su código ISO 3166-1 es "gb" (técnicamente para la entidad "Reino Unido de Gran Bretaña e Irlanda del Norte"). El parámetro puede afectar los resultados según la legislación aplicable.

  • sessionToken

    Los tokens de sesión son cadenas generadas por el usuario que realizan un seguimiento de las llamadas de Autocomplete (nuevo) como "sesiones". Autocomplete (nuevo) usa tokens de sesión para agrupar las etapas de consulta y selección de lugares de la búsqueda con autocompletado de un usuario en una sesión discreta para realizar la facturación correspondiente. Los tokens de sesión se pasan a las llamadas a Place Details (nuevo) que siguen a las llamadas a Autocomplete (nuevo). Para obtener más información, consulta Tokens de sesión.

Ejemplo de Place Details (nuevo)

En el siguiente ejemplo, se solicitan los detalles de un lugar por placeId:

curl -X GET -H 'Content-Type: application/json' \
-H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: id,displayName" \
https://places.googleapis.com/v1/places/ChIJj61dQgK6j4AR4GeTYWZsKWw

Ten en cuenta que el encabezado X-Goog-FieldMask especifica que la respuesta contiene los siguientes campos de datos: id,displayName. La respuesta tiene el siguiente formato:

{
  "id": "ChIJj61dQgK6j4AR4GeTYWZsKWw",
  "displayName": {
    "text": "Googleplex",
    "languageCode": "en"
  }
}

Agrega más tipos de datos a la máscara de campo para devolver información adicional. Por ejemplo, agrega formattedAddress,plusCode para incluir la dirección y el Plus Code en la respuesta:

curl -X GET -H 'Content-Type: application/json' \
-H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: id,displayName,formattedAddress,plusCode" \
https://places.googleapis.com/v1/places/ChIJj61dQgK6j4AR4GeTYWZsKWw

La respuesta ahora tiene el siguiente formato:

{
  "id": "ChIJj61dQgK6j4AR4GeTYWZsKWw",
  "formattedAddress": "1600 Amphitheatre Pkwy, Mountain View, CA 94043, USA",
  "plusCode": {
    "globalCode": "849VCWC7+RW",
    "compoundCode": "CWC7+RW Mountain View, CA, USA"
  },
  "displayName": {
    "text": "Googleplex",
    "languageCode": "en"
  }
}

Obtén calificaciones, recuentos de opiniones y opiniones

Para recuperar la calificación por estrellas promedio de una empresa, la cantidad total de calificaciones (total de opiniones) o el texto de las opiniones de los clientes, incluye los campos correspondientes en el encabezado X-Goog-FieldMask:

Si tu app solo necesita la calificación por estrellas y el recuento total de opiniones, solicita rating y userRatingCount sin reviews para que la solicitud permanezca en el nivel de SKU de Place Details Enterprise:

curl -X GET -H 'Content-Type: application/json' \
-H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: id,displayName,rating,userRatingCount" \
https://places.googleapis.com/v1/places/ChIJj61dQgK6j4AR4GeTYWZsKWw

Para recuperar también hasta cinco objetos Review enviados por los usuarios, agrega reviews a la máscara de campo (se factura según el nivel de SKU de Place Details Enterprise + Atmosphere):

curl -X GET -H 'Content-Type: application/json' \
-H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: id,displayName,rating,userRatingCount,reviews" \
https://places.googleapis.com/v1/places/ChIJj61dQgK6j4AR4GeTYWZsKWw

La respuesta incluye la calificación, el recuento total de calificaciones y el array reviews:

{
  "id": "ChIJj61dQgK6j4AR4GeTYWZsKWw",
  "displayName": {
    "text": "Googleplex",
    "languageCode": "en"
  },
  "rating": 4.2,
  "userRatingCount": 2594,
  "reviews": [
    {
      "name": "places/ChIJj61dQgK6j4AR4GeTYWZsKWw/reviews/...",
      "relativePublishTimeDescription": "a month ago",
      "rating": 5,
      "text": {
        "text": "Iconic tech campus with visitor areas and cafes.",
        "languageCode": "en"
      },
      "authorAttribution": {
        "displayName": "Alex Rivera"
      }
    }
  ]
}

Obtén descriptores de direcciones

Los descriptores de direcciones proporcionan información relacional sobre la ubicación de un lugar, incluidos los puntos de referencia cercanos y las áreas que lo contienen.

En el siguiente ejemplo, se muestra una solicitud de Place Details (nuevo) para una tienda por departamentos en un centro comercial de San José. En este ejemplo, incluyes addressDescriptors en la máscara de campo:

  curl -X GET https://places.googleapis.com/v1/places/ChIJ8WvuSB7Lj4ARFyHppkxDRQ4 \
  -H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
  -H "X-Goog-FieldMask: name,displayName,addressDescriptor"

La respuesta incluye el lugar especificado en la solicitud, una lista de puntos de referencia cercanos y su distancia con respecto al lugar, y una lista de áreas y su relación de contención con el lugar:

  {
    "name": "places/ChIJ8WvuSB7Lj4ARFyHppkxDRQ4",
    "displayName": {
      "text": "Macy's",
      "languageCode": "en"
    },
    "addressDescriptor": {
      "landmarks": [
        {
          "name": "places/ChIJVVVVUB7Lj4ARXyb4HFVDV8s",
          "placeId": "ChIJVVVVUB7Lj4ARXyb4HFVDV8s",
          "displayName": {
            "text": "Westfield Valley Fair",
            "languageCode": "en"
          },
          "types": [
            "clothing_store",
            "department_store",
            "establishment",
            "food",
            "movie_theater",
            "point_of_interest",
            "restaurant",
            "shoe_store",
            "shopping_mall",
            "store"
          ],
          "spatialRelationship": "WITHIN",
          "straightLineDistanceMeters": 220.29175
        },
        {
          "name": "places/ChIJ62_oCR7Lj4AR_MGWkSPotD4",
          "placeId": "ChIJ62_oCR7Lj4AR_MGWkSPotD4",
          "displayName": {
            "text": "Nordstrom",
            "languageCode": "en"
          },
          "types": [
            "clothing_store",
            "department_store",
            "establishment",
            "point_of_interest",
            "shoe_store",
            "store"
          ],
          "straightLineDistanceMeters": 329.45178
        },
        {
          "name": "places/ChIJmx1c5x7Lj4ARJXJy_CU_JbE",
          "placeId": "ChIJmx1c5x7Lj4ARJXJy_CU_JbE",
          "displayName": {
            "text": "Monroe Parking Garage",
            "languageCode": "en"
          },
          "types": [
            "establishment",
            "parking",
            "point_of_interest"
          ],
          "straightLineDistanceMeters": 227.05153
        },
        {
          "name": "places/ChIJxcwBziHLj4ARUQLAvtzkRCM",
          "placeId": "ChIJxcwBziHLj4ARUQLAvtzkRCM",
          "displayName": {
            "text": "Studios Inn by Daiwa Living California Inc.",
            "languageCode": "en"
          },
          "types": [
            "establishment",
            "lodging",
            "point_of_interest",
            "real_estate_agency"
          ],
          "straightLineDistanceMeters": 299.9955
        },
        {
          "name": "places/ChIJWWIlNx7Lj4ARpe1E0ob-_GI",
          "placeId": "ChIJWWIlNx7Lj4ARpe1E0ob-_GI",
          "displayName": {
            "text": "Din Tai Fung",
            "languageCode": "en"
          },
          "types": [
            "establishment",
            "food",
            "point_of_interest",
            "restaurant"
          ],
          "straightLineDistanceMeters": 157.70943
        }
      ],
      "areas": [
        {
          "name": "places/ChIJb3F-EB7Lj4ARnHApQ_Hu1gI",
          "placeId": "ChIJb3F-EB7Lj4ARnHApQ_Hu1gI",
          "displayName": {
            "text": "Westfield Valley Fair",
            "languageCode": "en"
          },
          "containment": "WITHIN"
        },
        {
          "name": "places/ChIJXYuykB_Lj4AR1Ot8nU5q26Q",
          "placeId": "ChIJXYuykB_Lj4AR1Ot8nU5q26Q",
          "displayName": {
            "text": "Valley Fair",
            "languageCode": "en"
          },
          "containment": "WITHIN"
        },
        {
          "name": "places/ChIJtYoUX2DLj4ARKoKOb1G0CpM",
          "placeId": "ChIJtYoUX2DLj4ARKoKOb1G0CpM",
          "displayName": {
            "text": "Central San Jose",
            "languageCode": "en"
          },
          "containment": "WITHIN"
        }
      ]
    }
  }

Cómo obtener detalles de un lugar que se trasladó

Si un lugar al que se hace referencia en tu app se reubicó, puedes usar los campos movedPlace y movedPlaceId para obtener los detalles del lugar nuevo.

En el caso de los lugares que están cerrados permanentemente, Place Details (nuevo) devuelve CLOSED_PERMANENTLY en el campo businessStatus y omite los campos movedPlace y movedPlaceId en el cuerpo de la respuesta.

En el caso de los lugares que se trasladaron a una ubicación nueva, Place Details (nuevo) devuelve CLOSED_PERMANENTLY en el campo businessStatus y la ubicación nueva en los campos movedPlace y movedPlaceId del cuerpo de la respuesta.

En el caso de los lugares que no se trasladaron, Place Details (nuevo) no devuelve movedPlace ni movedPlaceId en el cuerpo de la respuesta.

En el siguiente ejemplo, se solicita información sobre el lugar Marche IGA St-Canut en Quebec, Canadá:

curl -X  GET -H 'Content-Type: application/json' \
-H 'x-Goog-Api-Key: API_KEY' \
-H 'X-Goog-FieldMask: id,displayName,businessStatus,movedPlace,movedPlaceId' \
https://places.googleapis.com/v1/places/ChIJUfQdGInVzkwRzAjmjzWB7CQ

La solicitud devuelve la siguiente respuesta:

{
  "id": "ChIJUfQdGInVzkwRzAjmjzWB7CQ",
  "businessStatus": "CLOSED_PERMANENTLY",
  "displayName": {
    "text": "Marche IGA St-Canut",
    "languageCode": "en"
  },
  "movedPlace": "places/ChIJ36QT7n8qz0wRDqVZ_UBlUlQ",
  "movedPlaceId": "ChIJ36QT7n8qz0wRDqVZ_UBlUlQ"
}

Para solicitar detalles sobre el lugar nuevo, usa el nombre del recurso Place en el campo movedPlace en una nueva solicitud de Place Details (nuevo).

En el caso de los lugares que se reubicaron varias veces, es posible que se deban realizar varias solicitudes de Place Details (nuevo) encadenadas para obtener detalles sobre la ubicación actual. Los campos movedPlace y movedPlaceId de un resultado de lugar solo apuntan a la siguiente ubicación, no a la última ubicación conocida. Un lugar se encuentra en su ubicación actual si una solicitud de Place Details (nuevo) omite los campos movedPlace y movedPlaceId en el cuerpo de la respuesta.

Cómo encontrar empresas que abrirán en el futuro

Puedes solicitar detalles sobre las empresas que se espera que abran en el futuro. Nearby Search (nuevo) propagará el campo openingDate si la fecha de apertura prevista incluye, al menos, el mes y faltan menos de 90 días para que se cumpla.

En el siguiente ejemplo, se muestra una solicitud de Nearby Search (nuevo) para una empresa que abrirá en el futuro en New Meadows, Idaho:

curl -X GET \
-H "Content-Type: application/json" \
-H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: id,businessStatus,openingDate" \
"https://places.googleapis.com/v1/places/ChIJp1-VoKWJplQRMz8g-7Wa3Do"

La respuesta incluye el estado de la empresa y la fecha de apertura prevista:

{
  "id": "ChIJp1-VoKWJplQRMz8g-7Wa3Do",
  "businessStatus": "FUTURE_OPENING",
  "openingDate": {
    "year": 2026,
    "month": 4,
    "day": 15
  }
}

Cómo obtener información sobre las estaciones de transporte público

Puedes usar Place Details (nuevo) para obtener información sobre las estaciones de transporte público. El cuerpo de la respuesta incluye información sobre la estación, como su nombre, las empresas de transporte público afiliadas y las líneas de transporte público que prestan servicio en ella. Además, la respuesta incluye un ícono de vehículo y colores que puedes usar para mostrar la información de la estación de transporte público.

En el siguiente ejemplo, se muestra una solicitud de información sobre la estación de transporte público Grand Central Station:

curl -X GET \
-H "Content-Type: application/json" \
-H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: id,displayName,transitStation" \
"https://places.googleapis.com/v1/places/ChIJLVaKiQFZwokRgcybX3K6Pzg"

El cuerpo de la respuesta incluye información sobre cada estación dentro del radio, las líneas que pasan por la estación, las alertas emitidas por las empresas de transporte público en esa parada y la información de salida:

  {
  "id": "ChIJLVaKiQFZwokRgcybX3K6Pzg",
  "displayName": {
    "text": "Grand Central",
    "languageCode": "en"
  },
  "transitStation": {
    "displayName": {
      "text": "Grand Central",
      "languageCode": "en"
    },
    "agencies": [
      {
        "displayName": {
          "text": "MTA New York City Transit",
          "languageCode": "en"
        },
        "url": "http://www.mta.info/",
        "lines": [
          {
            "id": "ChIJ420yFwBZwokR903kVZLSsFc",
            "vehicleType": "SUBWAY",
            "displayName": {
              "text": "42 St Shuttle",
              "languageCode": "en"
            },
            "shortDisplayName": {
              "text": "S",
              "languageCode": "en"
            },
            "textColor": "#FFFFFF",
            "backgroundColor": "#808183",
            "url": "https://www.mta.info/schedules/subway/42-st-shuttle",
            "icon": {
              "url": "https://maps.gstatic.com/mapfiles/transit/iw2/svg/us-ny-mta/S.svg",
              "nameIncluded": true
            },
            "vehicleIcon": {
              "url": "https://maps.gstatic.com/mapfiles/transit/iw2/svg/subway2.svg"
            }
          },
          {
            "id": "ChIJDdd_uEdfwokRHbLvWrdBdDM",
            "vehicleType": "SUBWAY",
            "displayName": {
              "text": "5 Train (Lexington Av Express)",
              "languageCode": "en"
            },
            "shortDisplayName": {
              "text": "5 Line",
              "languageCode": "en"
            },
            "textColor": "#FFFFFF",
            "backgroundColor": "#00933C",
            "url": "https://www.mta.info/schedules/subway/5-train",
            "icon": {
              "url": "https://maps.gstatic.com/mapfiles/transit/iw2/svg/us-ny-mta/5.svg",
              "nameIncluded": true
            },
            "vehicleIcon": {
              "url": "https://maps.gstatic.com/mapfiles/transit/iw2/svg/subway2.svg"
            }
          }
          ...
        ]
      },
      {
        "displayName": {
          "text": "MTA",
          "languageCode": "en"
        },
        "url": "https://new.mta.info/",
        "lines": [
          {
            "id": "ChIJcwVpzKpZwokR24EBeh8arww",
            "vehicleType": "BUS",
            "displayName": {
              "text": "United Nations - W 42 St Pier",
              "languageCode": "en"
            },
            "shortDisplayName": {
              "text": "M42",
              "languageCode": "en"
            },
            "textColor": "#FFFFFF",
            "backgroundColor": "#1D59B3",
            "vehicleIcon": {
              "url": "https://maps.gstatic.com/mapfiles/transit/iw2/svg/bus2.svg"
            }
          }
        ]
      },
      {
        "displayName": {
          "text": "Long Island Rail Road",
          "languageCode": "en"
        },
        "url": "http://www.mta.info/lirr",
        "lines": [
          {
            "id": "ChIJv9m8uWM56IkRUcVBQ6Q_In0",
            "vehicleType": "HEAVY_RAIL",
            "displayName": {
              "text": "Ronkonkoma Branch",
              "languageCode": "en"
            },
            "shortDisplayName": {
              "text": "LIRR",
              "languageCode": "en"
            },
            "textColor": "#FFFFFF",
            "backgroundColor": "#A626AA",
            "vehicleIcon": {
              "url": "https://maps.gstatic.com/mapfiles/transit/iw2/svg/rail2.svg"
            }
          }
          ...
        ]
      }
    ],
    "stops": [
      {
        "id": "ChIJRcemlf1YwokRhFqqw5jKBFM",
        "stopCode": {
          "text": "GCT"
        },
        "location": {
          "latitude": 40.755161,
          "longitude": -73.975456
        },
        "wheelchairAccessibleEntrance": true
      },
      {
        "id": "ChIJ57l2zANZwokRD1pyhuwpfKY",
        "signageText": {
          "text": "34 St-Hudson Yards & Main St-Flushing, Queens, 7",
          "languageCode": "en"
        },
        "location": {
          "latitude": 40.750983,
          "longitude": -73.9750686
        },
        "wheelchairAccessibleEntrance": true
      },
      {
        "id": "ChIJoVXJgQFZwokR1yzq_WVuEuc",
        "displayName": {
          "text": "E 42 St/Park Av",
          "languageCode": "en"
        },
        "location": {
          "latitude": 40.7518199,
          "longitude": -73.9771918
        },
        "wheelchairAccessibleEntrance": true
      }
      ...
    ]
  }
}

Obtén entradas y puntos de navegación

Puedes solicitar entradas y puntos de navegación para un destino. Las entradas definen los puntos de entrada y salida de un lugar (por ejemplo, las diferentes puertas de un aeropuerto o centro comercial). Los puntos de navegación definen ubicaciones al costado de la ruta donde debe finalizar la navegación, lo que es útil para dirigir a los usuarios al lado correcto de la ruta o a un punto de llegada específico.

Los puntos de navegación devuelven un objeto navigationPointToken. Puedes pasar este token al SDK de Navigation (disponible para Android o iOS) o a la API de Routes para guiar a los conductores a esa ubicación específica. Para obtener más información, consulta Tokens de puntos de navegación.

En el siguiente ejemplo, se solicitan detalles del Aeropuerto Internacional de San Francisco (ID de lugar ChIJVVVVVYx3j4ARP-3NGldc8qQ), incluidos entrances y navigationPoints en la máscara de campo:

curl -X GET -H 'Content-Type: application/json' \
-H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: id,displayName,entrances,navigationPoints" \
https://places.googleapis.com/v1/places/ChIJVVVVVYx3j4ARP-3NGldc8qQ

La respuesta incluye las entradas y los puntos de navegación del lugar:

{
  "id": "ChIJVVVVVYx3j4ARP-3NGldc8qQ",
  "displayName": {
    "text": "San Francisco International Airport",
    "languageCode": "en"
  },
  "entrances": [
    {
      "location": {
        "latitude": 37.6172154,
        "longitude": -122.3839724
      }
    },
    {
      "location": {
        "latitude": 37.6174073,
        "longitude": -122.384196
      }
    },
    ...
  ],
  "navigationPoints": [
    {
      "navigationPointToken": "ChIJoioBjMLOQkAR0A3yH_eYXsA...",
      "displayName": {
        "text": "International Terminal Departures Level",
        "languageCode": "en"
      },
      "location": {
        "latitude": 37.6153121,
        "longitude": -122.3900833
      },
      "travelModes": ["WALK"]
    },
    {
      "navigationPointToken": "ChIJy5JKws_OQkAROx0jNN2YXsA...",
      "displayName": {
        "text": "Domestic Garage - SFO Short Term Parking",
        "languageCode": "en"
      },
      "location": {
        "latitude": 37.6157153,
        "longitude": -122.3885012
      },
      "travelModes": ["DRIVE", "WALK"],
      "usages": ["PARKING"]
    },
    ...
  ]
}

Pruébalo

El Explorador de APIs te permite realizar solicitudes de ejemplo para que puedas familiarizarte con la API y sus opciones.

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

  2. De manera opcional, edita los parámetros de solicitud.

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

  4. En el panel del Explorador de APIs, selecciona el ícono de pantalla completa fullscreen para expandir la ventana del Explorador de APIs.