Поиск поблизости (устаревший)

Разработчики из Европейской экономической зоны (ЕЭЗ)

Поиск поблизости (устаревшая версия) позволяет искать места в пределах заданной области. Вы можете уточнить запрос, указав ключевые слова или тип места.

Запросы поиска поблизости (устаревшая версия)

Запрос поиска поблизости (устаревшая версия) представляет собой URL с протоколом HTTP следующего формата:

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

где output может принимать одно из следующих значений:

  • json (рекомендуется) – вывод в формате JSON (JavaScript Object Notation).
  • xml – вывод в формате XML.

Для запуска запроса поиска поблизости (устаревшая версия) требуются определенные параметры. Параметры разделяются амперсандами (&) в соответствии со стандартом написания URL.

Обязательные параметры

  • местоположение

    Точка, вокруг которой нужно получить информацию о месте. Необходимо указать значение latitude,longitude.

  • радиус

    Определяет расстояние (в метрах), в пределах которого нужно возвращать результаты. С помощью параметров location и radius можно настроить поиск так, чтобы предпочтение отдавалось результатам в пределах указанной окружности. Сервис Places будет показывать первыми в результатах места из указанной области, однако более отдаленные точки также могут быть включены в ответ.

    Радиус будет автоматически ограничен максимальным значением в зависимости от типа поиска и других параметров.

    • Автозаполнение: 50 000 метров.
    • Поиск поблизости:
      • с keyword или name: 50 000 метров;
      • без keyword или name
        • До 50 000 метров, динамически корректируется в зависимости от плотности населения, независимо от параметра rankby.
        • Если используется параметр rankby=distance, параметр radius не будет принят и будет возвращена ошибка INVALID_REQUEST.
    • Автозаполнение запросов: 50 000 метров.
    • Текстовый поиск: 50 000 метров.

Необязательные параметры

  • ключевое слово

    Строка для текстового поиска, например "ресторан" или "улица Центральная, 123". Нужно указать название места, его адрес или категорию учреждения. Если ввести данные другого типа, вы можете получить неправильные результаты или возникнет ошибка. На основе этой строки сервис Google Places возвращает список подходящих мест, упорядоченных по их предполагаемой релевантности.

    Явное указание информации о местоположении с помощью этого параметра может привести к конфликту с параметрами location, radius и rankby и, как следствие, к неожиданным результатам.

    Если этот параметр не указан, места со статусом CLOSED_TEMPORARILY или CLOSED_PERMANENTLY не возвращаются.

  • language

    Язык, на котором будут возвращены результаты.

    • Вы можете ознакомиться со списком поддерживаемых языков. Google часто обновляет список поддерживаемых языков, поэтому он может быть неполным.
    • Если параметр language не указан, API попытается использовать предпочитаемый язык, заданный в заголовке Accept-Language.
    • API пытается предоставить почтовый адрес, понятный как пользователю, так и местным жителям. Для этого он возвращает адреса улиц на местном языке, при необходимости транслитерируя их в шрифт, который может прочитать пользователь, с учетом предпочитаемого языка. Все остальные адреса возвращаются на предпочитаемом языке. Все компоненты адреса возвращаются на одном языке, который выбирается по первому компоненту.
    • Если название на предпочитаемом языке недоступно, API использует ближайшее соответствие.
    • Предпочтительный язык незначительно влияет на набор результатов, возвращаемых API, и порядок их следования. Геокодер интерпретирует сокращения по-разному в зависимости от языка, например сокращения типов улиц или синонимы, которые могут быть действительны на одном языке, но не на другом. Например, в венгерском языке слова utca и tér являются синонимами слова "улица".
  • maxprice

    Ограничивает результаты местами, которые соответствуют указанному диапазону. Значения могут находиться в диапазоне от 0 (наиболее доступные места) до 4 (наиболее дорогие места). Точная сумма, соответствующая определенному значению, зависит от региона.

  • minprice

    Ограничивает результаты местами, которые соответствуют указанному диапазону. Значения могут находиться в диапазоне от 0 (наиболее доступные места) до 4 (наиболее дорогие места). Точная сумма, соответствующая определенному значению, зависит от региона.

  • name

    Аналогичен элементу keyword. Значения из этого поля объединяются со значениями поля keyword и передаются в составе той же строки поиска.

  • opennow

    Возвращает только те места, которые открыты в момент отправки запроса. Если в запросе указан этот параметр, то все места, для которых в базе данных Google Places не указаны часы работы, игнорируются.

  • pagetoken

    Возвращает до 20 результатов ранее выполненного поиска. Если задать параметр pagetoken, поиск будет выполнен с теми же параметрами, что и раньше. Все параметры, кроме pagetoken, будут игнорироваться.

  • rankby

    Определяет порядок, в котором перечислены результаты. Возможные значения:

    • prominence (по умолчанию). Результаты сортируются по известности. Приоритет в рейтинге отдается более известным местам, находящимся в заданной области, перед менее известными местами поблизости. На известность влияет рейтинг места в индексе Google, общая популярность и другие факторы. Если указан параметр prominence, то параметр radius является обязательным.
    • distance. Результаты сортируются в порядке близости к заданной точке. Если указано значение distance, нужно также предоставить keyword, name и/или type. При этом radius указывать нельзя.
  • тип

    В результаты поиска включаются только места указанного типа. Можно указать только один тип. Если указано несколько типов, все типы, кроме первого, игнорируются.

    • type=hospital|pharmacy|doctor становится type=hospital
    • type=hospital,pharmacy,doctor полностью игнорируется.

    Ознакомьтесь со списком поддерживаемых типов.

    Примечание. Если добавить keyword и type с одинаковым значением (keyword=cafe&type=cafe или keyword=parking&type=parking), можно получить ZERO_RESULTS.

