Find Place (heredado)

Desarrolladores del Espacio Económico Europeo (EEE)

Una solicitud de Find Place (heredado) toma una entrada de texto y devuelve un lugar. La entrada puede ser cualquier tipo de dato de texto de Places, como un nombre, una dirección o un número de teléfono. La solicitud debe ser una cadena. Una solicitud a Find Place (Legacy) que usa datos que no son cadenas, como una coordenada de latitud y longitud o un código plus, genera un error.

Solicitudes de Find Place (heredado)

Una solicitud de Find Place (Legacy) es una URL HTTP con el siguiente formato:

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

donde output puede ser cualquiera de los siguientes valores:

  • json (recomendado) indica el resultado en notación de objetos JavaScript (JSON).
  • xml indica que el resultado es en formato XML.

Se requieren ciertos parámetros para iniciar una solicitud de Find Place (Legacy). Tal como es práctica estándar para las URLs, todos los parámetros se separan usando el signo et (&).

Parámetros obligatorios

  • entrada

    Es la cadena de texto en la que se basa la búsqueda, por ejemplo, "restaurante" o "calle principal 123". Debe ser el nombre de un lugar, una dirección o una categoría de establecimientos. Cualquier otro tipo de entrada puede generar errores y no se garantiza que devuelva resultados válidos. La API de Places devolverá posibles coincidencias en función de esta cadena y ordenará los resultados según la relevancia percibida.

  • inputtype

    Es el tipo de entrada. Puede ser textquery o phonenumber. Los números de teléfono deben estar en formato internacional (precedidos por un signo más ("+"), seguido del código de país y, luego, el número en sí). Consulta la recomendación E.164 de la ITU para obtener más información.

Parámetros opcionales

  • campos

    Precaución: Las solicitudes de Place Search y Place Details no devuelven los mismos campos. Las solicitudes de Place Search muestran un subconjunto de los campos que muestran las solicitudes de Place Details. Si Place Search no devuelve el campo que deseas, puedes usar esta función para obtener un place_id y, luego, usar ese ID de lugar para realizar una solicitud de Place Details. Para obtener más información sobre los campos que no están disponibles en una solicitud de Place Search, consulta Compatibilidad con los campos de la API de Places.

    Usa el parámetro fields para especificar una lista separada por comas de los tipos de datos de lugar que deseas que se muestren. Por ejemplo: fields=formatted_address,name,geometry. Usa una barra diagonal cuando especifiques valores compuestos. Por ejemplo: opening_hours/open_now.

    Los campos se dividen en tres categorías de facturación: Basic, Contact y Atmosphere. Los campos de la tarifa Basic se facturan con la tarifa base, y los campos de las tarifas Contact y Atmosphere se facturan con una tarifa más alta. Los SKU de Basic, Contact y Atmosphere se cobran además del SKU básico (Places Details, Find Place, Nearby Search o Text Search) de la solicitud que los activó. Para obtener más información, consulta la hoja de precios.

    Básica

    La categoría Basic incluye los siguientes campos: address_components, adr_address, business_status, formatted_address, geometry, icon, icon_mask_base_uri, icon_background_color, name, permanently_closed (obsoleto), photo, place_id, plus_code, type, url, utc_offset, vicinity, wheelchair_accessible_entrance.

    Contacto

    La categoría Contact incluye los siguientes campos: current_opening_hours, formatted_phone_number, international_phone_number, opening_hours, secondary_opening_hours, website

    Atmosphere

    La categoría Atmosphere incluye los siguientes campos: curbside_pickup, delivery, dine_in, editorial_summary, price_level, rating, reservable, reviews, serves_beer, serves_breakfast, serves_brunch, serves_dinner, serves_lunch, serves_vegetarian_food, serves_wine, takeout, user_ratings_total.

    Nota: Las atribuciones, html_attributions, se muestran siempre con cada llamada, independientemente de si se solicitó el campo.

  • idioma

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

    • Consulta la lista de idiomas admitidos. Google actualiza con frecuencia los idiomas admitidos, por lo que es posible que esta lista no sea exhaustiva.
    • Si no se proporciona language, la API intenta usar el idioma preferido especificado en el encabezado Accept-Language.
    • 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 de calles en el idioma local, transliteradas a una escritura que el usuario pueda leer si es necesario, y observa 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 un nombre no está 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 devolver y en el orden en que se devuelven. 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. Por ejemplo, utca y tér son sinónimos de calle en húngaro.

  • locationbias

    Prefiere los resultados en un área especificada, ya sea con un radio y una latitud y longitud, o bien con dos pares de latitud y longitud que representan los puntos de un rectángulo. Si no se especifica este parámetro, la API usa la adaptación de la búsqueda por dirección IP de forma predeterminada.

    • Sesgo de IP: Indica a la API que use el sesgo de dirección IP. Pasa la cadena ipbias (esta opción no tiene parámetros adicionales).
    • Circular: Es una cadena que especifica el radio en metros, además de la latitud y la longitud en grados decimales. Usa el siguiente formato: circle:radius@lat,lng.
    • Rectangular: Es una cadena que especifica dos pares de coordenadas de latitud y longitud en grados decimales, que representan los puntos sur/oeste y norte/este de un rectángulo. Usa el siguiente formato:rectangle:south,west|north,east. Ten en cuenta que los valores este/oeste se ajustan al rango de -180 a 180, y los valores norte/sur se ajustan al rango de -90 a 90.

