Eso es todo.

Para comenzar a desarrollar, consulta nuestra documentación para desarrolladores.

Activar el Google Places API Web Service

Para que puedas comenzar, te proporcionaremos orientación en la consola para desarrolladores de Google a fin de que hagas primero algunas acciones:

  1. Crear o seleccionar un proyecto
  2. Activar el Google Places API Web Service
  3. Crear claves correspondientes
Continuar

Detalles del sitio

Una vez que tengas un valor de place_id o reference obtenidos a partir de una búsqueda de sitios, puedes solicitar más detalles acerca de un establecimiento o punto de interés determinado al iniciar una solicitud de detalles del sitio. Una solicitud de detalles del sitio devuelve información más exhaustiva acerca del sitio indicado, como su dirección completa, el número de teléfono, la calificación de usuarios y reseñas.

Solicitudes de detalles del sitio

Una solicitud de detalles del sitio es una HTTP URL como la siguiente:

https://maps.googleapis.com/maps/api/place/details/output?parameters

donde output puede ser cualquiera de los siguientes valores:

  • json (recomendado) indica el formato de salida en JavaScript Object Notation (JSON).
  • xml indica el formato de salida como XML.

Ciertos parámetros son obligatorios para iniciar una solicitud de búsqueda. Como es norma en las direcciones URL, todos los parámetros se separan con el carácter de Y comercial (&). A continuación se proporciona una lista de los parámetros y sus posibles valores.

  • key (obligatorio): la clave de API de tu aplicación. Esta clave identifica tu aplicación para la administración de la cuota, de modo que los sitios agregados desde tu aplicación estén inmediatamente disponibles en ella. Para obtener más información, consulta Obtener una clave.
  • placeid o reference (debes proporcionar uno de estos parámetros, pero no ambos):
Parámetros opcionales
  • extensions (opcional): indica si la respuesta de detalles del sitio debe incluir campos adicionales. Los campos adicionales pueden incluir datos premium que requieren una licencia adicional o valores que comúnmente no se solicitan. Actualmente, las extensiones son experimentales. Los valores admitidos para el parámetro extensions son los siguientes:
    • review_summary incluye una reseña completa y concisa administrada por el personal editorial de Google.
  • language (opcional): el código de idioma, que indica en qué idioma se deben devolver los resultados si fuera posible. Ten en cuenta que es posible que algunos campos no estén disponibles en el idioma solicitado. Consulta la lista de idiomas admitidos y sus códigos. Ten en cuenta que, a menudo, actualizamos los idiomas admitidos, por lo que es posible que esta lista no esté completa.

El siguiente ejemplo solicita los detalles de un sitio por placeid:

https://maps.googleapis.com/maps/api/place/details/json?placeid=ChIJN1t_tDeuEmsRUsoyG83frY4&key=YOUR_API_KEY

Para que la solicitud funcione en tu aplicación, deberás reemplazar la clave que se indica en este ejemplo por tu clave de API.

El siguiente ejemplo utiliza el parámetro en desuso reference:

https://maps.googleapis.com/maps/api/place/details/json?reference=CmRYAAAAciqGsTRX1mXRvuXSH2ErwW-jCINE1aLiwP64MCWDN5vkXvXoQGPKldMfmdGyqWSpm7BEYCgDm-iv7Kc2PF7QA7brMAwBbAcqMr5i1f4PwTpaovIZjysCEZTry8Ez30wpEhCNCXpynextCld2EBsDkRKsGhSLayuRyFsex6JA6NPh9dyupoTH3g&key=YOUR_API_KEY

Respuestas de detalles del sitio

Las respuestas de detalles del sitio se devuelven en el formato indicado por el marcador output en la ruta de acceso de la dirección URL de la solicitud.


