Este producto tiene el estado heredado. A partir de octubre de 2026, ya no se podrá habilitar la API de Places (heredada) para proyectos nuevos de Google Cloud. Los proyectos existentes siguen siendo totalmente compatibles. Para obtener nuevas funciones y un mejor rendimiento, migra a la API de Places (nueva).

Google utiliza tecnología de IA para traducir contenido a tu idioma preferido. Las traducciones realizadas con IA pueden contener errores.

Place Details (heredado)

Desarrolladores del Espacio Económico Europeo (EEE)

Nota: Bibliotecas del servidor y del cliente

La API de Places también está disponible con los clientes de Java, Python, Go y Node.js para los servicios de Google Maps. La API de Places y las bibliotecas cliente se usan en aplicaciones de servidor.

Si estás creando una aplicación del cliente, consulta el SDK de Places para Android (nuevo), el SDK de Places para iOS (nuevo) y la biblioteca de Places para la API de Maps JavaScript.

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

Solicitudes de Place Details (heredado)

Una solicitud de Place Details (heredada) es una URL HTTP con el siguiente formato:

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

donde output puede ser cualquiera de los siguientes valores:

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

Ciertos parámetros son obligatorios para iniciar una solicitud de búsqueda. Tal como es práctica estándar para las URLs, todos los parámetros se separan usando el signo et (&). En las siguientes secciones, se enumeran los parámetros y sus valores posibles.

Parámetros obligatorios

place_id

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

Parámetros opcionales

campos

Precaución: Las solicitudes de Place Search (heredada) y Place Details (heredada) no devuelven los mismos campos. Las solicitudes de Place Search (heredada) devuelven un subconjunto de los campos que devuelven las solicitudes de Place Details (heredada). Si Place Search (heredada) 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 (heredada). Para obtener más información sobre los campos que no están disponibles en una solicitud de Place Search (heredada), consulta Campos de datos de Place (heredados).

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 para especificar valores compuestos. Por ejemplo: opening_hours/open_now.