Ejemplos de Find Place (heredado)

En el siguiente ejemplo, se muestra una solicitud de Find Place (heredado) para "Museum of Contemporary Art Australia", que incluye los campos photos, formatted_address, name, rating, opening_hours y geometry:

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/place/findplacefromtext/json?input=Museum%20of%20Contemporary%20Art%20Australia&inputtype=textquery&fields=formatted_address%2Cname%2Crating%2Copening_hours%2Cgeometry&key=YOUR_API_KEY'

HTTP

https://maps.googleapis.com/maps/api/place/findplacefromtext/json
    ?fields=formatted_address%2Cname%2Crating%2Copening_hours%2Cgeometry
    &input=Museum%20of%20Contemporary%20Art%20Australia
    &inputtype=textquery
    &key=YOUR_API_KEY

En el siguiente ejemplo, se muestra una solicitud de Find Place (Legacy) para "Mongolian Grill", en la que se usa el parámetro locationbias para priorizar los resultados dentro de un radio de 2,000 metros de las coordenadas especificadas:

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/place/findplacefromtext/json?input=Mongolian%20Grill&inputtype=textquery&fields=formatted_address%2Cname%2Crating%2Copening_hours%2Cgeometry&locationbias=circle:2000@−33.866,151.216&key=YOUR_API_KEY'

HTTP

https://maps.googleapis.com/maps/api/place/findplacefromtext/json
    ?fields=formatted_address%2Cname%2Crating%2Copening_hours%2Cgeometry
    &input=Mongolian%20Grill
    &inputtype=textquery
    &locationbias=circle:2000@−33.866,151.216
    &key=YOUR_API_KEY

En el siguiente ejemplo, se muestra una solicitud de Find Place (legado) para un número de teléfono. Ten en cuenta que el prefijo de llamada internacional "+" se codificó como %2B para que esta solicitud sea una URL conforme. Si no se codifica, el prefijo + se decodificaría como un espacio en el servidor, lo que generaría una búsqueda de número de teléfono no válida.

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/place/findplacefromtext/json?input=%2B16502530000&inputtype=phonenumber&fields=formatted_address%2Cname%2Crating%2Copening_hours%2Cgeometry&key=YOUR_API_KEY'

HTTP