JSON
{
   "html_attributions" : [],
   "result" : {
      "address_components" : [
         {
            "long_name" : "48",
            "short_name" : "48",
            "types" : [ "street_number" ]
         },
         {
            "long_name" : "Pirrama Road",
            "short_name" : "Pirrama Road",
            "types" : [ "route" ]
         },
         {
            "long_name" : "Pyrmont",
            "short_name" : "Pyrmont",
            "types" : [ "locality", "political" ]
         },
         {
            "long_name" : "NSW",
            "short_name" : "NSW",
            "types" : [ "administrative_area_level_1", "political" ]
         },
         {
            "long_name" : "AU",
            "short_name" : "AU",
            "types" : [ "country", "political" ]
         },
         {
            "long_name" : "2009",
            "short_name" : "2009",
            "types" : [ "postal_code" ]
         }
      ],
      "formatted_address" : "48 Pirrama Road, Pyrmont NSW, Australia",
      "formatted_phone_number" : "(02) 9374 4000",
      "geometry" : {
         "location" : {
           "lat" : -33.8669710,
           "lng" : 151.1958750
         },
         "viewport" : {
            "northeast" : {
               "lat" : -33.8665053,
               "lng" : 151.1960371
            },
            "southwest" : {
               "lat" : -33.8669293,
               "lng" : 151.1952183
            }
         }
      },
      "icon" : "http://maps.gstatic.com/mapfiles/place_api/icons/generic_business-71.png",
      "id" : "4f89212bf76dde31f092cfc14d7506555d85b5c7",
      "international_phone_number" : "+61 2 9374 4000",
      "name" : "Google Sydney",
      "place_id" : "ChIJN1t_tDeuEmsRUsoyG83frY4",
      "scope" : "GOOGLE",
      "alt_ids" : [
         {
            "place_id" : "D9iJyWEHuEmuEmsRm9hTkapTCrk",
            "scope" : "APP"
         }
      ],
      "rating" : 4.70,
      "reference" : "CnRsAAAA98C4wD-VFvzGq-KHVEFhlHuy1TD1W6UYZw7KjuvfVsKMRZkbCVBVDxXFOOCM108n9PuJMJxeAxix3WB6B16c1p2bY1ZQyOrcu1d9247xQhUmPgYjN37JMo5QBsWipTsnoIZA9yAzA-0pnxFM6yAcDhIQbU0z05f3xD3m9NQnhEDjvBoUw-BdcocVpXzKFcnMXUpf-nkyF1w",
      "reviews" : [
         {
            "aspects" : [
               {
                  "rating" : 3,
                  "type" : "quality"
               }
            ],
            "author_name" : "Simon Bengtsson",
            "author_url" : "https://plus.google.com/104675092887960962573",
            "language" : "en",
            "rating" : 5,
            "text" : "Just went inside to have a look at Google. Amazing.",
            "time" : 1338440552869
         },
         {
           "aspects" : [
              {
                 "rating" : 3,
                 "type" : "quality"
              }
             ],
            "author_name" : "Felix Rauch Valenti",
            "author_url" : "https://plus.google.com/103291556674373289857",
            "language" : "en",
            "rating" : 5,
            "text" : "Best place to work :-)",
            "time" : 1338411244325
         },
         {
           "aspects" : [
              {
                 "rating" : 3,
                 "type" : "quality"
              }
             ],
            "author_name" : "Chris",
            "language" : "en",
            "rating" : 5,
            "text" : "Great place to work, always lots of free food!",
            "time" : 1330467089039
         }
      ],
      "types" : [ "establishment" ],
      "url" : "http://maps.google.com/maps/place?cid=10281119596374313554",
      "vicinity" : "48 Pirrama Road, Pyrmont",
      "website" : "http://www.google.com.au/"
   },
   "status" : "OK"
}
      
XML