Los campos se dividen en tres categorías de facturación: Basic, Contact y Atmosphere. Los SKU de Basic, Contact y Atmosphere se cobran además del SKU base (Place 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 y 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 y user_ratings_total.

Nota: Las atribuciones, html_attributions, se devuelven siempre con todas las llamadas, independientemente de si se solicitó el campo.
idioma

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 language, la API intenta usar el idioma preferido, como se especifica 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 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 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 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. Por ejemplo, utca y tér son sinónimos de calle en húngaro.
región

Es el código de región, especificado como un valor de ccTLD ("dominio de nivel superior") de dos caracteres. La mayoría de los códigos ccTLD 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").
reviews_no_translations

Especifica reviews_no_translations=true para inhabilitar la traducción de opiniones; especifica reviews_no_translations=false para habilitar la traducción de opiniones. Las opiniones se devuelven en su idioma original.

Si se omite o se pasa sin valor, se habilita la traducción de las opiniones. Si se especificó el parámetro language en la solicitud, usa el idioma especificado como el idioma preferido para la traducción. Si se omite language, la API intenta usar el encabezado Accept-Language como el idioma preferido.
reviews_sort

Es el método de ordenamiento que se usará cuando se devuelvan las opiniones. Se puede configurar en most_relevant (predeterminado) o newest.
- 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.
- Para newest, las opiniones se ordenan de forma cronológica; el idioma preferido no afecta el orden de clasificación.
Google recomienda que muestres al usuario final cómo se ordenan las opiniones.
sessiontoken

Es una cadena aleatoria que identifica una sesión de autocompletado para fines de facturación.

La sesión se inicia cuando el usuario comienza a escribir una consulta y termina cuando selecciona un lugar y se realiza una llamada a Place Details (heredada). Cada sesión puede tener varias búsquedas, seguidas de una selección de lugar. Las claves de API que se usen para cada solicitud dentro de una sesión deben pertenecer al mismo proyecto de la consola de Google Cloud. Una vez que finaliza la sesión, el token deja de ser válido. Tu app debe generar un token nuevo para cada sesión. Si se omite el parámetro sessiontoken, o si reutilizas un token de sesión, la sesión se cobrará como si no se hubiera proporcionado un token de sesión (cada solicitud se factura por separado).

Recomendamos los siguientes lineamientos:
- Usa tokens de sesión para todas las sesiones de autocompletado.
- Genera un token nuevo para cada sesión. Se recomienda usar la versión 4 de UUID.
- Asegúrate de que las claves de API que se usan para todas las solicitudes de Place Autocomplete y Place Details de una sesión pertenezcan al mismo proyecto de la consola de Cloud.
- Asegúrate de pasar un token de sesión único para cada sesión nueva. Usar el mismo token en más de una sesión hará que cada solicitud se facture de forma individual.

Advertencia: Si no especificas al menos un campo con una solicitud o si omites el parámetro fields en una solicitud, se devolverán TODOS los campos posibles y se te facturará en función de ello. Esto se aplica solo a las solicitudes de Place Details (heredado).

Ejemplo de Place Details (heredado)

En el siguiente ejemplo, se solicitan los detalles de un lugar por place_id y se incluyen los campos name, rating y formatted_phone_number:

Almeja

curl -L -X GET 'https://maps.googleapis.com/maps/api/place/details/json?place_id=ChIJN1t_tDeuEmsRUsoyG83frY4&fields=name%2Crating%2Cformatted_phone_number&key=YOUR_API_KEY'

HTTP

https://maps.googleapis.com/maps/api/place/details/json
  ?fields=name%2Crating%2Cformatted_phone_number
  &place_id=ChIJN1t_tDeuEmsRUsoyG83frY4
  &key=YOUR_API_KEY

Reemplaza la clave de este ejemplo por tu propia clave de API para que la solicitud funcione en tu aplicación.

Respuesta de Place Details (heredado)

Las respuestas de Place Details (heredado) se devuelven en el formato que indica la marca output dentro de la ruta de 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 Rd",
            "types": ["route"],
          },
          {
            "long_name": "Pyrmont",
            "short_name": "Pyrmont",
            "types": ["locality", "political"],
          },
          {
            "long_name": "City of Sydney",
            "short_name": "City of Sydney",
            "types": ["administrative_area_level_2", "political"],
          },
          {
            "long_name": "New South Wales",
            "short_name": "NSW",
            "types": ["administrative_area_level_1", "political"],
          },
          {
            "long_name": "Australia",
            "short_name": "AU",
            "types": ["country", "political"],
          },
          {
            "long_name": "2009",
            "short_name": "2009",
            "types": ["postal_code"],
          },
        ],
      "adr_address": "48 Pirrama Rd, Pyrmont NSW 2009, Australia",
      "business_status": "OPERATIONAL",
      "formatted_address": "48 Pirrama Rd, Pyrmont NSW 2009, Australia",
      "formatted_phone_number": "(02) 9374 4000",
      "geometry":
        {
          "location": { "lat": -33.866489, "lng": 151.1958561 },
          "viewport":
            {
              "northeast":
                { "lat": -33.8655112697085, "lng": 151.1971156302915 },
              "southwest":
                { "lat": -33.86820923029149, "lng": 151.1944176697085 },
            },
        },
      "icon": "https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/generic_business-71.png",
      "icon_background_color": "#7B9EB0",
      "icon_mask_base_uri": "https://maps.gstatic.com/mapfiles/place_api/icons/v2/generic_pinlet",
      "international_phone_number": "+61 2 9374 4000",
      "name": "Google Workplace 6",
      "opening_hours":
        {
          "open_now": false,
          "periods":
            [
              {
                "close": { "day": 1, "time": "1700" },
                "open": { "day": 1, "time": "0900" },
              },
              {
                "close": { "day": 2, "time": "1700" },
                "open": { "day": 2, "time": "0900" },
              },
              {
                "close": { "day": 3, "time": "1700" },
                "open": { "day": 3, "time": "0900" },
              },
              {
                "close": { "day": 4, "time": "1700" },
                "open": { "day": 4, "time": "0900" },
              },
              {
                "close": { "day": 5, "time": "1700" },
                "open": { "day": 5, "time": "0900" },
              },
            ],
          "weekday_text":
            [
              "Monday: 9:00 AM – 5:00 PM",
              "Tuesday: 9:00 AM – 5:00 PM",
              "Wednesday: 9:00 AM – 5:00 PM",
              "Thursday: 9:00 AM – 5:00 PM",
              "Friday: 9:00 AM – 5:00 PM",
              "Saturday: Closed",
              "Sunday: Closed",
            ],
        },
      "photos":
        [
          {
            "height": 3024,
            "html_attributions":
              [
                "Cynthia Wei",
              ],
            "photo_reference": "Aap_uEC6jqtpflLS8GxQqPHBjlcwBf2sri0ZErk9q1ciHGZ6Zx5HBiiiEsPEO3emtB1PGyWbBQhgPL2r9CshoVlJEG4xzB71QMhGBTqqeaCNk1quO3vTTiP50aM1kmOaBQ-DF1ER7zpu6BQOEtnusKMul0m4KA45wfE3h6Xh2IxjLNzx-IiX",
            "width": 4032,
          },
          {
            "height": 3264,
            "html_attributions":
              [
                "Heyang Li",
              ],
            "photo_reference": "Aap_uECyRjHhOQgGaKTW6Z3ZfTEaDhNc44m0F6GrNSFIMffixwI5xqD35QhecdzVY-FUuDtVE1huu8-2HkxgI9Gwvy6W18fU-_E3UUkdSFBQqGK8_slKlT8BZZc66sTX53IEcTDrZfT-E5_YUBYBOm13yxOTOfWfEDABhaxCGC5Hu_XYh0fI",
            "width": 4912,
          },
          // ...
        ],
      "place_id": "ChIJN1t_tDeuEmsRUsoyG83frY4",
      "plus_code":
        {
          "compound_code": "45MW+C8 Pyrmont NSW, Australia",
          "global_code": "4RRH45MW+C8",
        },
      "rating": 4,
      "reference": "ChIJN1t_tDeuEmsRUsoyG83frY4",
      "reviews":
        [
          {
            "author_name": "Luke Archibald",
            "author_url": "https://www.google.com/maps/contrib/113389359827989670652/reviews",
            "language": "en",
            "profile_photo_url": "https://lh3.googleusercontent.com/a-/AOh14GhGGmTmvtD34HiRgwHdXVJUTzVbxpsk5_JnNKM5MA=s128-c0x00000000-cc-rp-mo",
            "rating": 1,
            "relative_time_description": "a week ago",
            "text": "Beautiful building with a great view.",
            "time": 1652286798,
          },
          {
            "author_name": "Tevita Taufoou",
            "author_url": "https://www.google.com/maps/contrib/105937236918123663309/reviews",
            "language": "en",
            "profile_photo_url": "https://lh3.googleusercontent.com/a/AATXAJwZANdRSSg96QeZG--6BazG5uv_BJMIvpZGqwSz=s128-c0x00000000-cc-rp-mo",
            "rating": 1,
            "relative_time_description": "6 months ago",
            "text": "Conference rooms were well equipped.",
            "time": 1637215605,
          },
          // ...
        ],
      "types": ["point_of_interest", "establishment"],
      "url": "https://maps.google.com/?cid=10281119596374313554",
      "user_ratings_total": 939,
      "utc_offset": 600,
      "vicinity": "48 Pirrama Road, Pyrmont",
      "website": "http://google.com/",
    },
  "status": "OK",
}