https://maps.googleapis.com/maps/api/place/findplacefromtext/json
    ?fields=formatted_address%2Cname%2Crating%2Copening_hours%2Cgeometry
    &input=%2B16502530000
    &inputtype=phonenumber
    &key=YOUR_API_KEY

Respuestas de Find Place (heredado)

Una respuesta de Find Place (Legacy) contiene solo los tipos de datos que se especificaron con el parámetro fields, además de html_attributions. En el siguiente ejemplo, se muestra la respuesta a una solicitud de Find Place (heredado) para "Museum of Contemporary Art Australia", que incluye los campos formatted_address, geometry, name, opening_hours, photos y rating.

JSON

{
  "candidates":
    [
      {
        "formatted_address": "140 George St, The Rocks NSW 2000, Australia",
        "geometry":
          {
            "location": { "lat": -33.8599358, "lng": 151.2090295 },
            "viewport":
              {
                "northeast":
                  { "lat": -33.85824377010728, "lng": 151.2104386798927 },
                "southwest":
                  { "lat": -33.86094342989272, "lng": 151.2077390201073 },
              },
          },
        "name": "Museum of Contemporary Art Australia",
        "opening_hours": { "open_now": false },
        "rating": 4.4,
      },
    ],
  "status": "OK",
}

XML

<?xml version="1.0" encoding="UTF-8"?>
<FindPlaceFromTextResponse>
 <candidates>
  <name>Museum of Contemporary Art Australia</name>
  <formatted_address>140 George St, The Rocks NSW 2000, Australia</formatted_address>
  <geometry>
   <location>
    <lat>-33.8599358</lat>
    <lng>151.2090295</lng>
   </location>
   <viewport>
    <southwest>
     <lat>-33.8609434</lat>
     <lng>151.2077390</lng>
    </southwest>
    <northeast>
     <lat>-33.8582438</lat>
     <lng>151.2104387</lng>
    </northeast>
   </viewport>
  </geometry>
  <rating>4.4</rating>
  <opening_hours>
   <open_now>false</open_now>
  </opening_hours>
 </candidates>
 <status>OK</status>
</FindPlaceFromTextResponse>

PlacesFindPlaceFromTextResponse

Campo Obligatorio Tipo Descripción
required Arreglo de Place

Contiene un array de sugerencias de lugares.

Las solicitudes de Place Search muestran un subconjunto de los campos que muestran las solicitudes de Place Details. Si Place Search no devuelve el campo que deseas, puedes usar esta función para obtener un place_id y, luego, usar ese ID de lugar para realizar una solicitud de Place Details.

Consulta Lugar para obtener más información.
required PlacesSearchStatus

Contiene el estado de la solicitud y puede incluir información de depuración para ayudarte a identificar el motivo del error en la solicitud.

Consulta PlacesSearchStatus para obtener más información.

opcional string

Cuando el servicio devuelve un código de estado que no es OK<, es posible que haya un campo error_message adicional dentro del objeto de respuesta. Este campo contiene información más detallada sobre los motivos del código de estado proporcionado. Este campo no siempre se devuelve y su contenido está sujeto a cambios.

opcional Arreglo<cadena>

Cuando el servicio devuelve información adicional sobre la especificación de la solicitud, puede haber un campo info_messages adicional dentro del objeto de respuesta. Este campo solo se devuelve para las solicitudes exitosas. Es posible que no siempre se devuelva y su contenido está sujeto a cambios.

PlacesSearchStatus