<?xml version="1.0" encoding="UTF-8"?>
<PlaceDetailsResponse>
 <status>OK</status>
 <result>
  <name>Google Sydney</name>
  <vicinity>48 Pirrama Road, Pyrmont</vicinity>
  <type>establishment</type>
  <formatted_phone_number>(02) 9374 4000</formatted_phone_number>
  <formatted_address>48 Pirrama Road, Pyrmont NSW, Australia</formatted_address>
  <address_component>
   <long_name>48</long_name>
   <short_name>48</short_name>
   <type>street_number</type>
  </address_component>
  <address_component>
   <long_name>Pirrama Road</long_name>
   <short_name>Pirrama Road</short_name>
   <type>route</type>
  </address_component>
  <address_component>
   <long_name>Pyrmont</long_name>
   <short_name>Pyrmont</short_name>
   <type>locality</type>
   <type>political</type>
  </address_component>
  <address_component>
   <long_name>NSW</long_name>
   <short_name>NSW</short_name>
   <type>administrative_area_level_1</type>
   <type>political</type>
  </address_component>
  <address_component>
   <long_name>AU</long_name>
   <short_name>AU</short_name>
   <type>country</type>
   <type>political</type>
  </address_component>
  <address_component>
   <long_name>2009</long_name>
   <short_name>2009</short_name>
   <type>postal_code</type>
  </address_component>
  <geometry>
   <location>
     <lat>-33.8669710</lat>
     <lng>151.1958750</lng>
   </location>
   <viewport>
    <southwest>
     <lat>-33.8669293</lat>
     <lng>151.1952183</lng>
    </southwest>
    <northeast>
     <lat>-33.8665053</lat>
     <lng>151.1960371</lng>
    </northeast>
   </viewport>
  </geometry>
  <rating>4.7</rating>
  <url>http://maps.google.com/maps/place?cid=10281119596374313554</url>
  <icon>http://maps.gstatic.com/mapfiles/place_api/icons/generic_business-71.png</icon>
  <place_id>ChIJN1t_tDeuEmsRUsoyG83frY4</place_id>
  <scope>GOOGLE</scope>
  <alt_ids>
   <place_id>D9iJyWEHuEmuEmsRm9hTkapTCrk</place_id>
   <scope>APP</scope>
  </alt_ids>
  <reference>CnRsAAAAoGXc0eAcQOoO1A7sU58repRnghwM5q7UtsZFhVtjYtfKN_LFAPhdhBfUAU8m0EzeSyP0cDBi7kazZwNjlIMUqktqIanMiymuRDS8c539M6KCJNUMkjw22WXxtl3QoR25fIf-7YJnpza6bMIuFZ1CKBIQuBsbXu8xkbUNofECCkdvmxoU5k3Lpbr8XNCbofIKtsZxj8GloGA</reference>
  <id>4f89212bf76dde31f092cfc14d7506555d85b5c7</id>
  <international_phone_number>+61 2 9374 4000</international_phone_number>
  <website>http://www.google.com.au/</website>
  <review>
   <time>1338440552869</time>
   <text>Just went inside to have a look at Google. Amazing.</text>
   <author_name>Simon Bengtsson</author_name>
   <author_url>https://plus.google.com/104675092887960962573</author_url>
   <language>en</language>
   <rating>5</rating>
   <aspect>
     <type>quality</type>
     <rating>3</rating>
   </aspect>
  </review>
  <review>
   <time>1338411244325</time>
   <text>Best place to work :-)</text>
   <author_name>Felix Rauch Valenti</author_name>
   <author_url>https://plus.google.com/103291556674373289857</author_url>
   <language>en</language>
   <rating>5</rating>
   <aspect>
     <type>quality</type>
     <rating>3</rating>
   </aspect>
  </review>
  <review>
   <time>1330467089039</time>
   <text>Great place to work, always lots of free food!</text>
   <author_name>Chris</author_name>
   <author_url>https://maps.google.com/maps/user?uid=211457841236072500285</author_url>
   <language>en</language>
   <rating>5</rating>
   <aspect>
     <type>quality</type>
     <rating>3</rating>
   </aspect>
  </review>
 </result>
</PlaceDetailsResponse>

