Búsqueda de lugares cercanos (heredada)

Desarrolladores del Espacio Económico Europeo (EEE)

Nearby Search (Legacy) te permite buscar lugares en un área específica. Puedes refinar tu solicitud de búsqueda proporcionando palabras clave o especificando el tipo de lugar que buscas.

Solicitudes de Nearby Search (heredado)

Una solicitud de Nearby Search (Legacy) es una URL HTTP con el siguiente formato:

https://maps.googleapis.com/maps/api/place/nearbysearch/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 Nearby Search (Legacy). Tal como es práctica estándar para las URLs, todos los parámetros se separan usando el signo et (&).

Parámetros obligatorios

  • ubicación

    Es el punto alrededor del cual se recupera la información del lugar. Debe especificarse como latitude,longitude.

  • radio

    Define la distancia (en metros) dentro de la cual se deben devolver los resultados de lugares. Puedes personalizar los resultados para un círculo específico si pasas los parámetros location y radius. Si lo haces, le indicas al servicio Places que prefiera mostrar resultados dentro de ese círculo. Es posible que también se muestren resultados fuera del área definida.

    El radio se ajustará automáticamente a un valor máximo según el tipo de búsqueda y otros parámetros.

    • Autocompletar: 50,000 metros
    • Nearby Search:
      • Con keyword o name: 50,000 metros
      • sin keyword o name
        • Hasta 50,000 metros, ajustado de forma dinámica según la densidad del área, independientemente del parámetro rankby.
        • Cuando se usa rankby=distance, no se aceptará el parámetro de radio y se generará un INVALID_REQUEST.
    • Query Autocomplete: 50,000 metros
    • Text Search: 50,000 metros

Parámetros opcionales

  • palabra clave

    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. El servicio de Google Places devolverá posibles coincidencias en función de esta cadena y ordenará los resultados según la relevancia percibida.

    Incluir explícitamente información de ubicación con este parámetro puede entrar en conflicto con los parámetros location, radius y rankby, lo que generará resultados inesperados.

    Si se omite este parámetro, no se devolverán los lugares con un business_status de CLOSED_TEMPORARILY o CLOSED_PERMANENTLY.

  • 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.

  • maxprice

    Restringe los resultados a los lugares que se encuentran dentro del rango especificado. Los valores válidos se encuentran en el rango que se extiende de 0 (más asequible) a 4 (más costoso), inclusive. El importe exacto que indica un valor específico variará de una región a otra.

  • minprice

    Restringe los resultados a los lugares que se encuentran dentro del rango especificado. Los valores válidos se encuentran en el rango que se extiende de 0 (más asequible) a 4 (más costoso), inclusive. El importe exacto que indica un valor específico variará de una región a otra.

  • nombre

    Equivale a keyword. Los valores de este campo se combinan con los del campo keyword y se pasan como parte de la misma cadena de búsqueda.

  • opennow

    Devuelve solo los lugares que están abiertos en el momento en que se envía la consulta. Los lugares que no especifican los horarios de atención en la base de datos de Google Places no se mostrarán si incluyes este parámetro en tu búsqueda.

  • pagetoken

    Devuelve hasta 20 resultados de una búsqueda ejecutada anteriormente. Si se configura un parámetro pagetoken, se ejecutará una búsqueda con los mismos parámetros que se usaron anteriormente. Se ignorarán todos los parámetros, excepto pagetoken.

  • rankby

    Especifica el orden en que se enumeran los resultados. Los valores posibles son:

    • prominence (predeterminado): Esta opción ordena los resultados según su importancia. La clasificación dará prioridad a los lugares más relevantes dentro del radio establecido sobre los lugares cercanos que coinciden con la búsqueda pero son menos relevantes. La relevancia puede verse afectada por la clasificación de un lugar en el índice de Google, la popularidad global y otros factores. Cuando se especifica la prominencia, el parámetro radius es obligatorio.
    • distance. Esta opción sesga los resultados de la búsqueda en orden ascendente según su distancia desde la ubicación especificada. Cuando se especifica distance, se requiere uno o más de keyword, name o type, y no se permite radius.

  • tipo

    Restringe los resultados a los lugares que coinciden con el tipo especificado. Solo se puede especificar un tipo. Si se proporciona más de un tipo, se ignoran todos los siguientes a la primera entrada.

    • type=hospital|pharmacy|doctor se convierte en type=hospital
    • Se ignora por completo type=hospital,pharmacy,doctor.

    Consulta la lista de tipos admitidos.

    Nota: Agregar keyword y type con el mismo valor (keyword=cafe&type=cafe o keyword=parking&type=parking) puede generar ZERO_RESULTS.

Ejemplo de Nearby Search (heredada)

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/place/nearbysearch/json?location=-33.8670522%2C151.1957362&radius=1500&type=restaurant&keyword=cruise&key=YOUR_API_KEY'

HTTP

https://maps.googleapis.com/maps/api/place/nearbysearch/json
  ?keyword=cruise
  &location=-33.8670522%2C151.1957362
  &radius=1500
  &type=restaurant
  &key=YOUR_API_KEY

Nota: En este ejemplo, debes reemplazar key por tu propia clave de API para que la solicitud funcione en tu aplicación.

Respuestas de Nearby Search (heredado)

En el siguiente ejemplo, se muestra una respuesta de Nearby Search (Legacy).

JSON