Son los códigos de estado que muestra el servicio.

  • OK: Indica que la solicitud a la API se realizó correctamente.
  • ZERO_RESULTS indica que la búsqueda se realizó correctamente, pero no devolvió ningún resultado. Esto puede ocurrir si se pasó un latlng en una ubicación remota a la búsqueda.
  • INVALID_REQUEST: Indica que la solicitud a la API tenía un formato incorrecto, por lo general, debido a que faltaba un parámetro de búsqueda obligatorio (location o radius).
  • OVER_QUERY_LIMIT que indica cualquiera de las siguientes opciones:
    • Superaste los límites de QPS.
    • No se habilitó la facturación en tu cuenta.
    • Se superó el crédito mensual de USD 200 o un límite de uso autoimpuesto.
    • La forma de pago proporcionada ya no es válida (por ejemplo, si venció una tarjeta de crédito).
    Consulta las Preguntas frecuentes de Maps para obtener más información sobre cómo resolver este error.
  • REQUEST_DENIED indica que se rechazó tu solicitud, generalmente por los siguientes motivos:
    • Falta una clave de API en la solicitud.
    • El parámetro key no es válido.
  • UNKNOWN_ERROR: Indica un error desconocido.

Lugar

Son atributos que describen un lugar. No todos los atributos estarán disponibles para todos los tipos de lugares.

Campo Obligatorio Tipo Descripción
opcional Arreglo<AddressComponent>

Es un array que contiene los componentes independientes aplicables a esta dirección.

Consulta AddressComponent para obtener más información.

opcional string

Es una representación de la dirección del lugar en el microformato adr.

opcional string

Indica el estado operativo del lugar, si es una empresa. Si no hay datos, no se muestra business_status.

The allowed values include: OPERATIONAL, CLOSED_TEMPORARILY, and CLOSED_PERMANENTLY
opcional booleano

Especifica si la empresa admite el retiro en la puerta.
opcional PlaceOpeningHours

Contiene el horario de atención de los próximos siete días (incluido hoy). El período comienza a la medianoche de la fecha de la solicitud y finaliza a las 11:59 p.m. seis días después. Este campo incluye el subcampo special_days de todas las horas, establecido para las fechas que tienen horarios excepcionales.

Consulta PlaceOpeningHours para obtener más información.

opcional booleano

Especifica si la empresa admite la entrega.
opcional booleano

Especifica si la empresa admite opciones de asientos en interiores o exteriores.

opcional PlaceEditorialSummary

Contiene un resumen del lugar. Un resumen se compone de una descripción general textual y también incluye el código de idioma de estos si corresponde. El texto del resumen debe presentarse tal como está y no se puede modificar ni alterar.

Consulta PlaceEditorialSummary para obtener más información.

opcional string

Es una cadena que contiene la dirección legible por humanos de este lugar.

A menudo, esta dirección equivale a la dirección postal. Ten en cuenta que algunos países, como el Reino Unido, no permiten la distribución de direcciones postales verdaderas debido a restricciones de licencia.

La dirección con formato está compuesta, de manera lógica, por uno o más componentes de dirección. Por ejemplo, la dirección "111 8th Avenue, New York, NY" consta de los siguientes componentes: "111" (número de la calle), "8th Avenue" (calle), "New York" (ciudad) y "NY" (estado de EE.UU.).

No analices la dirección con formato de manera programática. En cambio, debes usar los componentes individuales de la dirección, que la respuesta de la API incluye además del campo de dirección con formato.

opcional string

Contiene el número de teléfono del lugar en su formato local.

opcional Geometry

Contiene la ubicación y la ventana gráfica de la ubicación.

Consulta Geometry para obtener más información.
opcional string

Contiene la URL de un ícono sugerido que se puede mostrar al usuario cuando se indica este resultado en un mapa.

opcional string

Contiene el código de color hexadecimal predeterminado para la categoría del lugar.
opcional string

Contiene la URL de un ícono recomendado, menos la extensión del tipo de archivo .svg o .png.

opcional string

Contiene el número de teléfono del lugar en formato internacional. El formato internacional incluye el código de país y está precedido por el signo más (+). Por ejemplo, el número de teléfono internacional de la oficina de Google en Sídney, Australia, es +61 2 9374 4000.

opcional string

Contiene el nombre legible del resultado devuelto. En el caso de los resultados de establishment, suele ser el nombre de la empresa canonizado.