Una respuesta JSON contiene tres elementos principales:

  • "status" contiene metadatos sobre la solicitud. Consulta los siguientes códigos de estado.
  • "result" contiene información detallada acerca del sitio solicitado. Consulta Resultados de los detalles del sitio para obtener información acerca de esos resultados.
  • "html_attributions" contiene un conjunto de atribuciones acerca de esta lista, que deben mostrarse al usuario.

Consulta Procesamiento de JSON con Javascript para obtener ayuda sobre el procesamiento de respuestas JSON.

Una respuesta XML consiste en una sola <PlaceDetailsResponse> y tres elementos de nivel superior:

  • <status> contiene metadatos sobre la solicitud. Consulta los códigos de estado.
  • Un elemento <result> único que contiene información detallada acerca de un solo establecimiento. Consulta Resultados de los detalles del sitio para obtener información acerca de esos resultados.
  • html_attributions contiene un conjunto de atribuciones que se le deben mostrar al usuario.

Consulta Análisis de XML con XPath para obtener información sobre algunos de los patrones de diseño recomendados para el procesamiento del formato de salida.

Códigos de estado

El campo "status" en el objeto de la respuesta del sitio contiene el estado de la solicitud y podría contener información de depuración para ayudarte a localizar por qué falló la solicitud del sitio. El campo "status" puede contener los siguientes valores:

  • OK indica que no se produjeron errores, que el sitio se detectó satisfactoriamente y que se devolvió, al menos, un resultado.
  • UNKNOWN_ERROR indica un error del servidor; puedes tener éxito al intentarlo nuevamente.
  • ZERO_RESULTS indica que la referencia fue válida, pero ya no remite a un resultado válido. Esto puede ocurrir si el establecimiento ya no está en actividad.
  • OVER_QUERY_LIMIT indica que has excedido tu cuota.
  • REQUEST_DENIED indica que se rechazó tu solicitud, generalmente, debido a un parámetro key no válido.
  • INVALID_REQUEST generalmente indica que falta la consulta (reference).
  • NOT_FOUND indica que no se encontró la ubicación indicada en la base de datos de Places.

Mensajes de error

Cuando el servicio de Google Places devuelve un código de estado diferente de OK, podría haber un campo error_message adicional en el objeto de la respuesta de detalles. Este campo contiene información más detallada acerca de los motivos que subyacen al código de estado proporcionado.

Resultados de detalles del sitio