Пример поиска поблизости (устаревшая версия)

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

Примечание. В этом примере вам нужно заменить key своим ключом API, чтобы запрос работал в вашем приложении.

Ответы на запросы поиска поблизости (устаревшая версия)

Ниже приведен пример ответа на запрос Поиск поблизости (устаревшая версия).

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

Поле Обязательно Тип Описание
Обязательно Array<string>

Может содержать набор атрибуций для этого предложения, которые должны быть показаны пользователю (некоторые предложения могут не иметь атрибуций).

Обязательно Массив<Place>

Содержит массив мест.

При запросах поиска мест возвращается только часть полей, которые возвращаются при запросах информации о местах. Если нужное поле не было возвращено поиском мест, с помощью поиска мест можно получить place_id, а затем использовать этот идентификатор места в запросе информации о местах.

Подробнее о местах…

Обязательно PlacesSearchStatus

Содержит статус запроса и может содержать сведения для отладки, которые помогут вам выяснить, почему запрос не был выполнен.

Подробнее PlacesSearchStatus…

необязательно string

Если сервис возвращает код статуса, отличный от OK<, в объекте ответа может быть дополнительное поле error_message. Это поле содержит более подробную информацию о причинах, вызвавших код статуса. Это поле возвращается не всегда, а его содержимое может меняться.

необязательно Array<string>

Если сервис возвращает дополнительную информацию о спецификации запроса, в объекте ответа может быть дополнительное поле info_messages. Это поле возвращается только для успешных запросов. Оно может быть возвращено не всегда, а его содержание может меняться.

необязательно string

Содержит токен, с помощью которого можно получить до 20 дополнительных результатов. Если дополнительных результатов нет, то токен next_page_token не возвращается. Максимальное количество результатов, которое можно вернуть, – 60. Между выпуском токена next_page_token и моментом, когда он станет действительным, проходит небольшая задержка.

PlacesSearchStatus