{
  "html_attributions": [],
  "results":
    [
      {
        "business_status": "OPERATIONAL",
        "geometry":
          {
            "location": { "lat": -33.8587323, "lng": 151.2100055 },
            "viewport":
              {
                "northeast":
                  { "lat": -33.85739847010727, "lng": 151.2112436298927 },
                "southwest":
                  { "lat": -33.86009812989271, "lng": 151.2085439701072 },
              },
          },
        "icon": "https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/bar-71.png",
        "icon_background_color": "#FF9E67",
        "icon_mask_base_uri": "https://maps.gstatic.com/mapfiles/place_api/icons/v2/bar_pinlet",
        "name": "Cruise Bar",
        "opening_hours": { "open_now": false },
        "photos":
          [
            {
              "height": 608,
              "html_attributions":
                [
                  'A Google User',
                ],
              "photo_reference": "Aap_uECvJIZuXT-uLDYm4DPbrV7gXVPeplbTWUgcOJ6rnfc4bUYCEAwPU_AmXGIaj0PDhWPbmrjQC8hhuXRJQjnA1-iREGEn7I0ZneHg5OP1mDT7lYVpa1hUPoz7cn8iCGBN9MynjOPSUe-UooRrFw2XEXOLgRJ-uKr6tGQUp77CWVocpcoG",
              "width": 1080,
            },
          ],
        "place_id": "ChIJi6C1MxquEmsR9-c-3O48ykI",
        "plus_code":
          {
            "compound_code": "46R6+G2 The Rocks, New South Wales",
            "global_code": "4RRH46R6+G2",
          },
        "price_level": 2,
        "rating": 4,
        "reference": "ChIJi6C1MxquEmsR9-c-3O48ykI",
        "scope": "GOOGLE",
        "types":
          ["bar", "restaurant", "food", "point_of_interest", "establishment"],
        "user_ratings_total": 1269,
        "vicinity": "Level 1, 2 and 3, Overseas Passenger Terminal, Circular Quay W, The Rocks",
      },
      {
        "business_status": "OPERATIONAL",
        "geometry":
          {
            "location": { "lat": -33.8675219, "lng": 151.2016502 },
            "viewport":
              {
                "northeast":
                  { "lat": -33.86614532010728, "lng": 151.2031259298927 },
                "southwest":
                  { "lat": -33.86884497989272, "lng": 151.2004262701072 },
              },
          },
        "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",
        "name": "Sydney Harbour Dinner Cruises",
        "opening_hours": { "open_now": true },
        "photos":
          [
            {
              "height": 835,
              "html_attributions":
                [
                  'A Google User',
                ],
              "photo_reference": "Aap_uEBVsYnNcrpRixtrlHBztigZh70CwYkNWZzQnqJ39SjeBo_wvgKf-kXc6tgaMLBdQrRKmxmSKjOezoZrv-sHKVbTX0OI48HBqYYVnQiZQ-WGeuQDsLEPwX7LaVPa68nUAxX114Zpqt7bryoO9wL4qXdgEnopbOp5WWLALhKEHoIEH7f7",
              "width": 1200,
            },
          ],
        "place_id": "ChIJM1mOVTS6EmsRKaDzrTsgids",
        "plus_code":
          {
            "compound_code": "46J2+XM Sydney, New South Wales",
            "global_code": "4RRH46J2+XM",
          },
        "rating": 4.8,
        "reference": "ChIJM1mOVTS6EmsRKaDzrTsgids",
        "scope": "GOOGLE",
        "types":
          [
            "tourist_attraction",
            "travel_agency",
            "restaurant",
            "food",
            "point_of_interest",
            "establishment",
          ],
        "user_ratings_total": 9,
        "vicinity": "32 The Promenade, Sydney",
      },
      {
        "business_status": "OPERATIONAL",
        "geometry":
          {
            "location": { "lat": -33.8676569, "lng": 151.2017213 },
            "viewport":
              {
                "northeast":
                  { "lat": -33.86629922010728, "lng": 151.2031712798927 },
                "southwest":
                  { "lat": -33.86899887989272, "lng": 151.2004716201073 },
              },
          },
        "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",
        "name": "Clearview Sydney Harbour Cruises",
        "opening_hours": { "open_now": false },
        "photos":
          [
            {
              "height": 685,
              "html_attributions":
                [
                  'Clearview Glass Boat Cruises',
                ],
              "photo_reference": "Aap_uEAlExjnXA0VWyb_oYwCJ8utWG_Ennhwmn_xadpgenMNUgTuxrvgf1Xdw4bsbL6kFSWH7bhbpVHK1esdNY37ancJvbL_Gnsc7EZ5KEBNPvYZ_ZEyLco4a5v34LFkodxfFZbJ-ejO3zN4W_0C37P5jAmTnLWMNFYUPvoU3UMi70qHRNF5",
              "width": 1024,
            },
          ],
        "place_id": "ChIJNQfwZTiuEmsR1m1x9w0E2V0",
        "plus_code":
          {
            "compound_code": "46J2+WM Sydney, New South Wales",
            "global_code": "4RRH46J2+WM",
          },
        "rating": 3.8,
        "reference": "ChIJNQfwZTiuEmsR1m1x9w0E2V0",
        "scope": "GOOGLE",
        "types":
          [
            "travel_agency",
            "restaurant",
            "food",
            "point_of_interest",
            "establishment",
          ],
        "user_ratings_total": 49,
        "vicinity": "32 The Promenade King Street Wharf 5, Sydney",
      },
      {
        "business_status": "OPERATIONAL",
        "geometry":
          {
            "location": { "lat": -33.8677035, "lng": 151.2017297 },
            "viewport":
              {
                "northeast":
                  { "lat": -33.86634597010728, "lng": 151.2031781298927 },
                "southwest":
                  { "lat": -33.86904562989272, "lng": 151.2004784701072 },
              },
          },
        "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",
        "name": "Sydney Harbour Lunch Cruise",
        "opening_hours": { "open_now": false },
        "photos":
          [
            {
              "height": 545,
              "html_attributions":
                [
                  'Sydney Harbour Lunch Cruise',
                ],
              "photo_reference": "Aap_uEBFyQ2xDzHk7dGF_FTvNeJ01NQD6GROq89rufdGQl5Gi0zVfpnETBjPK2v7UEDl_6F-m8aR5FcEWJMqPaH4Oh_CQh2jaUAUAesUInucpCe7OFdleSYJ_8kgunhsIvGf1D1s_pes6Rk2JMVEs8rEs6ZHSTmUQXX2Yh-Gt9MuPQdYNuNv",
              "width": 969,
            },
          ],
        "place_id": "ChIJUbf3iDiuEmsROJxXbhYO7cM",
        "plus_code":
          {
            "compound_code": "46J2+WM Sydney, New South Wales",
            "global_code": "4RRH46J2+WM",
          },
        "rating": 3.9,
        "reference": "ChIJUbf3iDiuEmsROJxXbhYO7cM",
        "scope": "GOOGLE",
        "types":
          [
            "travel_agency",
            "restaurant",
            "food",
            "point_of_interest",
            "establishment",
          ],
        "user_ratings_total": 23,
        "vicinity": "5/32 The Promenade, Sydney",
      },
      {
        "business_status": "OPERATIONAL",
        "geometry":
          {
            "location": { "lat": -33.8675883, "lng": 151.2016452 },
            "viewport":
              {
                "northeast":
                  { "lat": -33.86623847010728, "lng": 151.2029950298927 },
                "southwest":
                  { "lat": -33.86893812989273, "lng": 151.2002953701073 },
              },
          },
        "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",
        "name": "Sydney Showboats - Dinner Cruise With Show",
        "opening_hours": { "open_now": false },
        "photos":
          [
            {
              "height": 4912,
              "html_attributions":
                [
                  'A Google User',
                ],
              "photo_reference": "Aap_uED1aGaMs8xYfiuzeBqVcFsk3yguUujdE4S3rNThMpLtoU0RukF40KCt0CAxgHP1HoY8Z7NYcWvax6qmMMVPBbmzGhoaiwiAAyv2GGA9vhcgsJ5w0LweT0y1lgRGZxU3nZIdNLiYAp9JHM171UkN04H6UqYSxKVZ8N_f2aslkqOaBF_e",
              "width": 7360,
            },
          ],
        "place_id": "ChIJjRuIiTiuEmsRCHhYnrWiSok",
        "plus_code":
          {
            "compound_code": "46J2+XM Sydney, New South Wales",
            "global_code": "4RRH46J2+XM",
          },
        "rating": 4.1,
        "reference": "ChIJjRuIiTiuEmsRCHhYnrWiSok",
        "scope": "GOOGLE",
        "types":
          [
            "travel_agency",
            "restaurant",
            "food",
            "point_of_interest",
            "establishment",
          ],
        "user_ratings_total": 119,
        "vicinity": "32 The Promenade, King Street Wharf, 5, Sydney",
      },
      {
        "business_status": "OPERATIONAL",
        "geometry":
          {
            "location": { "lat": -33.8677035, "lng": 151.2017297 },
            "viewport":
              {
                "northeast":
                  { "lat": -33.86634597010728, "lng": 151.2031781298927 },
                "southwest":
                  { "lat": -33.86904562989272, "lng": 151.2004784701072 },
              },
          },
        "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",
        "name": "Magistic Cruises",
        "opening_hours": { "open_now": true },
        "photos":
          [
            {
              "height": 1536,
              "html_attributions":
                [
                  'A Google User',
                ],
              "photo_reference": "Aap_uEC8bq-YphfIDcdxANBfgGMBIX2B0ggNep9ddVoePj6sfdcdusIn07x8biaxevZ_6BpzDDRsUL8No5P3ftI4on_pqbAbIEUL5gFGgezpVZ3M9GWvKdJm3njO_aJaghWl4_aQb75c0WGYDRFPhn6fWsLkD7KxodviJeCX4OCGt1eRJnlK",
              "width": 2048,
            },
          ],
        "place_id": "ChIJxRjqYTiuEmsRGebAA_chDLE",
        "plus_code":
          {
            "compound_code": "46J2+WM Sydney, New South Wales",
            "global_code": "4RRH46J2+WM",
          },
        "rating": 3.9,
        "reference": "ChIJxRjqYTiuEmsRGebAA_chDLE",
        "scope": "GOOGLE",
        "types":
          [
            "tourist_attraction",
            "travel_agency",
            "restaurant",
            "food",
            "point_of_interest",
            "establishment",
          ],
        "user_ratings_total": 99,
        "vicinity": "King Street Wharf, 32 The Promenade, Sydney",
      },
      {
        "business_status": "OPERATIONAL",
        "geometry":
          {
            "location": { "lat": -33.8609391, "lng": 151.2098735 },
            "viewport":
              {
                "northeast":
                  { "lat": -33.85958927010727, "lng": 151.2112233298927 },
                "southwest":
                  { "lat": -33.86228892989272, "lng": 151.2085236701072 },
              },
          },
        "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",
        "name": "Australian Cruise Group",
        "opening_hours": { "open_now": false },
        "photos":
          [
            {
              "height": 1536,
              "html_attributions":
                [
                  'Keith Bauman',
                ],
              "photo_reference": "Aap_uED7aBwIbN6iuoZi8e9xCrt6F_EhppGCBfzYCgypetw8cGn4Ui0Y3JZe3QJ0buf0zc54BtPz-SWXxecPd6kDvNNZD5Eu_ZzTP13rXMzSDJa6UcwFiXU4y3qYrWAyJ6mtYrd2PJgw0KzvYaZoPze7Ka6zG6k3IOjeSICDYH6YOzkXhelj",
              "width": 2048,
            },
          ],
        "place_id": "ChIJpU8KgUKuEmsRKErVGEaa11w",
        "plus_code":
          {
            "compound_code": "46Q5+JW Sydney, New South Wales",
            "global_code": "4RRH46Q5+JW",
          },
        "rating": 4.4,
        "reference": "ChIJpU8KgUKuEmsRKErVGEaa11w",
        "scope": "GOOGLE",
        "types":
          [
            "travel_agency",
            "restaurant",
            "food",
            "point_of_interest",
            "establishment",
          ],
        "user_ratings_total": 5,
        "vicinity": "6 Cirular Quay, Sydney",
      },
      {
        "business_status": "OPERATIONAL",
        "geometry":
          {
            "location": { "lat": -33.8686058, "lng": 151.2018206 },
            "viewport":
              {
                "northeast":
                  { "lat": -33.86730002010728, "lng": 151.2032717798927 },
                "southwest":
                  { "lat": -33.86999967989272, "lng": 151.2005721201073 },
              },
          },
        "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",
        "name": "Rhythmboat Cruises",
        "opening_hours": { "open_now": false },
        "photos":
          [
            {
              "height": 2269,
              "html_attributions":
                [
                  'Rhythmboat Sydney Harbour Cruises',
                ],
              "photo_reference": "Aap_uEAT8eop-IsfSAQ3KP6YXRNRsFkESXDecsaPnaVhq5bZzny5guvhS4smciianRGbZgDtFtAcU-ZXTaBfuh80CFw8vpJyKaB4grgW_CW64rU1JF9FDy_M8HtEk3rOrMhPDiF8ns-mc16E4rWSuAQIc76Du_eCd63ofoErESOtSWAQVcew",
              "width": 4032,
            },
          ],
        "place_id": "ChIJyWEHuEmuEmsRm9hTkapTCrk",
        "plus_code":
          {
            "compound_code": "46J2+HP Sydney, New South Wales",
            "global_code": "4RRH46J2+HP",
          },
        "rating": 3.9,
        "reference": "ChIJyWEHuEmuEmsRm9hTkapTCrk",
        "scope": "GOOGLE",
        "types":
          [
            "travel_agency",
            "restaurant",
            "food",
            "point_of_interest",
            "establishment",
          ],
        "user_ratings_total": 30,
        "vicinity": "King Street Wharf, King St, Sydney",
      },
      {
        "business_status": "OPERATIONAL",
        "geometry":
          {
            "location": { "lat": -33.8712692, "lng": 151.1898651 },
            "viewport":
              {
                "northeast":
                  { "lat": -33.86952792010727, "lng": 151.1914560298927 },
                "southwest":
                  { "lat": -33.87222757989272, "lng": 151.1887563701073 },
              },
          },
        "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",
        "name": "Glass Island",
        "opening_hours": { "open_now": false },
        "photos":
          [
            {
              "height": 4480,
              "html_attributions":
                [
                  'A Google User',
                ],
              "photo_reference": "Aap_uEAaToCBaHP7Gfdjc740gwIkQcjeUD97NO0TKXJ5IXB0CLGQA6slEpHn4k9LwyhoAzzbSTXJduYyFIkHVmQWGp34NggRxrtOWp7sJf5N6j0ASYlJPmAtWUaaCWnbx_pxdndsopeJ7PYn9kTiMgFcSs-GeipI8hDZgAJswMBnfsO0xWQ-",
              "width": 6720,
            },
          ],
        "place_id": "ChIJnScuboavEmsRyh-FGxhc3pw",
        "plus_code":
          {
            "compound_code": "45HQ+FW Pyrmont, New South Wales",
            "global_code": "4RRH45HQ+FW",
          },
        "rating": 4.1,
        "reference": "ChIJnScuboavEmsRyh-FGxhc3pw",
        "scope": "GOOGLE",
        "types":
          ["bar", "restaurant", "food", "point_of_interest", "establishment"],
        "user_ratings_total": 90,
        "vicinity": "37 Bank St, Pyrmont",
      },
      {
        "business_status": "OPERATIONAL",
        "geometry":
          {
            "location": { "lat": -33.85876140000001, "lng": 151.2100004 },
            "viewport":
              {
                "northeast":
                  { "lat": -33.85737742010728, "lng": 151.2111319298927 },
                "southwest":
                  { "lat": -33.86007707989272, "lng": 151.2084322701072 },
              },
          },
        "icon": "https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/restaurant-71.png",
        "icon_background_color": "#FF9E67",
        "icon_mask_base_uri": "https://maps.gstatic.com/mapfiles/place_api/icons/v2/restaurant_pinlet",
        "name": "Junk Lounge",
        "opening_hours": { "open_now": false },
        "photos":
          [
            {
              "height": 608,
              "html_attributions":
                [
                  'A Google User',
                ],
              "photo_reference": "Aap_uEDaHF9VZFV88tQqFyIgmPlcbCsK-ScCGuUVGh0mTAP4OzWh_0q0T5rPbeC7bas7vD5vC9oS95jtdr4oOnQmhGDAIbHkv4E6UHrQIl0f3XZ-3-RRDjn293w4qQb_BfhbPPO3nokU7npfMfVvCcelWf9WHiWNHT4EEHrFtvuhAWKobTnC",
              "width": 1080,
            },
          ],
        "place_id": "ChIJq9W3HZOvEmsRYtKNTRmq34M",
        "plus_code":
          {
            "compound_code": "46R6+F2 The Rocks, New South Wales",
            "global_code": "4RRH46R6+F2",
          },
        "price_level": 2,
        "rating": 4.1,
        "reference": "ChIJq9W3HZOvEmsRYtKNTRmq34M",
        "scope": "GOOGLE",
        "types": ["restaurant", "food", "point_of_interest", "establishment"],
        "user_ratings_total": 63,
        "vicinity": "Level 2, Overseas Passenger Terminal, Circular Quay W, The Rocks",
      },
      {
        "business_status": "OPERATIONAL",
        "geometry":
          {
            "location": { "lat": -33.8677035, "lng": 151.2017297 },
            "viewport":
              {
                "northeast":
                  { "lat": -33.86634597010728, "lng": 151.2031781298927 },
                "southwest":
                  { "lat": -33.86904562989272, "lng": 151.2004784701072 },
              },
          },
        "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",
        "name": "Sydney New Year's Eve Cruises",
        "opening_hours": { "open_now": true },
        "photos":
          [
            {
              "height": 1600,
              "html_attributions":
                [
                  'A Google User',
                ],
              "photo_reference": "Aap_uEDceKHtQ9Hf2eHwnQYXLqrwZ1X2LYVhsfXbqrpIm3_lXZ9apURjAXtVgRVTGxJPD7BtaqR8C7bwaSTakmi0Pazn7g3suj8ZaQRBqheT3KVJDhZ9_GwVInLkWbxqnhivEXs1a-MC_J8XF1SL_5AQ3mAETgiLRQ04116IAEV5vHyIGRsa",
              "width": 2400,
            },
          ],
        "place_id": "ChIJ__8_hziuEmsR27ucFXECfOg",
        "plus_code":
          {
            "compound_code": "46J2+WM Sydney, New South Wales",
            "global_code": "4RRH46J2+WM",
          },
        "rating": 5,
        "reference": "ChIJ__8_hziuEmsR27ucFXECfOg",
        "scope": "GOOGLE",
        "types":
          [
            "travel_agency",
            "restaurant",
            "food",
            "point_of_interest",
            "establishment",
          ],
        "user_ratings_total": 5,
        "vicinity": "King Street Wharf 5, 32 The Promenade, Sydney",
      },
      {
        "business_status": "OPERATIONAL",
        "geometry":
          {
            "location": { "lat": -33.8669866, "lng": 151.2017231 },
            "viewport":
              {
                "northeast":
                  { "lat": -33.86563197010727, "lng": 151.2031347298927 },
                "southwest":
                  { "lat": -33.86833162989272, "lng": 151.2004350701073 },
              },
          },
        "icon": "https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/generic_business-71.png",
        "icon_background_color": "#13B5C7",
        "icon_mask_base_uri": "https://maps.gstatic.com/mapfiles/place_api/icons/v2/generic_pinlet",
        "name": "King Street Wharf Darling Harbour",
        "opening_hours": { "open_now": true },
        "photos":
          [
            {
              "height": 3024,
              "html_attributions":
                [
                  '朱品貞',
                ],
              "photo_reference": "Aap_uEDwKXVOjIaCj3LptOdd86B5umsdG7Z3jcvqcpUVLwHS6w8VGEkphgC8-shAx95CrsuXpnKz-XVIixVmgagQHKPH3vSLLqJ6LOAR7Q-_jiyx3ELXD0pm7AARiAtQAMBN9A-oqbtvGbE27yDpvBS1lKe9PCm-dMfrHIIcsS91Qeq2E4b6",
              "width": 4032,
            },
          ],
        "place_id": "ChIJkfDzJ72vEmsR8xtYbk5f0p0",
        "plus_code":
          {
            "compound_code": "46M2+6M Sydney, New South Wales",
            "global_code": "4RRH46M2+6M",
          },
        "rating": 4.4,
        "reference": "ChIJkfDzJ72vEmsR8xtYbk5f0p0",
        "scope": "GOOGLE",
        "types":
          [
            "tourist_attraction",
            "convenience_store",
            "bowling_alley",
            "travel_agency",
            "bar",
            "restaurant",
            "food",
            "point_of_interest",
            "store",
            "establishment",
          ],
        "user_ratings_total": 3213,
        "vicinity": "The Promenade, Lime St, Sydney",
      },
      {
        "business_status": "OPERATIONAL",
        "geometry":
          {
            "location": { "lat": -33.870383, "lng": 151.1979245 },
            "viewport":
              {
                "northeast":
                  { "lat": -33.86901092010727, "lng": 151.1991702798927 },
                "southwest":
                  { "lat": -33.87171057989271, "lng": 151.1964706201073 },
              },
          },
        "icon": "https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/restaurant-71.png",
        "icon_background_color": "#FF9E67",
        "icon_mask_base_uri": "https://maps.gstatic.com/mapfiles/place_api/icons/v2/restaurant_pinlet",
        "name": "The Little Snail Restaurant",
        "opening_hours": { "open_now": false },
        "photos":
          [
            {
              "height": 900,
              "html_attributions":
                [
                  'The Little Snail',
                ],
              "photo_reference": "Aap_uEA9aHKkB_6VoFx4VHRSp19PCwnTOuGfpmDYw1NdYNbzncfdjjfEmiiFz-E4tIJ6iGVZjR_bejX6wNr5thJjqlcdQ2PvPyTTo1jGtxk31JG9b6Vd0vu_v4Ep7yutzf3KTzBjYFBIGsYPf3Pj0DptMWPLP7fn33SBT7YmRqDEoGcUsBzw",
              "width": 1350,
            },
          ],
        "place_id": "ChIJtwapWjeuEmsRcxV5JARHpSk",
        "plus_code":
          {
            "compound_code": "45HX+R5 Pyrmont, New South Wales",
            "global_code": "4RRH45HX+R5",
          },
        "price_level": 2,
        "rating": 4.5,
        "reference": "ChIJtwapWjeuEmsRcxV5JARHpSk",
        "scope": "GOOGLE",
        "types": ["restaurant", "food", "point_of_interest", "establishment"],
        "user_ratings_total": 1916,
        "vicinity": "3/50 Murray St, Pyrmont",
      },
    ],
  "status": "OK",
}