opcional PlaceOpeningHours

Contiene el horario de atención habitual.

Consulta PlaceOpeningHours para obtener más información.

opcional booleano

Usa business_status para obtener el estado operativo de las empresas.

opcional Arreglo<PlacePhoto>

Es un array de objetos de fotos, cada uno de los cuales contiene una referencia a una imagen. Una solicitud puede devolver hasta diez fotos. En la documentación de Place Photos, encontrarás más información sobre las fotos de lugares y cómo puedes usar las imágenes en tu aplicación.

Consulta PlacePhoto para obtener más información.
opcional string

un identificador textual que identifica de forma exclusiva un sitio. Para recuperar información sobre el lugar, pasa este identificador en el campo place_id de una solicitud a la API de Places. Para obtener más información sobre los IDs de lugar, consulta la descripción general de los IDs de lugar.

opcional PlusCode

Es una referencia de ubicación codificada, derivada de las coordenadas de latitud y longitud, que representa un área: 1/8,000 de un grado por 1/8,000 de un grado (aproximadamente 14 m x 14 m en el Ecuador) o menos. Los Plus Codes se pueden usar como reemplazo de las direcciones en lugares donde estas no existen (donde los edificios no están numerados o las calles no tienen nombre). Consulta los códigos de ubicación abiertos y los códigos plus.

Consulta PlusCode para obtener más información.
opcional número

Es el nivel de precios del lugar, en una escala del 0 al 4. El importe exacto indicado por un valor específico variará de una región a otra. Los niveles de precios se interpretan de la siguiente manera:

  • 0 gratis
  • 1. De bajo costo
  • 2: Moderada
  • 3, costoso
  • 4, Muy costoso
opcional número

Contiene la calificación del lugar, de 1.0 a 5.0, según las opiniones agregadas de los usuarios.

opcional string
opcional booleano

Especifica si el lugar admite reservas.
opcional Arreglo<PlaceReview>

Es un array JSON de hasta cinco opiniones. De forma predeterminada, las opiniones se ordenan por relevancia. Usa el parámetro de solicitud reviews_sort para controlar la clasificación.

  • Para most_relevant (predeterminado), las opiniones se ordenan por relevancia. El servicio sesgará los resultados para mostrar las opiniones escritas originalmente en el idioma preferido.
  • En el caso de newest, las opiniones se ordenan cronológicamente, y el idioma preferido no afecta el orden.

Google recomienda indicar a los usuarios si los resultados se ordenan por most_relevant o newest.

Consulta PlaceReview para obtener más información.

opcional string
opcional Arreglo<PlaceOpeningHours>

Contiene un array de entradas para los próximos siete días, incluida información sobre el horario secundario de una empresa. Los horarios secundarios son diferentes de los horarios principales de una empresa. Por ejemplo, un restaurante puede especificar el horario de atención en el automóvil o el horario de entrega como su horario secundario. Este campo completa el subcampo type, que se basa en una lista predefinida de tipos de horarios de apertura (como DRIVE_THROUGH, PICKUP o TAKEOUT) según los tipos de lugar. Este campo incluye el subcampo special_days de todas las horas, establecido para las fechas que tienen horas excepcionales.

Consulta PlaceOpeningHours para obtener más información.

opcional booleano

Especifica si el lugar ofrece cerveza.
opcional booleano

Especifica si el lugar sirve desayuno.
opcional booleano

Especifica si el lugar ofrece desayuno-almuerzo.
opcional booleano

Especifica si el lugar sirve cena.
opcional booleano

Especifica si el lugar sirve almuerzo.
opcional booleano

Especifica si el lugar ofrece comida vegetariana.
opcional booleano

Especifica si el lugar sirve vino.
opcional booleano

Especifica si el comercio admite pedidos para llevar.
opcional Arreglo<cadena>