Cuando el servicio de Places devuelve resultados a partir de una solicitud de detalles, los ubica en un mismo parámetro result. Cada resultado puede contener los siguientes campos:

  • address_components[] es un conjunto de componentes de dirección independientes que se utilizan para componer una dirección determinada. Por ejemplo, la dirección "111 8th Avenue, New York, NY" contiene componentes de dirección independientes para "111" (el número en la calle), "8th Avenue" (la calle), "New York" (la ciudad) y "NY" (el estado de los EE. UU.). Cada address_component generalmente contiene:
    • types[] es una matriz que indica el tipo de componente de la dirección.
    • long_name es la descripción textual o el nombre completo del componente de la dirección.
    • short_name es un nombre textual abreviado para el componente de dirección, si estuviera disponible. Por ejemplo, un componente de dirección para el estado de Alaska podría tener un valor long_name "Alaska" y un valor short_name "AK" para el que se usa la abreviatura postal de dos letras.
  • formatted_address es una cadena que contiene la dirección del sitio en lenguaje natural. A menudo, esa dirección equivale a la "dirección postal" que suele diferir según el país. Esta dirección generalmente está compuesta por uno o más campos address_component.
  • formatted_phone_number contiene el número de teléfono del sitio en su formato local. Por ejemplo, el formatted_phone_number de la oficina de Google en Sídney, Australia, es (02) 9374 4000.
  • geometry contiene la siguiente información:
    • location contiene los valores de latitud y longitud codificados geográficamente para el sitio.
    • viewport contiene la ventana de visualización preferida cuando se muestra este sitio en un mapa como LatLngBounds si es conocido.
  • icon contiene la dirección URL de un ícono sugerido que puede mostrarse al usuario al indicar este resultado en un mapa.
  • id contiene un identificador estable y único que designa el sitio. Este identificador no se puede usar para recuperar información acerca del sitio, pero sí para consolidar datos acerca del sitio y verificar la identidad de un sitio entre búsquedas independientes. Dado que los id. pueden cambiar ocasionalmente, se recomienda comparar el id. guardado para un sitio con el id. devuelto en las solicitudes de detalles posteriores para el mismo sitio, y actualizarlo si fuera necesario. Nota: id ha quedado en desuso en favor de place_id. Consulta el aviso sobre desuso en esta página.
  • international_phone_number contiene el número de teléfono del sitio en formato internacional. El formato internacional incluye el código de país y está precedido por un signo más (+). Por ejemplo, el international_phone_number de la oficina de Google en Sídney, Australia, es +61 2 9374 4000.
  • name contiene el nombre del resultado devuelto en lenguaje natural. Para los resultados de establishment, generalmente, este es el nombre comercial en formato canónico.
  • opening_hours contiene la siguiente información:
    • open_now es un valor booleano que indica si el sitio está abierto en ese momento.
    • periods[] es un arreglo de períodos abiertos que cubren siete días, a partir del día domingo, en orden cronológico. Cada período contiene:
      • open contiene un par de objetos de día y hora que describen cuándo abre el sitio:
        • day un número del 0 al 6, correspondiente a los días de la semana, a partir del domingo. Por ejemplo, "2" significa "martes".
        • time puede contener una hora del día en formato de 24 horas (hhmm). Los valores se indican en el rango de 0000 a 2359. El valor time se informará en la zona horaria del sitio.
      • close puede contener un par de objetos de día y hora que describen cuándo cierra el sitio. Nota: Si un lugar está siempre abierto, no se incluirá la sección close en la respuesta. Los clientes pueden orientarse con respecto a la indicación siempre abierto como un período open que se representa con day con un valor de 0, time con un valor de 0000, y sin close.
    • weekday_text es un arreglo de siete cadenas que representan las horas de apertura con formato para cada día de la semana. Si se especificó un parámetro language en la solicitud de detalles del sitio, el servicio de Places dará formato a las horas de apertura y las localizará según corresponda para ese idioma. El orden de los elementos en este arreglo depende del parámetro language. En algunos idiomas, la semana inicia el lunes y, en otros, comienza el domingo.
  • permanently_closed es un indicador booleano que señala si el sitio se ha cerrado de manera permanente (valor true). Si el sitio no está cerrado de manera permanente, el indicador está ausente en la respuesta.
  • photos[]: un conjunto de objetos de photo, cada uno con una referencia a una imagen. Una solicitud de detalles del sitio puede devolver hasta diez fotos. Puedes encontrar más información acerca de las fotos de sitios y cómo usar imágenes en tu aplicación en la documentación de Fotos de sitios. Un objeto photo se describe de la siguiente manera:
    • photo_reference: cadena utilizada para identificar la foto cuando realizas una solicitud de foto.
    • height: la altura máxima de la imagen.
    • width: el ancho máximo de la imagen.
    • html_attributions[]: contiene las atribuciones requeridas. Este campo estará siempre presente, pero puede estar vacío.
  • place_id: un identificador textual que identifica de forma exclusiva un sitio. Para recuperar información sobre el sitio, pasa este identificador en el campo placeId de una solicitud de la Places API. Para obtener más información sobre los id. de sitio, consulta la información general sobre id. de sitio.
  • scope: Indica el ámbito de place_id. Los posibles valores son los siguientes:
    • APP: solo tu aplicación reconoce el id. de sitio. Esto se debe a que agregaste un sitio a través de tu aplicación, y ese sitio aún no aprobó el proceso de moderación.
    • GOOGLE: el id. de sitio está disponible para otras aplicaciones y en Google Maps.
  • alt_ids: conjunto de cero, uno o más ID de sitio alternativos para el sitio, con un ámbito relacionado con cada ID alternativo. Nota: Este conjunto puede estar vacío o no aparecer. Si está presente, contendrá los siguientes campos:
    • place_id: el motivo más probable por el que un sitio puede contener un id. de sitio alternativo es que tu aplicación agregue un sitio y reciba un id. de sitio para el ámbito de la aplicación y que, luego de aprobar el proceso de moderación, reciba un id. de sitio para el ámbito de Google.
    • scope: el ámbito de un id. de sitio alternativo siempre será APP, lo que indica que solo tu aplicación reconoce el id. de sitio alternativo.
    Por ejemplo, supongamos que, a través de tu aplicación, agregas un sitio y recibes un place_id de AAA para el sitio nuevo. Más adelante, el sitio aprueba el proceso de moderación y se le otorga un place_id de BBB para el ámbito de Google. Desde ese momento, la información para ese sitio contendrá lo siguiente:
        "results" : [
          {
            "place_id" : "BBB",
            "scope" : "GOOGLE",
            "alt_ids" : [
              {
                "place_id" : "AAA",
                "scope" : "APP",
              }
            ],
          }
        ]
        
  • price_level : nivel de precio del sitio, en una escala de 0 a 4. La cantidad exacta indicada por un valor específico variará según la región. Los niveles de precios se interpretan de la siguiente manera:
    • 0: gratis
    • 1: barato
    • 2: moderado
    • 3: caro
    • 4: muy caro
  • rating contiene la clasificación del sitio, de 1,0 a 5,0, según las reseñas de usuarios agregadas.
  • reference contiene un token que se puede usar para consultar el servicio de detalles en el futuro. Este token puede ser diferente de la referencia utilizada en la solicitud para el servicio de detalles. Se recomienda actualizar con frecuencia las referencias almacenadas para los sitios. Si bien este token identifica de forma exclusiva al sitio, no ocurre lo mismo de forma inversa. Un sitio puede tener muchos tokens de referencia válidos. Nota: reference ha quedado en desuso en favor de place_id. Consulta el aviso sobre desuso en esta página.
  • reviews[] un conjunto JSON de hasta cinco reseñas. Si se especificó un parámetro language en la solicitud de detalles del sitio, el servicio de Places restringirá los resultados para preferir las reseñas escritas en ese idioma. Cada reseña consta de varios componentes:
    • aspects contiene un grupo de objetos AspectRating y cada uno proporciona una calificación de un atributo individual del establecimiento. El primer objeto del grupo se considera el aspecto principal. Cada AspectRating se describe de la siguiente manera:
      • type el nombre del aspecto que se está calificando. Los tipos admitidos son los siguientes: appeal, atmosphere, decor, facilities, food, overall, quality y service.
      • rating la calificación del usuario para ese aspecto en particular en una escala de 0 a 3.
    • author_name el nombre del usuario que envió la reseña. Las reseñas anónimas se atribuyen a "un usuario de Google".
    • author_url la dirección URL del perfil de Google+ del usuario, si estuviera disponible.
    • language un código de idioma IETF que indica el idioma utilizado en la reseña del usuario. Este campo contiene solo la etiqueta del idioma principal y no la etiqueta secundaria, que indica el país o la región. Por ejemplo, todas las reseñas en inglés están etiquetadas como “en”, y no como “en-AU” o “en-UK”, etc.
    • rating la calificación general del usuario para ese sitio. Es un número entero de 1 a 5.
    • text la reseña del usuario. Al revisar una ubicación con Google Places, las reseñas textuales se consideran opcionales. Por lo tanto, este campo puede estar vacío. Ten en cuenta que este campo puede incluir formato HTML básico. Por ejemplo, la referencia &amp; en una entidad puede representar un carácter de Y comercial.
    • time la hora a la que se envió la reseña, medida en la cantidad de segundos transcurridos desde la medianoche del 1º de enero de 1970, UTC.
  • types[] contiene un conjunto de tipos de características que describen el resultado proporcionado. Consulta la lista de tipos admitidos para obtener más información. Las respuestas XML incluyen múltiples elementos <type> si se asignó más de un tipo al resultado.
  • url contiene la dirección URL de la página oficial de Google para ese sitio. Se tratará de la página de Google que contenga la mejor información disponible acerca del sitio. Las aplicaciones deben establecer un vínculo con esta página o insertarla en cualquiera de las pantallas que muestren al usuario resultados detallados acerca del sitio.
  • utc_offset contiene la cantidad de minutos de desplazamiento de la zona horaria actual de este sitio respecto de la zona UTC. Por ejemplo, para sitios ubicados en Sídney, Australia, durante el horario de verano esta cifra sería 660 (+11 horas respecto de UTC) y, para sitios ubicados en California fuera del horario de verano, la sería -480 (-8 horas respecto de UTC).
  • vicinity indica una dirección simplificada para el sitio, que incluye el nombre de la calle, el número y la localidad, pero no la provincia/el estado, el código postal ni el país. Por ejemplo, la oficina de Google en Sídney, Australia, tiene un valor de vicinity de 48 Pirrama Road, Pyrmont.
  • website indica el sitio web autorizado del sitio, como la página de inicio de una empresa.