XML

<?xml version="1.0" encoding="UTF-8"?>
<PlaceSearchResponse>
 <status>OK</status>
 <result>
  <name>Cruise Bar</name>
  <vicinity>Level 1, 2 and 3, Overseas Passenger Terminal, Circular Quay W, The Rocks</vicinity>
  <type>bar</type>
  <type>restaurant</type>
  <type>food</type>
  <type>point_of_interest</type>
  <type>establishment</type>
  <geometry>
   <location>
    <lat>-33.8587323</lat>
    <lng>151.2100055</lng>
   </location>
   <viewport>
    <southwest>
     <lat>-33.8600981</lat>
     <lng>151.2085440</lng>
    </southwest>
    <northeast>
     <lat>-33.8573985</lat>
     <lng>151.2112436</lng>
    </northeast>
   </viewport>
  </geometry>
  <rating>4.0</rating>
  <icon>https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/bar-71.png</icon>
  <reference>ChIJi6C1MxquEmsR9-c-3O48ykI</reference>
  <opening_hours>
   <open_now>false</open_now>
  </opening_hours>
  <photo>
   <photo_reference>Aap_uEALIq4sgBHhIYWWapOH2NV1T2I7YdOiLzEH7z-483I764cId1sZkbzSq-hVYTk1PQeaHuZzlRfA7-ilwJ3QWon4b37ePd-PBwZbOwFZHxhYs0Cs7jRSgMHWfOzGivp6ZFG4iupyz50qS5pBZT1WbA2ufacTq_U21TtgffQD31wKRPQk</photo_reference>
   <width>1080</width>
   <height>608</height>
   <html_attribution>&lt;a href=&quot;https://maps.google.com/maps/contrib/112582655193348962755&quot;&gt;A Google User&lt;/a&gt;</html_attribution>
  </photo>
  <price_level>2</price_level>
  <user_ratings_total>1269</user_ratings_total>
  <place_id>ChIJi6C1MxquEmsR9-c-3O48ykI</place_id>
  <scope>GOOGLE</scope>
  <plus_code>
   <global_code>4RRH46R6+G2</global_code>
   <compound_code>46R6+G2 The Rocks, New South Wales</compound_code>
  </plus_code>
  <icon_background_color>#FF9E67</icon_background_color>
  <business_status>OPERATIONAL</business_status>
  <icon_mask_base_uri>https://maps.gstatic.com/mapfiles/place_api/icons/v2/bar_pinlet</icon_mask_base_uri>
 </result>
 <result>
  <name>Sydney Harbour Dinner Cruises</name>
  <vicinity>32 The Promenade, Sydney</vicinity>
  <type>tourist_attraction</type>
  <type>restaurant</type>
  <type>food</type>
  <type>travel_agency</type>
  <type>point_of_interest</type>
  <type>establishment</type>
  <geometry>
   <location>
    <lat>-33.8675219</lat>
    <lng>151.2016502</lng>
   </location>
   <viewport>
    <southwest>
     <lat>-33.8688450</lat>
     <lng>151.2004263</lng>
    </southwest>
    <northeast>
     <lat>-33.8661453</lat>
     <lng>151.2031259</lng>
    </northeast>
   </viewport>
  </geometry>
  <rating>4.8</rating>
  <icon>https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/generic_business-71.png</icon>
  <reference>ChIJM1mOVTS6EmsRKaDzrTsgids</reference>
  <opening_hours>
   <open_now>true</open_now>
  </opening_hours>
  <photo>
   <photo_reference>Aap_uEB5jH7GXdcozv1Y5HX18syo4f128S58NVUnqBbLJMpWbC39K49wp-wzsLOsUT8QKDaag6ISFL8hl1vVuig4jkc5fMMkWKiqw5PY-ebcWZ5tI3gEXEYGGoG_mDAulaMLudUpSwgBx2_RLnA0SSiugqqQUTYlkGyCZSe8HSyngVczy6XN</photo_reference>
   <width>1200</width>
   <height>835</height>
   <html_attribution>&lt;a href=&quot;https://maps.google.com/maps/contrib/109764923610545394994&quot;&gt;A Google User&lt;/a&gt;</html_attribution>
  </photo>
  <user_ratings_total>9</user_ratings_total>
  <place_id>ChIJM1mOVTS6EmsRKaDzrTsgids</place_id>
  <scope>GOOGLE</scope>
  <plus_code>
   <global_code>4RRH46J2+XM</global_code>
   <compound_code>46J2+XM Sydney, New South Wales</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>
 <result>
  <name>Clearview Sydney Harbour Cruises</name>
  <vicinity>32 The Promenade King Street Wharf 5, Sydney</vicinity>
  <type>restaurant</type>
  <type>food</type>
  <type>travel_agency</type>
  <type>point_of_interest</type>
  <type>establishment</type>
  <geometry>
   <location>
    <lat>-33.8676569</lat>
    <lng>151.2017213</lng>
   </location>
   <viewport>
    <southwest>
     <lat>-33.8689989</lat>
     <lng>151.2004716</lng>
    </southwest>
    <northeast>
     <lat>-33.8662992</lat>
     <lng>151.2031713</lng>
    </northeast>
   </viewport>
  </geometry>
  <rating>3.8</rating>
  <icon>https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/generic_business-71.png</icon>
  <reference>ChIJNQfwZTiuEmsR1m1x9w0E2V0</reference>
  <opening_hours>
   <open_now>false</open_now>
  </opening_hours>
  <photo>
   <photo_reference>Aap_uED7hBZqIUaBgFu5q8_xoLMrkWIXUau5D7J2T2fS3HAk4j3aoOp5MQKiujaS8ByzfU9zshp37EMMW6tZe67qLYku2AW-QOVeTbJlyxQ7bqgtSZ_YTo_ES1Xw1bBx8wv8BJYTJZFRzh8enBdH0kLy-oICBpm2fDexARp4CG8Dsxz5bqGA</photo_reference>
   <width>1024</width>
   <height>685</height>
   <html_attribution>&lt;a href=&quot;https://maps.google.com/maps/contrib/114394575270272775071&quot;&gt;Clearview Glass Boat Cruises&lt;/a&gt;</html_attribution>
  </photo>
  <user_ratings_total>49</user_ratings_total>
  <place_id>ChIJNQfwZTiuEmsR1m1x9w0E2V0</place_id>
  <scope>GOOGLE</scope>
  <plus_code>
   <global_code>4RRH46J2+WM</global_code>
   <compound_code>46J2+WM Sydney, New South Wales</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>
 <result>
  <name>Sydney Harbour Lunch Cruise</name>
  <vicinity>5/32 The Promenade, Sydney</vicinity>
  <type>restaurant</type>
  <type>food</type>
  <type>travel_agency</type>
  <type>point_of_interest</type>
  <type>establishment</type>
  <geometry>
   <location>
    <lat>-33.8677035</lat>
    <lng>151.2017297</lng>
   </location>
   <viewport>
    <southwest>
     <lat>-33.8690456</lat>
     <lng>151.2004785</lng>
    </southwest>
    <northeast>
     <lat>-33.8663460</lat>
     <lng>151.2031781</lng>
    </northeast>
   </viewport>
  </geometry>
  <rating>3.9</rating>
  <icon>https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/generic_business-71.png</icon>
  <reference>ChIJUbf3iDiuEmsROJxXbhYO7cM</reference>
  <opening_hours>
   <open_now>false</open_now>
  </opening_hours>
  <photo>
   <photo_reference>Aap_uED1kwFA2W4XWHpSNZBxiE10JfyZEJrOz8aAPXpR2GbOg0Pc-yPHJYjt6m007fRdSG2PzvsWdZIFE-lny_NRBGUrSzpk9eNVzDp3GLUeV9G0HXcQv7IhEK6vtm_Updlv66bi8S07h3e_lFiHIzFw0TLVfWXjc63Pm94NN1kug7RPJa-6</photo_reference>
   <width>969</width>
   <height>545</height>
   <html_attribution>&lt;a href=&quot;https://maps.google.com/maps/contrib/102428257696490257922&quot;&gt;Sydney Harbour Lunch Cruise&lt;/a&gt;</html_attribution>
  </photo>
  <user_ratings_total>23</user_ratings_total>
  <place_id>ChIJUbf3iDiuEmsROJxXbhYO7cM</place_id>
  <scope>GOOGLE</scope>
  <plus_code>
   <global_code>4RRH46J2+WM</global_code>
   <compound_code>46J2+WM Sydney, New South Wales</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>
 <result>
  <name>Sydney Showboats - Dinner Cruise With Show</name>
  <vicinity>32 The Promenade, King Street Wharf, 5, Sydney</vicinity>
  <type>restaurant</type>
  <type>food</type>
  <type>travel_agency</type>
  <type>point_of_interest</type>
  <type>establishment</type>
  <geometry>
   <location>
    <lat>-33.8675883</lat>
    <lng>151.2016452</lng>
   </location>
   <viewport>
    <southwest>
     <lat>-33.8689381</lat>
     <lng>151.2002954</lng>
    </southwest>
    <northeast>
     <lat>-33.8662385</lat>
     <lng>151.2029950</lng>
    </northeast>
   </viewport>
  </geometry>
  <rating>4.1</rating>
  <icon>https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/generic_business-71.png</icon>
  <reference>ChIJjRuIiTiuEmsRCHhYnrWiSok</reference>
  <opening_hours>
   <open_now>false</open_now>
  </opening_hours>
  <photo>
   <photo_reference>Aap_uEAGYIvNdkpJvsbVLPNaMlKukR9jvX48rKMo_TPqbSBRYqvYGExwQM8YvHrz83U7UOJosNI0kay5wV9vZdr9fR12ElFlK5fY3xdoS9N9T08ejq2gLABJJK-Bwl4W2IPw9imoWef1BYMVP07WhXhVOs05a-2A3Qm5fKCRILgUis5pMeCg</photo_reference>
   <width>7360</width>
   <height>4912</height>
   <html_attribution>&lt;a href=&quot;https://maps.google.com/maps/contrib/105311284660389698992&quot;&gt;A Google User&lt;/a&gt;</html_attribution>
  </photo>
  <user_ratings_total>119</user_ratings_total>
  <place_id>ChIJjRuIiTiuEmsRCHhYnrWiSok</place_id>
  <scope>GOOGLE</scope>
  <plus_code>
   <global_code>4RRH46J2+XM</global_code>
   <compound_code>46J2+XM Sydney, New South Wales</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>
 <result>
  <name>Magistic Cruises</name>
  <vicinity>King Street Wharf, 32 The Promenade, Sydney</vicinity>
  <type>tourist_attraction</type>
  <type>restaurant</type>
  <type>food</type>
  <type>travel_agency</type>
  <type>point_of_interest</type>
  <type>establishment</type>
  <geometry>
   <location>
    <lat>-33.8677035</lat>
    <lng>151.2017297</lng>
   </location>
   <viewport>
    <southwest>
     <lat>-33.8690456</lat>
     <lng>151.2004785</lng>
    </southwest>
    <northeast>
     <lat>-33.8663460</lat>
     <lng>151.2031781</lng>
    </northeast>
   </viewport>
  </geometry>
  <rating>3.9</rating>
  <icon>https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/generic_business-71.png</icon>
  <reference>ChIJxRjqYTiuEmsRGebAA_chDLE</reference>
  <opening_hours>
   <open_now>true</open_now>
  </opening_hours>
  <photo>
   <photo_reference>Aap_uEDbALKhgsD-bIG6fWxrermkmKtpIKDHthAySc9EjPEpWDQQtYsSgB4AqLVMArTFCWd04Vb9U51st96ONjtDmWf8KsjKwYtkWxYDFzaY9ZmO2UQpV3rnqjmNHXtIsCdjjwADQbumAkjn5WzBJ-DqlVZs9NmlpLvAY6Jg4DGhduWdewv4</photo_reference>
   <width>2048</width>
   <height>1536</height>
   <html_attribution>&lt;a href=&quot;https://maps.google.com/maps/contrib/103073818292552522030&quot;&gt;A Google User&lt;/a&gt;</html_attribution>
  </photo>
  <user_ratings_total>99</user_ratings_total>
  <place_id>ChIJxRjqYTiuEmsRGebAA_chDLE</place_id>
  <scope>GOOGLE</scope>
  <plus_code>
   <global_code>4RRH46J2+WM</global_code>
   <compound_code>46J2+WM Sydney, New South Wales</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>
 <result>
  <name>Australian Cruise Group</name>
  <vicinity>6 Cirular Quay, Sydney</vicinity>
  <type>restaurant</type>
  <type>food</type>
  <type>travel_agency</type>
  <type>point_of_interest</type>
  <type>establishment</type>
  <geometry>
   <location>
    <lat>-33.8609391</lat>
    <lng>151.2098735</lng>
   </location>
   <viewport>
    <southwest>
     <lat>-33.8622889</lat>
     <lng>151.2085237</lng>
    </southwest>
    <northeast>
     <lat>-33.8595893</lat>
     <lng>151.2112233</lng>
    </northeast>
   </viewport>
  </geometry>
  <rating>4.4</rating>
  <icon>https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/generic_business-71.png</icon>
  <reference>ChIJpU8KgUKuEmsRKErVGEaa11w</reference>
  <opening_hours>
   <open_now>false</open_now>
  </opening_hours>
  <photo>
   <photo_reference>Aap_uECGcpPB2lEO6gIB3QzHeviDhXcG-RV3TXuJPiBHGWbDxnflOhymebF45afUMBIW9r3xC2_gHfiqicV4VnooMJ2-Kwy0YocFXk1_0kkmR1HPV2D9kN9h-yPVK5d6oSPMdmY4MjCut3n8Tv9vt6iu44DDnafb2j78R34EcLQ4iFl0sots</photo_reference>
   <width>2048</width>
   <height>1536</height>
   <html_attribution>&lt;a href=&quot;https://maps.google.com/maps/contrib/113088009011192061895&quot;&gt;Keith Bauman&lt;/a&gt;</html_attribution>
  </photo>
  <user_ratings_total>5</user_ratings_total>
  <place_id>ChIJpU8KgUKuEmsRKErVGEaa11w</place_id>
  <scope>GOOGLE</scope>
  <plus_code>
   <global_code>4RRH46Q5+JW</global_code>
   <compound_code>46Q5+JW Sydney, New South Wales</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>
 <result>
  <name>Rhythmboat Cruises</name>
  <vicinity>King Street Wharf, King St, Sydney</vicinity>
  <type>restaurant</type>
  <type>food</type>
  <type>travel_agency</type>
  <type>point_of_interest</type>
  <type>establishment</type>
  <geometry>
   <location>
    <lat>-33.8686058</lat>
    <lng>151.2018206</lng>
   </location>
   <viewport>
    <southwest>
     <lat>-33.8699997</lat>
     <lng>151.2005721</lng>
    </southwest>
    <northeast>
     <lat>-33.8673000</lat>
     <lng>151.2032718</lng>
    </northeast>
   </viewport>
  </geometry>
  <rating>3.9</rating>
  <icon>https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/generic_business-71.png</icon>
  <reference>ChIJyWEHuEmuEmsRm9hTkapTCrk</reference>
  <opening_hours>
   <open_now>false</open_now>
  </opening_hours>
  <photo>
   <photo_reference>Aap_uEAP5i23uwF3dotBD71Tr0YcEXCHnPOem0CKzKev5YX5dvp63wX7rbLZ3bHNNshIf9P0v3z6GKdF8yJkX3wxXWvzv7EfLwWbwGXYkA-vrXm72ek66P1FlNtNHcbIIyF9HQ1MDXZAhwLcnNJObbk8z9lKmCkBQJCQnkLsGHshZ_ZZCM6L</photo_reference>
   <width>4032</width>
   <height>2269</height>
   <html_attribution>&lt;a href=&quot;https://maps.google.com/maps/contrib/104066891898402903288&quot;&gt;Rhythmboat Sydney Harbour Cruises&lt;/a&gt;</html_attribution>
  </photo>
  <user_ratings_total>30</user_ratings_total>
  <place_id>ChIJyWEHuEmuEmsRm9hTkapTCrk</place_id>
  <scope>GOOGLE</scope>
  <plus_code>
   <global_code>4RRH46J2+HP</global_code>
   <compound_code>46J2+HP Sydney, New South Wales</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>
 <result>
  <name>Glass Island</name>
  <vicinity>37 Bank St, Pyrmont</vicinity>
  <type>bar</type>
  <type>restaurant</type>
  <type>food</type>
  <type>point_of_interest</type>
  <type>establishment</type>
  <geometry>
   <location>
    <lat>-33.8712692</lat>
    <lng>151.1898651</lng>
   </location>
   <viewport>
    <southwest>
     <lat>-33.8722276</lat>
     <lng>151.1887564</lng>
    </southwest>
    <northeast>
     <lat>-33.8695279</lat>
     <lng>151.1914560</lng>
    </northeast>
   </viewport>
  </geometry>
  <rating>4.1</rating>
  <icon>https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/generic_business-71.png</icon>
  <reference>ChIJnScuboavEmsRyh-FGxhc3pw</reference>
  <opening_hours>
   <open_now>false</open_now>
  </opening_hours>
  <photo>
   <photo_reference>Aap_uECzZC-aNaQunm_EMgTFeFyR5-u7E19MSZNuRbK14Tq-GxK-glsLoeqtmdOkA307MesbO6Xqau_7bGM4w5vwxMnPPkc8tEQniNQjgC1M1g9OpMwdd4_8nhmBwOMkzUZk1KU0R9CFYxx7YY5a-HywQSK8kTr1FLXX3y23bSkaDvsgenBr</photo_reference>
   <width>6720</width>
   <height>4480</height>
   <html_attribution>&lt;a href=&quot;https://maps.google.com/maps/contrib/117745044320706972021&quot;&gt;A Google User&lt;/a&gt;</html_attribution>
  </photo>
  <user_ratings_total>90</user_ratings_total>
  <place_id>ChIJnScuboavEmsRyh-FGxhc3pw</place_id>
  <scope>GOOGLE</scope>
  <plus_code>
   <global_code>4RRH45HQ+FW</global_code>
   <compound_code>45HQ+FW Pyrmont, New South Wales</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>
 <result>
  <name>Junk Lounge</name>
  <vicinity>Level 2, Overseas Passenger Terminal, Circular Quay W, The Rocks</vicinity>
  <type>restaurant</type>
  <type>food</type>
  <type>point_of_interest</type>
  <type>establishment</type>
  <geometry>
   <location>
    <lat>-33.8587614</lat>
    <lng>151.2100004</lng>
   </location>
   <viewport>
    <southwest>
     <lat>-33.8600771</lat>
     <lng>151.2084323</lng>
    </southwest>
    <northeast>
     <lat>-33.8573774</lat>
     <lng>151.2111319</lng>
    </northeast>
   </viewport>
  </geometry>
  <rating>4.1</rating>
  <icon>https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/restaurant-71.png</icon>
  <reference>ChIJq9W3HZOvEmsRYtKNTRmq34M</reference>
  <opening_hours>
   <open_now>false</open_now>
  </opening_hours>
  <photo>
   <photo_reference>Aap_uEBNQHy0vHfeUWJid28kkZIf4EcgMp50UmkpvhoYPwZJBYImlASnKV4fHlaXTlNQI8H_jUqDpToiMwFOE2XsDpHBdLeZGxpoMq5ThL1gSEMo1zp9U_Pd5jhamilQbpkEeZN_CVeHLAnOX5CG21IF8pda1Zj8IuuENzaKi2BLNQ5TCyYq</photo_reference>
   <width>1080</width>
   <height>608</height>
   <html_attribution>&lt;a href=&quot;https://maps.google.com/maps/contrib/104473997089847488714&quot;&gt;A Google User&lt;/a&gt;</html_attribution>
  </photo>
  <price_level>2</price_level>
  <user_ratings_total>63</user_ratings_total>
  <place_id>ChIJq9W3HZOvEmsRYtKNTRmq34M</place_id>
  <scope>GOOGLE</scope>
  <plus_code>
   <global_code>4RRH46R6+F2</global_code>
   <compound_code>46R6+F2 The Rocks, New South Wales</compound_code>
  </plus_code>
  <icon_background_color>#FF9E67</icon_background_color>
  <business_status>OPERATIONAL</business_status>
  <icon_mask_base_uri>https://maps.gstatic.com/mapfiles/place_api/icons/v2/restaurant_pinlet</icon_mask_base_uri>
 </result>
 <result>
  <name>Sydney New Year's Eve Cruises</name>
  <vicinity>King Street Wharf 5, 32 The Promenade, Sydney</vicinity>
  <type>restaurant</type>
  <type>food</type>
  <type>travel_agency</type>
  <type>point_of_interest</type>
  <type>establishment</type>
  <geometry>
   <location>
    <lat>-33.8677035</lat>
    <lng>151.2017297</lng>
   </location>
   <viewport>
    <southwest>
     <lat>-33.8690456</lat>
     <lng>151.2004785</lng>
    </southwest>
    <northeast>
     <lat>-33.8663460</lat>
     <lng>151.2031781</lng>
    </northeast>
   </viewport>
  </geometry>
  <rating>5.0</rating>
  <icon>https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/generic_business-71.png</icon>
  <reference>ChIJ__8_hziuEmsR27ucFXECfOg</reference>
  <opening_hours>
   <open_now>true</open_now>
  </opening_hours>
  <photo>
   <photo_reference>Aap_uEB3hrLc-p5rV8oczY8fo4vdDdw1c0ZXLzbcgek15WzOon1Qd3WbMfmx994E05fFb5Tt1E60Iux0jaEwGkoy477ru-ZYRD1KUZrfMNw46ciZhnHRD2ZX_nWVYkw2VG_AdEDw1DJ3YQEuDP4EJ5IpsoKianbWyIlmaeuy63TfjdvuFs18</photo_reference>
   <width>2400</width>
   <height>1600</height>
   <html_attribution>&lt;a href=&quot;https://maps.google.com/maps/contrib/115281801304517408477&quot;&gt;A Google User&lt;/a&gt;</html_attribution>
  </photo>
  <user_ratings_total>5</user_ratings_total>
  <place_id>ChIJ__8_hziuEmsR27ucFXECfOg</place_id>
  <scope>GOOGLE</scope>
  <plus_code>
   <global_code>4RRH46J2+WM</global_code>
   <compound_code>46J2+WM Sydney, New South Wales</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>
 <result>
  <name>King Street Wharf Darling Harbour</name>
  <vicinity>The Promenade, Lime St, Sydney</vicinity>
  <type>tourist_attraction</type>
  <type>bowling_alley</type>
  <type>convenience_store</type>
  <type>bar</type>
  <type>restaurant</type>
  <type>food</type>
  <type>travel_agency</type>
  <type>point_of_interest</type>
  <type>store</type>
  <type>establishment</type>
  <geometry>
   <location>
    <lat>-33.8669866</lat>
    <lng>151.2017231</lng>
   </location>
   <viewport>
    <southwest>
     <lat>-33.8683316</lat>
     <lng>151.2004351</lng>
    </southwest>
    <northeast>
     <lat>-33.8656320</lat>
     <lng>151.2031347</lng>
    </northeast>
   </viewport>
  </geometry>
  <rating>4.4</rating>
  <icon>https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/generic_business-71.png</icon>
  <reference>ChIJkfDzJ72vEmsR8xtYbk5f0p0</reference>
  <opening_hours>
   <open_now>true</open_now>
  </opening_hours>
  <photo>
   <photo_reference>Aap_uEACFUVsoIAR-DdQfFF-95EUG-vLZ4rE0twMHUMam4JM7qPjrfmrVpC80g8CHtMEcimKBxtiGYaEVp7dw12FhfkJw8hZI-bK4Ls9BY3AnvdoUbfVkBvLC7yqT5ly-gMW2ZT8rLc5-mKaZHbWZyZEPgWs84Qd6KPnEKRx6dGNEevYaUlL</photo_reference>
   <width>4032</width>
   <height>3024</height>
   <html_attribution>&lt;a href=&quot;https://maps.google.com/maps/contrib/101920674986627213698&quot;&gt;朱品貞&lt;/a&gt;</html_attribution>
  </photo>
  <user_ratings_total>3213</user_ratings_total>
  <place_id>ChIJkfDzJ72vEmsR8xtYbk5f0p0</place_id>
  <scope>GOOGLE</scope>
  <plus_code>
   <global_code>4RRH46M2+6M</global_code>
   <compound_code>46M2+6M Sydney, New South Wales</compound_code>
  </plus_code>
  <icon_background_color>#13B5C7</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>
 <result>
  <name>The Little Snail Restaurant</name>
  <vicinity>3/50 Murray St, Pyrmont</vicinity>
  <type>restaurant</type>
  <type>food</type>
  <type>point_of_interest</type>
  <type>establishment</type>
  <geometry>
   <location>
    <lat>-33.8703830</lat>
    <lng>151.1979245</lng>
   </location>
   <viewport>
    <southwest>
     <lat>-33.8717106</lat>
     <lng>151.1964706</lng>
    </southwest>
    <northeast>
     <lat>-33.8690109</lat>
     <lng>151.1991703</lng>
    </northeast>
   </viewport>
  </geometry>
  <rating>4.5</rating>
  <icon>https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/restaurant-71.png</icon>
  <reference>ChIJtwapWjeuEmsRcxV5JARHpSk</reference>
  <opening_hours>
   <open_now>false</open_now>
  </opening_hours>
  <photo>
   <photo_reference>Aap_uEB9EuRqd4be_9HrlUI7lbC5aDokS8UASO_ogA9OFQwEZsFD_jXDwK2Xc2kQm_wDE9TBI_20Na4TcRkgZoers93pw9cJ5RAbedKbUYAvAJz9c-zWKdqRd7pWaOlInQmbJVohI4ZsqbtlhynDqmfgX1SIccGuh066nlxyX7oFvYoLSbNb</photo_reference>
   <width>1350</width>
   <height>900</height>
   <html_attribution>&lt;a href=&quot;https://maps.google.com/maps/contrib/114727320476039103791&quot;&gt;The Little Snail&lt;/a&gt;</html_attribution>
  </photo>
  <price_level>2</price_level>
  <user_ratings_total>1916</user_ratings_total>
  <place_id>ChIJtwapWjeuEmsRcxV5JARHpSk</place_id>
  <scope>GOOGLE</scope>
  <plus_code>
   <global_code>4RRH45HX+R5</global_code>
   <compound_code>45HX+R5 Pyrmont, New South Wales</compound_code>
  </plus_code>
  <icon_background_color>#FF9E67</icon_background_color>
  <business_status>OPERATIONAL</business_status>
  <icon_mask_base_uri>https://maps.gstatic.com/mapfiles/place_api/icons/v2/restaurant_pinlet</icon_mask_base_uri>
 </result>