Contiene un array de tipos de componentes que describen el resultado determinado. Consulta la lista de tipos admitidos.

opcional string

Contiene la URL de la página oficial de Google para este lugar. Esta será la página propiedad de Google que contiene la mejor información disponible sobre el lugar. Las aplicaciones deben establecer un vínculo con esta página o incorporarla en cualquiera de las pantallas que muestren al usuario resultados detallados sobre el lugar.

opcional número

Es la cantidad total de opiniones, con o sin texto, sobre este lugar.

opcional número

Contiene la cantidad de minutos de diferencia de la zona horaria actual del lugar con respecto a la zona UTC. Por ejemplo, para lugares ubicados en Sídney, Australia, durante el horario de verano, esta cifra sería 660 (+11 horas respecto de UTC) y, para lugares ubicados en California fuera del horario de verano, sería -480 (-8 horas respecto de UTC).

opcional string

En el caso de los resultados de establecimientos (solo types:["establishment", ...])), el campo vicinity contiene una dirección simplificada del lugar, que incluye el nombre de la calle, el número y la localidad, pero no la provincia o el estado, el código postal ni el país.

Para todos los demás resultados, el campo vicinity contiene el nombre de la entidad política (types:["political", ...]) más específica que está presente en la dirección del resultado.

Este contenido se debe leer tal como está. No analices la dirección con formato de manera programática.

opcional string

El sitio web autorizado para este lugar, como la página principal de una empresa.

opcional booleano

Especifica si el lugar tiene una entrada accesible para personas en silla de ruedas.

PlaceEditorialSummary

Contiene un resumen del lugar. Un resumen se compone de una descripción general textual y también incluye el código de idioma de estos si corresponde. El texto del resumen se debe presentar tal como está y no se puede modificar ni alterar.

Campo Obligatorio Tipo Descripción
opcional string

Es el idioma de los campos anteriores. Es posible que no siempre esté presente.
opcional string

Es un resumen textual de longitud media del lugar.

PlaceOpeningHours

Es un objeto que describe el horario de atención de un lugar.

Campo Obligatorio Tipo Descripción
opcional booleano

Es un valor booleano que indica si el lugar está abierto en ese momento.

opcional Es un array de PlaceOpeningHoursPeriod.

Es un array de períodos de atención que cubren siete días, a partir del domingo, en orden cronológico.

Consulta PlaceOpeningHoursPeriod para obtener más información.

opcional Arreglo<PlaceSpecialDay>

Es un array de hasta siete entradas que corresponden a los próximos siete días.

Consulta PlaceSpecialDay para obtener más información.

opcional string

Es una cadena de tipo que se usa para identificar el tipo de horario secundario (por ejemplo, DRIVE_THROUGH, HAPPY_HOUR, DELIVERY, TAKEOUT, KITCHEN, BREAKFAST, LUNCH, DINNER, BRUNCH, PICKUP, SENIOR_HOURS). Se establece solo para secondary_opening_hours.

weekday_text

opcional Arreglo<cadena>

Es un array de cadenas que describen en texto legible por humanos los horarios del lugar.

PlaceOpeningHoursPeriod

Campo Obligatorio Tipo Descripción
required PlaceOpeningHoursPeriodDetail

Contiene un par de objetos de día y hora que indican cuándo abre el lugar.

Consulta PlaceOpeningHoursPeriodDetail para obtener más información.

opcional PlaceOpeningHoursPeriodDetail

Puede contener un par de objetos de día y hora que indican cuándo cierra el lugar. Si un lugar siempre está abierto, no se incluirá la sección de cierre en la respuesta. Los clientes pueden confiar en que la indicación "siempre abierto" se representa como un período abierto que contiene el día con el valor 0 y la hora con el valor 0000, y que no se indica un elemento close.

Consulta PlaceOpeningHoursPeriodDetail para obtener más información.

PlaceSpecialDay

Campo Obligatorio Tipo Descripción
opcional string