Коды статуса, возвращаемые сервисом.

  • OK означает, что запрос к API успешно выполнен;
  • ZERO_RESULTS – означает, что поиск успешно выполнен, однако результаты не найдены. Такое может произойти, если при поиске был передан адрес latlng в отдаленном местоположении.
  • INVALID_REQUEST означает, что запрос к API был составлен неправильно, обычно из-за отсутствия обязательного параметра запроса (location или radius).
  • OVER_QUERY_LIMIT, указывающий на одно из следующих действий:
    • Вы превысили лимиты на количество запросов в секунду.
    • В вашем аккаунте не включены платежные функции.
    • Превышен ежемесячный бонус в размере 200 долларов США или заданное ограничение на использование.
    • Указанный способ оплаты больше не действует (например, истек срок действия кредитной карты).
    Подробнее о том, как устранить эту ошибку, можно узнать в разделе часто задаваемых вопросов о Картах.
  • REQUEST_DENIED – запрос был отклонен, как правило, по одной из следующих причин:
    • В запросе отсутствует ключ API.
    • Недопустимый параметр key.
  • UNKNOWN_ERROR означает неизвестную ошибку.

Место

Атрибуты, описывающие место. Не все атрибуты доступны для всех типов мест.

Поле Обязательно Тип Описание
необязательно Массив<AddressComponent>

Массив, содержащий отдельные компоненты адреса.

Подробнее AddressComponent…

необязательно string

Представление адреса места в микроформате adr.

необязательно string

Указывает, работает ли место, если оно является компанией. Если информация отсутствует, свойство business_status возвращено не будет.

The allowed values include: OPERATIONAL, CLOSED_TEMPORARILY, and CLOSED_PERMANENTLY
необязательно Логическое значение

Указывает, поддерживает ли компания получение заказа на улице.

необязательно PlaceOpeningHours

Содержит часы работы на следующие семь дней (включая текущий день). Период времени начинается в полночь в день запроса и заканчивается в 23:59 шесть дней спустя. Это поле содержит вложенное поле special_days для всех часов, заданных для дат с особым графиком работы.

Подробнее PlaceOpeningHours…

необязательно Логическое значение

Указывает, поддерживает ли компания доставку.

необязательно Логическое значение

Указывает, есть ли в заведении места в помещении или на открытом воздухе.

необязательно PlaceEditorialSummary

Содержит краткое описание места. Сводка состоит из текстового обзора и, если применимо, кода языка. Текст краткого пересказа должен быть представлен без изменений.

Подробнее PlaceEditorialSummary…

необязательно string

Строка, содержащая человекочитаемый адрес этого места.

Часто это почтовый адрес. В некоторых странах, таких как Великобритания, не разрешено распространение настоящих почтовых адресов в связи с ограничениями лицензирования.

Отформатированный адрес состоит из одного или нескольких компонентов адреса. Например, адрес "111 8th Avenue, New York, NY" содержит отдельные компоненты "111" (номер дома), "8th Avenue" (улица), "New York" (город) и "NY" (штат США).

Не анализируйте отформатированный адрес программно. Вместо этого используйте отдельные компоненты адреса, которые ответ API включает в дополнение к полю отформатированного адреса.

необязательно string

Содержит номер телефона места в местном формате.

необязательно Геометрия

Содержит местоположение и область просмотра для местоположения.

Подробнее о библиотеке Geometry…

необязательно string

Содержит URL предложенного значка, который может быть показан пользователю при отображении этого результата на карте.

необязательно string

Содержит шестнадцатеричный код цвета категории места (по умолчанию).

необязательно string

Содержит URL рекомендуемого значка без расширения типа файла .svg или .png.

необязательно string

Содержит номер телефона в международном формате, Международный формат включает код страны и имеет префикс в виде знака «плюс» (+). Например, международный номер телефона офиса Google в Сиднее (Австралия): +61 2 9374 4000.

необязательно string

Содержит человекочитаемое название возвращенного результата. Для результатов типа establishment это обычно канонизированное название компании.

необязательно PlaceOpeningHours

Содержит обычные часы работы.

Подробнее PlaceOpeningHours…

необязательно Логическое значение

Используйте business_status, чтобы получать данные о статусе компаний.