XML

<?xml version="1.0" encoding="UTF-8"?>
<PlaceDetailsResponse>
 <status>OK</status>
 <result>
  <name>Google Workplace 6</name>
  <vicinity>48 Pirrama Road, Pyrmont</vicinity>
  <type>point_of_interest</type>
  <type>establishment</type>
  <formatted_phone_number>(02) 9374 4000</formatted_phone_number>
  <formatted_address>48 Pirrama Rd, Pyrmont NSW 2009, 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 Rd</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>City of Sydney</long_name>
   <short_name>City of Sydney</short_name>
   <type>administrative_area_level_2</type>
   <type>political</type>
  </address_component>
  <address_component>
   <long_name>New South Wales</long_name>
   <short_name>NSW</short_name>
   <type>administrative_area_level_1</type>
   <type>political</type>
  </address_component>
  <address_component>
   <long_name>Australia</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.8664890</lat>
    <lng>151.1958561</lng>
   </location>
   <viewport>
    <southwest>
     <lat>-33.8682092</lat>
     <lng>151.1944177</lng>
    </southwest>
    <northeast>
     <lat>-33.8655113</lat>
     <lng>151.1971156</lng>
    </northeast>
   </viewport>
  </geometry>
  <rating>4.0</rating>
  <url>https://maps.google.com/?cid=10281119596374313554</url>
  <icon>https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/generic_business-71.png</icon>
  <reference>ChIJN1t_tDeuEmsRUsoyG83frY4</reference>
  <international_phone_number>+61 2 9374 4000</international_phone_number>
  <website>http://google.com/</website>
  <review>
   <time>1652286798</time>
   <text>Beautiful building with a great view.</text>
   <author_name>Luke Archibald</author_name>
   <author_url>https://www.google.com/maps/contrib/113389359827989670652/reviews</author_url>
   <rating>1.0</rating>
   <language>en</language>
   <profile_photo_url>https://lh3.googleusercontent.com/a-/AOh14GhGGmTmvtD34HiRgwHdXVJUTzVbxpsk5_JnNKM5MA=s128-c0x00000000-cc-rp-mo</profile_photo_url>
   <relative_time_description>a week ago</relative_time_description>
  </review>
  <review>
   <time>1637215605</time>
   <text>Conference rooms were well equipped.</text>
   <author_name>Joe Schmoe</author_name>
   <author_url>https://www.google.com/maps/contrib/105937236918123663309/reviews</author_url>
   <rating>1.0</rating>
   <language>en</language>
   <profile_photo_url>https://lh3.googleusercontent.com/a/AATXAJwZANdRSSg96QeZG--6BazG5uv_BJMIvpZGqwSz=s128-c0x00000000-cc-rp-mo</profile_photo_url>
   <relative_time_description>6 months ago</relative_time_description>
  </review>
  <!-- ... -->
  <opening_hours>
   <open_now>false</open_now>
   <period>
    <open>
     <day>1</day>
     <time>0900</time>
    </open>
    <close>
     <day>1</day>
     <time>1700</time>
    </close>
   </period>
   <period>
    <open>
     <day>2</day>
     <time>0900</time>
    </open>
    <close>
     <day>2</day>
     <time>1700</time>
    </close>
   </period>
   <period>
    <open>
     <day>3</day>
     <time>0900</time>
    </open>
    <close>
     <day>3</day>
     <time>1700</time>
    </close>
   </period>
   <period>
    <open>
     <day>4</day>
     <time>0900</time>
    </open>
    <close>
     <day>4</day>
     <time>1700</time>
    </close>
   </period>
   <period>
    <open>
     <day>5</day>
     <time>0900</time>
    </open>
    <close>
     <day>5</day>
     <time>1700</time>
    </close>
   </period>
   <weekday_text>Monday: 9:00 AM – 5:00 PM</weekday_text>
   <weekday_text>Tuesday: 9:00 AM – 5:00 PM</weekday_text>
   <weekday_text>Wednesday: 9:00 AM – 5:00 PM</weekday_text>
   <weekday_text>Thursday: 9:00 AM – 5:00 PM</weekday_text>
   <weekday_text>Friday: 9:00 AM – 5:00 PM</weekday_text>
   <weekday_text>Saturday: Closed</weekday_text>
   <weekday_text>Sunday: Closed</weekday_text>
  </opening_hours>
  <utc_offset>600</utc_offset>
  <photo>
   <photo_reference>Aap_uEDT4DC26Lk_VoI6CvsZl1NzU7BOPjEyqEHlf8tCA0hFtlrsI1Tmed_LmjSUQghWnZq-E7SsYZSlvGP0X5ZAfH6w0Tmw6biO4PPI8BTPwvo6FqLfZgC2RGNQyI81HRnJGB3ZJUAYEXvxBfA_upEcsITxk52joPkK9d7cfFptY0z-Oy7Y</photo_reference>
   <width>4032</width>
   <height>3024</height>
   <html_attribution>&lt;a href=&quot;https://maps.google.com/maps/contrib/117600448889234589608&quot;&gt;Cynthia Wei&lt;/a&gt;</html_attribution>
  </photo>
  <photo>
   <photo_reference>Aap_uEAPNVkxDxxHa0aRFAkA2gMygFUuaKujSSv-zdad_vuaxTkaDHgX-aVPeNATp7VEgwqa3A3QutoeKdDd6aGZPBPCLl8XTf1vYckEBxIWEXZjFlMXK2TwIVfe4qa6O31AbYQQ5TCrEs9nz2fuBBWJwifTiKIIrv4NrEpQok6i8nnn8xKS</photo_reference>
   <width>4912</width>
   <height>3264</height>
   <html_attribution>&lt;a href=&quot;https://maps.google.com/maps/contrib/102493344958625549078&quot;&gt;Heyang Li&lt;/a&gt;</html_attribution>
  </photo>
  <!-- ... -->
  <adr_address>&lt;span class=&quot;street-address&quot;&gt;48 Pirrama Rd&lt;/span&gt;, &lt;span class=&quot;locality&quot;&gt;Pyrmont&lt;/span&gt; &lt;span class=&quot;region&quot;&gt;NSW&lt;/span&gt; &lt;span class=&quot;postal-code&quot;&gt;2009&lt;/span&gt;, &lt;span class=&quot;country-name&quot;&gt;Australia&lt;/span&gt;</adr_address>
  <user_ratings_total>939</user_ratings_total>
  <place_id>ChIJN1t_tDeuEmsRUsoyG83frY4</place_id>
  <plus_code>
   <global_code>4RRH45MW+C8</global_code>
   <compound_code>45MW+C8 Pyrmont NSW, Australia</compound_code>
  </plus_code>
  <icon_background_color>#7B9EB0</icon_background_color>
  <business_status>OPERATIONAL</business_status>
  <icon_mask_base_uri>https://maps.gstatic.com/mapfiles/place_api/icons/v2/generic_pinlet</icon_mask_base_uri>
 </result>