</PlaceSearchResponse>

PlacesNearbySearchResponse

Campo Obligatorio Tipo Descripción
required Arreglo<cadena>

Puede contener un conjunto de atribuciones sobre esta ficha que se deben mostrar al usuario (es posible que algunas fichas no tengan atribución).

required Arreglo de Place

Contiene un array 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.

next_page_token

opcional string

Contiene un token que se puede usar para devolver hasta 20 resultados adicionales. No se devolverá un next_page_token si no hay resultados adicionales para mostrar. La cantidad máxima de resultados que se pueden mostrar es 60. Hay una breve demora entre el momento en que se emite un next_page_token y el momento en que se vuelve válido.

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 Es un array de 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, en algunos países, como 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 EE.UU.).

No analices la dirección con formato por vía 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 Geometría

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

Consulta Geometría 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 debe presentarse 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 a través de la API de Place Photo con una URL que sigue 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 formato 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”.

Cómo acceder a resultados adicionales

De forma predeterminada, cada respuesta muestra hasta 20 resultados de establishment por búsqueda. Sin embargo, cada búsqueda puede mostrar hasta 60 resultados divididos en tres páginas. Si tu búsqueda devolverá más de 20 resultados, la respuesta de búsqueda incluirá un valor adicional: next_page_token. Pasa el valor de next_page_token al parámetro pagetoken de una solicitud nueva para ver el siguiente conjunto de resultados.

  • Si next_page_token es nulo o no se devuelve, no hay más resultados.
  • Si vuelves a intentar la solicitud con el mismo next_page_token, se mostrará la siguiente página de resultados.
  • Si se configura pagetoken, se ignorarán todos los demás parámetros.
  • Puedes solicitar una nueva página hasta dos veces después de la búsqueda original.
  • Cada solicitud, incluida una solicitud que usa next_page_token, cuenta como una solicitud única para tus límites de uso y se cobra por separado.
  • Hay un retraso de unos segundos entre el momento en que se emite un next_page_token y el momento en que se vuelve válido. Si solicitas la página siguiente antes de que esté disponible, se mostrará una respuesta INVALID_REQUEST. Las solicitudes con next_page_token siempre se cobran.