необязательно Массив<PlacePhoto>

Массив объектов фотографий, каждый из которых содержит ссылку на изображение. В ответе на запрос может быть до 10 фотографий. Дополнительную информацию о фотографиях мест и о том, как использовать их в приложении, можно найти в документации по Place Photos.

Подробнее о классе PlacePhoto…

необязательно string

уникальный текстовый идентификатор места. Чтобы извлечь информацию о месте, передайте этот идентификатор в поле place_id запроса к Places API. Подробнее об идентификаторах мест…

необязательно PlusCode

Закодированная ссылка на местоположение на основе координат широты и долготы, которая представляет область: 1/8000 градуса на 1/8000 градуса (приблизительно 14 x 14 метров на экваторе) или меньше. Коды Plus Code можно использовать в качестве замены почтовым адресам там, где эти адреса не существуют (здания не пронумерованы или улицам не присвоены названия). Подробнее об Open Location Code и кодах Plus Code…

Подробнее PlusCode…

необязательно число

Уровень цен в заведении по шкале от 0 до 4. Точная сумма, соответствующая определенному значению, зависит от региона. Уровни цен интерпретируются следующим образом:

  • 0 бесплатных
  • 1 – недорогой.
  • 2, умеренная
  • 3 – дорогой.
  • 4 – очень дорого
необязательно число

Оценка места в диапазоне от 1, 0 до 5, 0 на основе агрегированных отзывов пользователей.

необязательно string
необязательно Логическое значение

Указывает, можно ли забронировать места в заведении.

необязательно Массив<PlaceReview>

Массив JSON, содержащий до пяти отзывов. По умолчанию отзывы сортируются по релевантности. Для сортировки используйте параметр запроса reviews_sort.

  • Для значения most_relevant (по умолчанию) отзывы сортируются по релевантности. Сервис отдает предпочтение отзывам, изначально написанным на выбранном языке.
  • В newest отзывы сортируются в хронологическом порядке. Предпочитаемый язык не влияет на порядок сортировки.

Google рекомендует сообщать пользователям, как упорядочены результаты: по most_relevant или newest.

Подробную информацию вы найдете в статье PlaceReview.

необязательно string
необязательно Массив<PlaceOpeningHours>

Содержит массив записей для следующих семи дней, включая информацию о дополнительных часах работы компании. Дополнительные часы работы отличаются от основных. Например, ресторан может указать часы работы окна выдачи заказов или доставки в качестве дополнительных. Это поле заполняет подполе type, которое берет данные из заранее определенного списка типов часов работы (например, DRIVE_THROUGH, PICKUP или TAKEOUT) в зависимости от типа места. Это поле содержит вложенное поле special_days для всех часов, заданных для дат с измененным графиком.

Дополнительную информацию можно найти в описании PlaceOpeningHours.

необязательно Логическое значение

Указывает, подают ли в заведении пиво.

необязательно Логическое значение

Указывает, подают ли в заведении завтрак.

необязательно Логическое значение

Указывает, подают ли в заведении поздние завтраки.

необязательно Логическое значение

Указывает, подается ли в заведении ужин.

необязательно Логическое значение

Указывает, можно ли в заведении пообедать.

необязательно Логическое значение

Указывает, подают ли в заведении вегетарианские блюда.

необязательно Логическое значение

Указывает, подают ли в заведении вино.

необязательно Логическое значение

Указывает, можно ли заказать еду навынос.

необязательно Array<string>

Содержит массив типов объектов, описывающих данный результат. Ознакомьтесь со списком поддерживаемых типов.

необязательно string

URL официальной страницы этого места в Google. Это страница Google, содержащая всю имеющуюся информацию об этом месте. Приложения должны показывать пользователю встроенную страницу места или ссылку на нее на любом экране с подробным описанием этого места.

необязательно число

Общее количество отзывов о месте (с текстом или без него).

необязательно число