</PlaceDetailsResponse>

Las respuestas JSON y XML contienen los siguientes elementos:

PlacesDetailsResponse

Campo	Obligatorio	Tipo	Descripción
`html_attributions`	required	Array<string>	Puede contener un conjunto de atribuciones sobre esta ficha que se deben mostrar al usuario (es posible que algunas fichas no tengan atribución).
`result`	required	Place	Contiene información detallada sobre el lugar solicitado. Consulta Lugar para obtener más información.
`status`	required	PlacesDetailsStatus	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 PlacesDetailsStatus para obtener más información.
`info_messages`	opcional	Array<string>	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.

En una respuesta JSON, se representan como elementos raíz. En una respuesta XML, estos aparecen como elementos de nivel superior debajo de <PlaceDetailsResponse>.

PlacesDetailsStatus

Códigos de estado que devuelve el servicio.

OK: Indica que la solicitud a la API se realizó correctamente.
ZERO_RESULTS indica que la ubicación a la que se hace referencia, place_id, era válida, pero ya no hace referencia a un resultado válido. Esto puede ocurrir si el establecimiento ya no está en actividad.
NOT_FOUND indica que la ubicación a la que se hace referencia, place_id, no se encontró en la base de datos de Places.
INVALID_REQUEST: Indica que la solicitud a la API tiene un formato incorrecto.
OVER_QUERY_LIMIT que indique 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, una tarjeta de crédito venció).
Consulta las Preguntas frecuentes sobre 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

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