Por ejemplo, en la siguiente búsqueda, buscamos restaurantes cerca de Darling Harbour, en Sídney, Australia, y clasificamos los resultados por distancia. Puedes ver que la respuesta contiene una propiedad next_page_token.

{
   "html_attributions" : [],
   "next_page_token" : "CpQCAgEAAFxg8o-eU7_uKn7Yqjana-HQIx1hr5BrT4zBaEko29ANsXtp9mrqN0yrKWhf-y2PUpHRLQb1GT-mtxNcXou8TwkXhi1Jbk-ReY7oulyuvKSQrw1lgJElggGlo0d6indiH1U-tDwquw4tU_UXoQ_sj8OBo8XBUuWjuuFShqmLMP-0W59Vr6CaXdLrF8M3wFR4dUUhSf5UC4QCLaOMVP92lyh0OdtF_m_9Dt7lz-Wniod9zDrHeDsz_by570K3jL1VuDKTl_U1cJ0mzz_zDHGfOUf7VU1kVIs1WnM9SGvnm8YZURLTtMLMWx8-doGUE56Af_VfKjGDYW361OOIj9GmkyCFtaoCmTMIr5kgyeUSnB-IEhDlzujVrV6O9Mt7N4DagR6RGhT3g1viYLS4kO5YindU6dm3GIof1Q",
   "results" : [...]
   "status" : "OK"
}