Es posible que las calificaciones multidimensionales no estén disponibles para todas las ubicaciones. Si hay muy pocas reseñas, la respuesta de detalles incluirá una calificación heredada en una escala de 1,0 a 5,0 (si estuviera disponible) o no incluirá calificación.

Datos premium

Además de los campos antes indicados, los clientes de Google Places API con licencia de Plan premium pueden recibir los siguientes campos. Estos campos aparecerán como campos secundarios de nivel superior del campo result.

  • aspects contiene un grupo de objetos AspectRating, y cada uno proporciona una calificación agregada de un atributo individual del establecimiento. El primer objeto del grupo se considera el aspecto principal. Cada AspectRating se describe de la siguiente manera:
    • type el nombre del aspecto que se está calificando. Por ejemplo, ambiente, servicio, comida, general, etc.
    • rating la calificación agregada para ese aspecto en particular en una escala de 0 a 30. Ten en cuenta que las calificaciones agregadas abarcan un rango de 0 a 30, mientras que las calificaciones que aparecen como parte de una reseña abarcan un rango de 0 a 3.
  • review_summary incluye una reseña completa y concisa administrada por el personal editorial de Google. Este campo no se incluirá, a menos que pases el parámetro extensions=review_summary en tu solicitud de detalles. Ten en cuenta que es posible que este campo no esté disponible en el idioma solicitado.
  • zagat_selected indica que el sitio fue seleccionado como una ubicación de calidad por Zagat. La etiqueta de Zagat identifica sitios conocidos por su constante alta calidad o que poseen un estilo especial o exclusivo.
Para obtener más información, consulta Datos premium.

En el siguiente ejemplo se muestra la forma en que los campos aspects y review_summary aparecen en el cuerpo de la respuesta:

"aspects" : [
   {
      "rating" : 24,
      "type" : "food"
   },
   {
      "rating" : 21,
      "type" : "decor"
   },
   {
      "rating" : 24,
      "type" : "service"
   }
],

...

"review_summary" : "For a meal that's a \"leisurely celebration\",
Mountain View \"foodies\" head to this \"lovely\" old Victorian house, where
\"artful\", \"high-end\" New French tasting dinners that \"look great and taste
even better\" are enhanced by sommelier-selected wines and service that
\"anticipates your every need\"; a garden out back supplies some ingredients,
while four dining areas provide \"lovely decor and ambiance\"; P.S. an
abbreviated tasting menu is also available."

El parámetro sensor

Antes, Google Places API Web Service requería que incluyeras el parámetro sensor para indicar si tu aplicación usaba un sensor para determinar la ubicación del usuario. El uso de este parámetro ya no es obligatorio.

Enviar comentarios sobre...