Campo	Obligatorio	Tipo	Descripción
`address_components`	opcional	Array<`AddressComponent`>	Es un array que incluye los componentes independientes aplicables a esta dirección. Consulta `AddressComponent` para obtener más información.
`adr_address`	opcional	string	Es una representación de la dirección del lugar en el microformato adr.
`business_status`	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`
`curbside_pickup`	opcional	booleano	Especifica si la empresa admite el retiro en la puerta.
`current_opening_hours`	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.
`delivery`	opcional	booleano	Especifica si la empresa admite entregas.
`dine_in`	opcional	booleano	Especifica si la empresa ofrece opciones de mesas en interiores o al aire libre.
`editorial_summary`	opcional	PlaceEditorialSummary	Contiene un resumen del lugar. Un resumen consta de una descripción general textual y también incluye el código de idioma para estos, si corresponde. El texto de resumen se debe presentar tal como está y no se puede modificar ni alterar. Consulta PlaceEditorialSummary para obtener más información.
`formatted_address`	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, en algunos países, como los que integran el Reino Unido, no se permite 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 los EE.UU.). No analices la dirección con formato por vía programática. En cambio, utiliza los componentes individuales de la dirección, que la respuesta de la API incluye además del campo de dirección con formato.
`formatted_phone_number`	opcional	string	Contiene el número de teléfono del lugar en su formato local.
`geometry`	opcional	`Geometry`	Contiene la ubicación y el viewport de la ubicación. Consulta `Geometry` para obtener más información.
`icon`	opcional	string	Contiene la URL de un ícono sugerido que se puede mostrar al usuario cuando se indica este resultado en un mapa.
`icon_background_color`	opcional	string	Contiene el código de color hexadecimal predeterminado para la categoría del lugar.
`icon_mask_base_uri`	opcional	string	Contiene la URL de un ícono recomendado, menos la extensión de tipo de archivo `.svg` o `.png`.
`international_phone_number`	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 valor de international_phone_number para la oficina de Google en Sídney, Australia, es `+61 2 9374 4000`.
`name`	opcional	string	Contiene el nombre legible por humanos del resultado que se muestra. Para los resultados de `establishment`, suele ser el nombre canónico de la empresa.
`opening_hours`	opcional	PlaceOpeningHours	Contiene el horario de atención habitual. Consulta PlaceOpeningHours para obtener más información.
`permanently_closed`	opcional	booleano	`permanently_closed` dejó de estar disponible. Usa `business_status` para conocer el estado operativo de las empresas.
`photos`	opcional	Array<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. Puedes encontrar más información sobre las fotos de lugares y cómo puedes usar las imágenes en tu aplicación en la documentación de Place Photos. Consulta PlacePhoto para obtener más información.
`place_id`	opcional	string	un identificador textual que identifica de forma exclusiva un sitio. Para obtener 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.
`plus_code`	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 los lugares donde estas no existen (donde los edificios no están numerados o las calles no tienen nombre). Consulta Open Location Code y Plus Codes. Consulta `PlusCode` para obtener más información.
`price_level`	opcional	número	Es el nivel de precios del lugar, en una escala de 0 a 4. La cantidad exacta indicada 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 Moderado 3 Costoso 4 Muy costoso
`rating`	opcional	número	Contiene la calificación del lugar, de 1.0 a 5.0, según las opiniones agregadas de los usuarios.
`reference`	opcional	string	`reference` ya no está disponible.
`reservable`	opcional	booleano	Especifica si el lugar admite reservas.
`reviews`	opcional	Array<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 ordenació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. Para `newest`, las opiniones se ordenan de forma cronológica; el idioma preferido no afecta el orden. Google recomienda indicarles a los usuarios si los resultados se ordenan por `most_relevant` o `newest`. Consulta PlaceReview para obtener más información.
`scope`	opcional	string	`scope` ya no está disponible.
`secondary_opening_hours`	opcional	Array<PlaceOpeningHours>	Contiene un array de entradas para los próximos siete días, incluida la 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 propaga el subcampo `type`, que se extrae de una lista predefinida de tipos de horarios de atención (como `DRIVE_THROUGH`, `PICKUP` o `TAKEOUT`) según los tipos de lugar. Este campo incluye el subcampo `special_days` de todos los horarios, establecido para las fechas que tienen horarios excepcionales. Consulta PlaceOpeningHours para obtener más información.
`serves_beer`	opcional	booleano	Especifica si en el lugar se sirve cerveza.
`serves_breakfast`	opcional	booleano	Especifica si el lugar ofrece desayuno.
`serves_brunch`	opcional	booleano	Especifica si el lugar ofrece brunch.
`serves_dinner`	opcional	booleano	Especifica si el lugar ofrece opciones para cenar.
`serves_lunch`	opcional	booleano	Especifica si el lugar ofrece opciones para almorzar.
`serves_vegetarian_food`	opcional	booleano	Especifica si el lugar ofrece comida vegetariana.
`serves_wine`	opcional	booleano	Especifica si en el lugar se sirve vino.
`takeout`	opcional	booleano	Especifica si la empresa admite comida para llevar.
`types`	opcional	Array<string>	Contiene un array de tipos de componentes que describen el resultado determinado. Consulta la lista de tipos admitidos.
`url`	opcional	string	Contiene la URL de la página oficial de Google del lugar. Esta será la página de Google que contiene la mejor información disponible acerca del 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.
`user_ratings_total`	opcional	número	Es la cantidad total de opiniones, con o sin texto, de este lugar.
`utc_offset`	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).
`vicinity`	opcional	string	Para los resultados de establecimientos (`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 del componente político (`types:["political", ...]`) más específico 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.
`website`	opcional	string	Es el sitio web autorizado para este lugar, por ejemplo, la página principal de una empresa.
`wheelchair_accessible_entrance`	opcional	booleano	Especifica si el lugar tiene una entrada accesible para personas en silla de ruedas.