Para ver el siguiente conjunto de resultados, puedes enviar una nueva consulta y pasar el resultado de next_page_token al parámetro pagetoken. Por ejemplo: 

https://maps.googleapis.com/maps/api/place/nearbysearch/json?pagetoken=CpQCAgEAAFxg8o-eU7_uKn7Yqjana-HQIx1hr5BrT4zBaEko29ANsXtp9mrqN0yrKWhf-y2PUpHRLQb1GT-mtxNcXou8TwkXhi1Jbk-ReY7oulyuvKSQrw1lgJElggGlo0d6indiH1U-tDwquw4tU_UXoQ_sj8OBo8XBUuWjuuFShqmLMP-0W59Vr6CaXdLrF8M3wFR4dUUhSf5UC4QCLaOMVP92lyh0OdtF_m_9Dt7lz-Wniod9zDrHeDsz_by570K3jL1VuDKTl_U1cJ0mzz_zDHGfOUf7VU1kVIs1WnM9SGvnm8YZURLTtMLMWx8-doGUE56Af_VfKjGDYW361OOIj9GmkyCFtaoCmTMIr5kgyeUSnB-IEhDlzujVrV6O9Mt7N4DagR6RGhT3g1viYLS4kO5YindU6dm3GIof1Q&key=YOUR_API_KEY