Una fecha expresada en formato RFC3339 en la zona horaria local del lugar, por ejemplo, 2010-12-31.

opcional booleano

Es verdadero si hay horarios excepcionales para este día. Si es true, significa que hay al menos una excepción para este día. Las excepciones hacen que se produzcan valores diferentes en los subcampos de current_opening_hours y secondary_opening_hours, como periods, weekday_text y open_now. Las excepciones se aplican a las horas, y estas se utilizan para generar los demás campos.

PlaceOpeningHoursPeriodDetail

Campo Obligatorio Tipo Descripción
required número

Número del 0 al 6 que corresponde a los días de la semana, a partir del domingo. Por ejemplo, "2" significa "martes".

required string

Puede contener una hora del día en el formato hhmm de 24 horas. Los valores se encuentran en el rango de 0000 a 2359. La hora se informará en la zona horaria del lugar.

opcional string

Una fecha expresada en formato RFC3339 en la zona horaria local del lugar, por ejemplo, 2010-12-31.

opcional booleano

Es verdadero si un período determinado se truncó debido a un corte de siete días, en el que el período comienza antes de la medianoche de la fecha de la solicitud o finaliza a la medianoche del último día o después. Esta propiedad indica que el período de apertura o cierre puede extenderse más allá de este límite de siete días.

PlacePhoto

Es una foto de un lugar. Se puede acceder a la foto con la API de Place Photo a través de una URL con el siguiente patrón: 

https://maps.googleapis.com/maps/api/place/photo?maxwidth=400&photo_reference=photo_reference&key=YOUR_API_KEY

Consulta Fotos de lugares para obtener más información.

Campo Obligatorio Tipo Descripción
required número

Altura de la foto
required Arreglo<cadena>

Son las atribuciones HTML de la foto.
required string

Es una cadena que se usa para identificar la foto cuando realizas una solicitud de Photo.

required número

Ancho de la foto

PlaceReview

Es una opinión sobre el lugar que envió un usuario.

Campo Obligatorio Tipo Descripción
required string

Es el nombre del usuario que envió la opinión. Las opiniones anónimas se atribuyen a "Un usuario de Google".

required número

Es la calificación general del usuario para este lugar. Es un número entero que va del 1 al 5.

required string

Fecha y hora en que se envió la opinión en formato de texto, en relación con la fecha y hora actuales.

required número

Fecha y hora en que se envió la opinión, medida en la cantidad de segundos transcurridos desde la medianoche del 1 de enero de 1970 UTC.

opcional string

Es la URL del perfil de Local Guides de Google Maps del usuario, si está disponible.

opcional string

Es un código de idioma IETF que indica el idioma de la opinión devuelta.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 opiniones en inglés están etiquetadas como "en", y no como "en-AU" o "en-UK", etcétera.Este campo está vacío si solo hay una calificación sin texto de opinión.

opcional string

Es un código de idioma IETF que indica el idioma original de la opinión. Si la opinión se tradujo, original_language != language.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 opiniones en inglés están etiquetadas como "en", y no como "en-AU" o "en-UK", etcétera.Este campo está vacío si solo hay una calificación sin texto de opinión.

opcional string

URL de la foto de perfil del usuario, si está disponible.

text

opcional string

Es la opinión del usuario. Al revisar una ubicación con Google Places, las opiniones de texto se consideran opcionales. Por lo tanto, este campo puede estar vacío. Ten en cuenta que este campo puede incluir un lenguaje de marcado HTML básico. Por ejemplo, la referencia a la entidad &amp; puede representar un carácter de et.

opcional booleano

Es un valor booleano que indica si la opinión se tradujo del idioma original en el que se escribió.Si una opinión se tradujo, lo que corresponde a un valor verdadero, Google recomienda que se lo indiques a los usuarios. Por ejemplo, puedes agregar la siguiente cadena: "Traducido por Google".