PlaceEditorialSummary

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

Campo	Obligatorio	Tipo	Descripción
`language`	opcional	string	Es el idioma de los campos anteriores. Es posible que no siempre esté presente.
`overview`	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
`open_now`	opcional	booleano	Es un valor booleano que indica si el lugar está abierto en ese momento.
`periods`	opcional	Array<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.
`special_days`	opcional	Array<PlaceSpecialDay>	Es un array de hasta siete entradas correspondientes a los próximos siete días. Consulta PlaceSpecialDay para obtener más información.
`type`	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	Array<string>	Es un array de cadenas que describe en texto legible por humanos el horario del lugar.

PlaceOpeningHoursPeriod

Campo	Obligatorio	Tipo	Descripción
`open`	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.
`close`	opcional	PlaceOpeningHoursPeriodDetail	Puede contener un par de objetos de día y hora que indican cuándo cierra el lugar. Si un lugar está siempre abierto, la sección de cierre no aparecerá en la respuesta. Los clientes pueden requerir que la indicación "siempre abierto" se represente como un período abierto con el valor `0` en day y `0000` en time, y que no se indique un elemento `close`. Consulta PlaceOpeningHoursPeriodDetail para obtener más información.

PlaceSpecialDay

Campo	Obligatorio	Tipo	Descripción
`date`	opcional	string	Es una fecha expresada en formato RFC3339 en la zona horaria local del lugar, por ejemplo, 2010-12-31.
`exceptional_hours`	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 los horarios, y estos se usan para generar los otros campos.

