Place Details (nuevo)

Una vez que tengas un ID de lugar, podrás solicitar más detalles sobre un establecimiento o lugar de interés al iniciar un Place Details (nuevo) para cada solicitud. A Place Details (nuevo) request 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 maneras de obtener un ID de lugar. Puedes usar:

• Text Search (nueva) o Nearby Search (nuevo)
• API de Geocoding
• API de Routes
• API de Address Validation
• Place Autocomplete

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

Pruébalo

Solicitudes de Place Details (nuevo)

Una solicitud de Place Details es una solicitud HTTP GET que tiene el siguiente formato:

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

Pasar todos los parámetros como parámetros de URL o en encabezados como parte del 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) muestra un un objeto JSON como respuesta. En la respuesta, figura lo siguiente:

• La respuesta se representa con un Place . El objeto Place contiene información detallada sobre el en un lugar específico.
• La FieldMask pasada en la solicitud especifica la lista de campos. que se muestra 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 deben mostrar en la respuesta creando un 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 mediante el encabezado HTTP X-Goog-FieldMask No hay una lista predeterminada de los campos mostrados en la respuesta. Si omites la máscara de campo, el método mostrará un error.

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

  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 (solo IDs):

    attributions, id, name^*: photos
    
    ^* El campo name contiene el nombre del recurso del lugar. en el formato places/PLACE_ID. Utiliza displayName para acceder al nombre del lugar en forma de texto.

  • Los siguientes campos activan el SKU de Place Details (solo ubicación):

    addressComponents, adrFormatAddress, formattedAddress, location, plusCode, shortFormattedAddress, types, viewport

  • Los siguientes campos activan el SKU de Place Details (Basic):

    accessibilityOptions, businessStatus, displayName, googleMapsUri, iconBackgroundColor, iconMaskBaseUri, primaryType, primaryTypeDisplayName, subDestinations, utcOffsetMinutes

  • Los siguientes campos activan el SKU de Place Details (Advanced):

    currentOpeningHours, currentSecondaryOpeningHours, internationalPhoneNumber, nationalPhoneNumber, priceLevel, rating, regularOpeningHours, regularSecondaryOpeningHours, userRatingCount, websiteUri

  • Los siguientes campos activan el SKU de Place Details (Preferred):

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

• placeId

  un identificador textual que identifica un sitio de forma exclusiva, obtenido de un Text Search (nueva) o Nearby Search (nuevo). 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 llama lugar nombre de recurso. En la respuesta de una solicitud de Place Details (nuevo), Nearby Search (nueva) y Text Search (nueva) solicitud, esta cadena se encuentra en el campo name de la respuesta. El kit de herramientas El ID de lugar se encuentra en el campo id de la respuesta.

Parámetros opcionales

• languageCode

  El idioma en el que se mostrarán los resultados.

  • Consulta la lista de idiomas compatibles. Google actualiza con frecuencia 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 si especificas un código de idioma no válido, la API mostrará un error INVALID_ARGUMENT.
  • La API hace todo lo posible para proporcionar una dirección que sea legible para tanto el usuario como los locales. Para lograr ese objetivo, devuelve en el idioma local, transliteradas a un script legible por al usuario, si es necesario, y respetando el idioma preferido. Todos los demás las direcciones se devuelven en el idioma preferido. Los componentes de la dirección son todas se devuelven en el mismo idioma, que se elige de la primera este componente.
  • Si un nombre no está disponible en el idioma preferido, la API usa el coincidencia más cercana.
  • El idioma preferido influye poco en el conjunto de resultados que que la API elige devolver y el orden en el que se muestran. El el geocodificador interpreta las abreviaturas de manera diferente según el lenguaje, como las abreviaturas para los tipos de calle, o los sinónimos que pueden válido en un idioma, pero no en otro.

• regionCode

  El código de región que se usa para dar formato a la respuesta, especificado como una 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 país. nombre o 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 el código ISO 3166-1 es "gb" (técnicamente para el del "Reino Unido de Gran Bretaña e Irlanda del Norte"). El parámetro puede afectar los resultados según la ley aplicable.

• sessionToken

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

Ejemplo de Place Details

En el siguiente ejemplo, se solicitan los detalles de un sitio mediante 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 el respuesta contiene los siguientes campos de datos: id,displayName. Entonces, la respuesta tendrá el siguiente formato:

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

Agrega más tipos de datos a la máscara de campo para mostrar información adicional. Por ejemplo, agrega formattedAddress,plusCode para incluir el 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"
  }
}

Pruébalo

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

Para realizar una solicitud, haz lo siguiente:

1. Selecciona el ícono de la API, , en el lado derecho de la página.
2. De manera opcional, establece el parámetro name de la siguiente manera:

   places/PLACE_ID

3. De manera opcional, expande Mostrar parámetros estándar y establece el parámetro fields a la máscara de campo.
4. Selecciona el botón Ejecutar. En la ventana emergente, elige la cuenta a la que deseas acceder. usar para realizar la solicitud.

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