Содержит количество минут, на которое текущий часовой пояс этого места отличается от UTC. Например, для Сиднея (Австралия) в период действия летнего времени это значение будет равно 660 (+11 часов от UTC), а для Калифорнии вне периода действия летнего времени – -480 (-8 часов от UTC).

необязательно string

Для результатов типа "заведение" (types:["establishment", ...])) поле vicinity содержит упрощенный адрес места, включая населенный пункт, улицу и номер дома, но без указания штата, провинции или области, почтового индекса и страны.

Для всех остальных результатов поле vicinity содержит название самой узкой административной единицы (types:["political", ...]), которая присутствует в адресе результата.

Этот текст должен отображаться "как есть", без дополнительной программной обработки.

необязательно string

Официальный сайт, связанный с этим местом, например адрес домашней страницы компании.

необязательно Логическое значение

Указывает, есть ли в месте вход, доступный для инвалидов-колясочников.

PlaceEditorialSummary

Содержит краткое описание места. Сводка состоит из текстового описания и, если применимо, кода языка. Текст сводки должен быть представлен в исходном виде, его нельзя изменять.

Поле Обязательно Тип Описание
необязательно string

Язык предыдущих полей. Может отсутствовать.

необязательно string

Текстовое описание места средней длины.

PlaceOpeningHours

Объект, описывающий часы работы места.

Поле Обязательно Тип Описание
необязательно Логическое значение

Логическое значение, указывающее, работает или нет в текущий момент это место.

необязательно Array<PlaceOpeningHoursPeriod>

Массив часов работы, содержащий данные по семи дням недели, начиная с воскресенья, в хронологическом порядке.

Дополнительную информацию можно найти в описании PlaceOpeningHoursPeriod.

необязательно Массив<PlaceSpecialDay>

Массив, содержащий до семи записей, соответствующих следующим семи дням.

Подробную информацию можно найти в описании типа PlaceSpecialDay.

необязательно string

Строка типа, используемая для определения типа дополнительных часов (например, DRIVE_THROUGH, HAPPY_HOUR, DELIVERY, TAKEOUT, KITCHEN, BREAKFAST, LUNCH, DINNER, BRUNCH, PICKUP, SENIOR_HOURS). Задается только для secondary_opening_hours.

необязательно Array<string>

Массив строк, описывающих часы работы места в человекочитаемом формате.

PlaceOpeningHoursPeriod

Поле Обязательно Тип Описание
Обязательно PlaceOpeningHoursPeriodDetail

Содержит пару объектов дня недели и времени, описывающих время начала работы места.

Подробнее PlaceOpeningHoursPeriodDetail…

необязательно PlaceOpeningHoursPeriodDetail

Может содержать пару объектов дня недели и времени, описывающих время окончания работы места. Если место работает круглосуточно, в ответе не будет раздела "Закрытие". Можно уверенно считать, что место работает круглосуточно, если период содержит параметр day со значением 0 и параметр time со значением 0000, и при этом отсутствует параметр close.

Подробнее PlaceOpeningHoursPeriodDetail…

PlaceSpecialDay

Поле Обязательно Тип Описание
необязательно string

Дата в формате RFC3339 в местном часовом поясе, например 2010-12-31.

необязательно Логическое значение

Значение True, если для этого дня задан измененный график работы. Если значение параметра true – "да", это означает, что для этого дня есть хотя бы одно исключение. Исключения приводят к появлению разных значений в подполях current_opening_hours и secondary_opening_hours, таких как periods, weekday_text, open_now. Исключения применяются к часам, а часы используются для создания других полей.

PlaceOpeningHoursPeriodDetail

Поле Обязательно Тип Описание
Обязательно число

Номер дня недели в диапазоне от 0 до 6, начиная с воскресенья. Например, 2 обозначает вторник.

Обязательно string

Может содержать время в 24-часовом формате "ччмм". Значения находятся в диапазоне 0000–2359. Время указывается в часовом поясе этого места.

необязательно string

Дата в формате RFC3339 в местном часовом поясе, например 2010-12-31.

необязательно Логическое значение