PlaceOpeningHoursPeriodDetail

Campo	Obligatorio	Tipo	Descripción
`day`	required	número	Es un número del 0 al 6 que corresponde a los días de la semana a partir del domingo. Por ejemplo, "2" significa "martes".
`time`	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.
`date`	opcional	string	Es una fecha expresada en formato RFC3339 en la zona horaria local del lugar, por ejemplo, 2010-12-31.
`truncated`	opcional	booleano	Es verdadero si un período determinado se truncó debido a un límite 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 Place Photos para obtener más información.

Campo	Obligatorio	Tipo	Descripción
`height`	required	número	Es la altura de la foto.
`html_attributions`	required	Array<string>	Son las atribuciones HTML de la foto.
`photo_reference`	required	string	Es una cadena que se usa para identificar la foto cuando realizas una solicitud de foto.
`width`	required	número	Es el ancho de la foto.

PlaceReview

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

Campo	Obligatorio	Tipo	Descripción
`author_name`	required	string	Es el nombre del usuario que envió la opinión. Las opiniones anónimas se atribuyen a "Un usuario de Google".
`rating`	required	número	Es la calificación general del usuario para este lugar. Se representa con un número entero del 1 al 5.
`relative_time_description`	required	string	Es la hora en que se envió la opinión en formato de texto, en relación con la hora actual.
`time`	required	número	Es la 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).
`author_url`	opcional	string	Es la URL del perfil de Local Guides de Google Maps del usuario, si está disponible.
`language`	opcional	string	Es un código de idioma IETF que indica el idioma de la opinión que se muestra.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.
`original_language`	opcional	string	Es un código de idioma IETF que indica el idioma original de la opinión. Si se tradujo la opinión, entonces `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.
`profile_photo_url`	opcional	string	Es la URL de la foto de perfil del usuario, si está disponible.
`text`	opcional	string	Es la opinión del usuario. Cuando se revisa 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 lenguaje de marcado HTML básico. Por ejemplo, la referencia de entidad `&` puede representar un carácter de signo de unión.
`translated`	opcional	booleano	Es un valor booleano que indica si la opinión se tradujo del idioma original en el que se escribió.Si se tradujo una opinión, lo que corresponde a un valor de verdadero, Google recomienda que se lo indiques a tus usuarios. Por ejemplo, puedes agregar la siguiente cadena, "Traducido por Google", a la opinión.

Place Details (heredado) Organiza tus páginas con colecciones Guarda y categoriza el contenido según tus preferencias.

Solicitudes de Place Details (heredado)

Parámetros obligatorios

place_id

Parámetros opcionales

campos

idioma

región

reviews_no_translations

reviews_sort

sessiontoken

Ejemplo de Place Details (heredado)

Almeja

HTTP

Respuesta de Place Details (heredado)

JSON

XML

PlacesDetailsResponse

html_attributions

result

status

info_messages

PlacesDetailsStatus

Lugar

address_components

adr_address

business_status

curbside_pickup

current_opening_hours

delivery

dine_in

editorial_summary

formatted_address

formatted_phone_number

geometry

icon

icon_background_color

icon_mask_base_uri

international_phone_number

name

opening_hours

permanently_closed

photos

place_id

plus_code

price_level

rating

reference

reservable

reviews

scope

secondary_opening_hours

serves_beer

serves_breakfast

serves_brunch

serves_dinner

serves_lunch

serves_vegetarian_food

serves_wine

takeout

types

url

user_ratings_total

utc_offset

vicinity

website

wheelchair_accessible_entrance

PlaceEditorialSummary

language

overview

PlaceOpeningHours

open_now

periods

special_days

type

weekday_text

PlaceOpeningHoursPeriod

open

close

PlaceSpecialDay

Place Details (heredado)

`html_attributions`

`result`

`status`

`info_messages`

`address_components`

`adr_address`

`business_status`

`curbside_pickup`

`current_opening_hours`

`delivery`

`dine_in`

`editorial_summary`

`formatted_address`

`formatted_phone_number`

`geometry`

`icon`

`icon_background_color`

`icon_mask_base_uri`

`international_phone_number`

`name`

`opening_hours`

`permanently_closed`

`photos`

`place_id`

`plus_code`

`price_level`

`rating`

`reference`

`reservable`

`reviews`

`scope`

`secondary_opening_hours`

`serves_beer`

`serves_breakfast`

`serves_brunch`

`serves_dinner`

`serves_lunch`

`serves_vegetarian_food`

`serves_wine`

`takeout`

`types`

`url`

`user_ratings_total`

`utc_offset`

`vicinity`

`website`

`wheelchair_accessible_entrance`

`language`

`overview`

`open_now`

`periods`

`special_days`

`type`

`weekday_text`

`open`

`close`

`date`

`exceptional_hours`

`day`

`time`

`date`

`truncated`

`height`

`html_attributions`

`photo_reference`

`width`

`author_name`

`rating`

`relative_time_description`

`time`

`author_url`

`language`

`original_language`

`profile_photo_url`

`text`

`translated`