Значение True, если период был усечен из-за семидневного ограничения, когда период начинается до полуночи в день запроса и/или заканчивается в полночь или позже в последний день. Это свойство указывает, что период открытия или закрытия может быть больше семи дней.

PlacePhoto

Фотография места. Фотографию можно получить через Place Photo API, используя URL следующего формата:

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

Подробнее о фотографиях мест…

Поле Обязательно Тип Описание
Обязательно число

Высота фотографии.

Обязательно Array<string>

HTML-атрибуты для фотографии.

Обязательно string

Строка, используемая для идентификации фотографии при выполнении запроса Photo.

Обязательно число

Ширина фотографии.

PlaceReview

Отзыв пользователя о месте.

Поле Обязательно Тип Описание
Обязательно string

Имя пользователя, отправившего отзыв. К анонимным отзывам добавляется подпись "A Google user".

Обязательно число

Общая оценка пользователя для данного места. Она представляет собой целое число от 1 до 5.

Обязательно string

Время отправки отзыва в текстовом формате относительно текущего времени.

Обязательно число

Время отправки отзыва в секундах с 00:00 1 января 1970 г. по UTC.

необязательно string

URL профиля пользователя в программе "Местные эксперты Google Карт" (если доступен).

необязательно string

Код языка IETF, указывающий язык возвращенного отзыва.Это поле содержит только основной тег языка и не содержит дополнительный тег страны или региона. Например, все отзывы на английском языке имеют тег "en", но не "en-AU", "en-UK" и т. д. Это поле пустое, если есть только оценка, но нет текста отзыва.

необязательно string

Код языка IETF, указывающий исходный язык отзыва. Если отзыв переведен, то original_language != language.Это поле содержит только основной тег языка и не содержит дополнительный тег страны или региона. Например, все отзывы на английском языке имеют тег "en", но не "en-AU", "en-UK" и т. д. Это поле пустое, если есть только оценка, но нет текста отзыва.

необязательно string

URL фотографии профиля пользователя (если доступен).

необязательно string

Отзыв пользователя. В сервисе Google Places поле текста отзыва не является обязательным. Поэтому это поле может быть пустым. Обратите внимание, что это поле может содержать простую разметку HTML. Например, ссылка на объект &amp; может представлять символ амперсанда.

необязательно Логическое значение

Булево значение, указывающее, был ли отзыв переведен с языка оригинала.Если отзыв был переведен (значение true), Google рекомендует сообщить об этом пользователям. Например, вы можете добавить в отзыв строку "Переведено Google".

Отображение дополнительных результатов

По умолчанию для каждого запроса поиска мест возвращается до 20 establishment результатов. Всего количество результатов может доходить до 60, и в таком случае они разбиваются на три страницы. Если в результате поиска будет найдено более 20 объектов, в ответе будет указано дополнительное значение – next_page_token. Передайте значение next_page_token параметру pagetoken нового запроса, чтобы увидеть следующий набор результатов.

  • Если next_page_token имеет значение null или не возвращается, значит, результатов больше нет.
  • Если повторить запрос с тем же значением next_page_token, будет возвращена следующая страница результатов.
  • Если задать параметр pagetoken, все остальные параметры будут игнорироваться.
  • После первого запроса вы можете запросить новую страницу до двух раз.
  • Каждый запрос, в том числе с использованием next_page_token, учитывается как отдельный запрос с точки зрения лимитов на использование и оплачивается отдельно.
  • Между выпуском next_page_token и началом его действия проходит несколько секунд. Если запросить следующую страницу до того, как она станет доступна, будет возвращен ответ INVALID_REQUEST. Запросы с параметром next_page_token всегда платные.

Например, в приведенном ниже запросе мы ищем рестораны рядом с гаванью Дарлинг в Сиднее (Австралия) и сортируем результаты по расстоянию. Вы увидите, что ответ содержит свойство 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"
}

Чтобы посмотреть следующий набор результатов, отправьте новый запрос, передав результат next_page_token параметру pagetoken. Пример:

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