Найти место (наследие)

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

Если ваш платежный адрес находится в Европейской экономической зоне, то с 8 июля 2025 года к использованию вами Услуг будут применяться Условия предоставления услуг платформы Google Maps для стран ЕЭЗ . Функциональность различается в зависимости от региона. Подробнее .

Примечание: серверные и клиентские библиотеки.

API Places также доступен в Java-клиенте, Python-клиенте, Go-клиенте и Node.js-клиенте для сервисов Google Maps . API Places и клиентские библиотеки предназначены для использования в серверных приложениях.

Если вы разрабатываете клиентское приложение, обратите внимание на Places SDK для Android (новое) , Places SDK для iOS (новое) и библиотеку Places Library, Maps JavaScript API .

Запрос Find Place (Legacy) принимает текстовый ввод и возвращает местоположение. В качестве ввода могут использоваться любые текстовые данные Places, такие как имя, адрес или номер телефона. Запрос должен быть строкой. Запрос Find Place (Legacy), использующий нестроковые данные, такие как координаты широты/долготы или код, приводит к ошибке.

Запрос Find Place (Legacy) возвращает подмножество полей, которые возвращаются запросом Place Details (Legacy) . Для получения дополнительной информации о полях, недоступных в запросе Find Place (Legacy), см. раздел « Поддержка полей Places API» . Если нужное вам поле не возвращается, вы можете использовать Find Place (Legacy), чтобы получить place_id , а затем использовать этот ID для выполнения запроса Place Details (Legacy).

Запросы на поиск места (наследие)

Запрос Find Place (Legacy) представляет собой HTTP-URL следующего вида:

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

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

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

Для инициирования запроса Find Place (Legacy) необходимы определенные параметры. Как это принято в URL-адресах, все параметры разделяются символом амперсанда ( & ).

Необходимые параметры

• вход

  Текстовая строка, по которой будет производиться поиск. Это должно быть название места, адрес или номер телефона (например, "123 Main Street" или "City Hall").

  Важно: input должны быть строкой. Запрос Find Place (Legacy), использующий нестроковые данные, такие как координаты широты и долготы или код плюса, приведет к ошибке.

• входной тип

  Тип ввода. Это может быть либо textquery , либо phonenumber . Номера телефонов должны быть в международном формате (с префиксом плюса ("+"), за которым следует код страны, а затем сам номер телефона). Дополнительную информацию см. в рекомендации ITU E.164 .

Дополнительные параметры

• поля

  Внимание: запросы на поиск мест (устаревшая версия) и запросы на получение подробной информации о местах (устаревшая версия) возвращают разные поля. Запросы на поиск мест (устаревшая версия) возвращают подмножество полей, которые возвращаются запросами на получение подробной информации о местах (устаревшая версия). Если нужное вам поле не возвращается запросом на поиск мест (устаревшая версия), вы можете использовать поиск мест (устаревшая версия), чтобы получить place_id , а затем использовать этот Place ID для выполнения запроса на получение подробной информации о местах (устаревшая версия). Для получения дополнительной информации о полях, недоступных в запросе на поиск мест (устаревшая версия), см. раздел «Поддержка полей API мест» .

  Используйте параметр fields для указания списка типов данных о местах, разделенных запятыми, которые необходимо вернуть. Например: fields=formatted_address,name,geometry . Используйте косую черту при указании составных значений. Например: opening_hours/open_now .

  Поля разделены на три категории оплаты: «Базовые» , «Контактные» и «Атмосферные» . Базовые поля оплачиваются по базовой ставке, а поля «Контактные» и «Атмосферные» — по более высокой ставке. За использование базовых полей, полей «Контактные» и «Атмосферные» взимается дополнительная плата к базовой ставке (например, «Подробная информация о местах», «Найти место», «Поиск поблизости» или «Текстовый поиск») за запрос, который их инициировал. Для получения дополнительной информации см. прайс-лист .

  Базовый

  Категория «Основные» включает следующие поля: address_components , adr_address , business_status , formatted_address , geometry , icon , icon_mask_base_uri , icon_background_color , name , permanently_closed ( устарело ), photo , place_id , plus_code , type , url , utc_offset , vicinity , wheelchair_accessible_entrance .

  Контакт

  Категория «Контакты» включает следующие поля: current_opening_hours , formatted_phone_number , international_phone_number , opening_hours , secondary_opening_hours , website

  Атмосфера

  Категория «Атмосфера» включает следующие поля: curbside_pickup , delivery , dine_in , editorial_summary , price_level , rating , reservable , reviews , serves_beer , serves_breakfast , serves_brunch , serves_dinner , serves_lunch , serves_vegetarian_food , serves_wine , takeout , user_ratings_total .

  Примечание: Атрибуции html_attributions ) всегда возвращаются при каждом вызове, независимо от того, запрашивалось ли это поле ранее.

• язык

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

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

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

  Предпочтительные результаты должны находиться в указанной области, для чего можно указать либо радиус плюс широту/долготу, либо две пары широта/долгота, представляющие точки прямоугольника. Если этот параметр не указан, API по умолчанию использует смещение по IP-адресу.

  • IP bias: Указывает API использовать смещение по IP-адресу. Передайте строку ipbias (этот параметр не имеет дополнительных параметров).
  • Круговой: строка, указывающая радиус в метрах, а также широту и долготу в десятичных градусах. Используйте следующий формат: circle:radius@lat,lng .
  • Rectangular: Строка, указывающая две пары широты/долготы в десятичных градусах, представляющие юго-западную и северо-восточную точки прямоугольника. Используйте следующий формат: rectangle:south,west|north,east . Обратите внимание, что значения для востока/запада переносятся в диапазон -180, 180, а значения для севера/юга ограничиваются диапазоном -90, 90.

Примечание: Если вы опустите параметр fields в запросе Find Place (Legacy), будет возвращен только place_id для результата.

Примеры Find Place (Legacy)

В следующем примере показан запрос Find Place (Legacy) для "Музея современного искусства Австралии", включающий поля photos , formatted_address , name , rating , opening_hours и geometry :

локон

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

HTTP

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

В следующем примере показан запрос Find Place (Legacy) для "Mongolian Grill", в котором параметр locationbias используется для предпочтения результатов в пределах 2000 метров от указанных координат:

локон

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

HTTP

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

В следующем примере показан запрос Find Place (Legacy) для номера телефона. Обратите внимание, что международный префикс вызова "+" закодирован в %2B, чтобы этот запрос соответствовал требованиям URL-адреса. Без кодирования префикс "+" был бы декодирован на сервере в пробел, что привело бы к некорректному поиску номера телефона.

локон

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

HTTP

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

Ответы Find Place (Legacy)

Ответ Find Place (Legacy) содержит только те типы данных, которые были указаны с помощью параметра fields , а также html_attributions . В следующем примере показан ответ на запрос Find Place (Legacy) для "Музея современного искусства Австралии", включая поля formatted_address , geometry , name , opening_hours , photos и rating .

JSON

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

XML

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

    

PlacesFindPlaceFromTextResponse

Поле	Необходимый	Тип	Описание
candidates	необходимый	Массив< Место >	Содержит массив кандидатов на роль места. Запросы поиска мест (устаревшая версия) возвращают подмножество полей, которые возвращаются запросами сведений о местах (устаревшая версия). Если нужное вам поле не возвращается запросом поиска мест (устаревшая версия), вы можете использовать запрос поиска мест (устаревшая версия), чтобы получить place_id, а затем использовать этот Place ID для выполнения запроса сведений о местах (устаревшая версия). Более подробную информацию см. в разделе «Место» .
status	необходимый	PlacesSearchStatus	Содержит информацию о статусе запроса и может включать отладочные данные, которые помогут вам выяснить причину сбоя запроса. Дополнительную информацию см. в разделе PlacesSearchStatus .
error_message	необязательный	нить	Если сервис возвращает код состояния, отличный от OK< , в объекте ответа может присутствовать дополнительное поле error_message . Это поле содержит более подробную информацию о причинах присвоения кода состояния. Это поле возвращается не всегда, и его содержимое может изменяться.
info_messages	необязательный	Массив<строка>	Когда сервис возвращает дополнительную информацию о спецификации запроса, в объекте ответа может появиться дополнительное поле info_messages . Это поле возвращается только для успешно выполненных запросов. Оно может возвращаться не всегда, и его содержимое может изменяться.

PlacesSearchStatus

Коды состояния, возвращаемые службой.

• OK означает, что запрос к API был успешно выполнен.
• ZERO_RESULTS означает, что поиск был успешным, но не дал результатов. Это может произойти, если в запросе были переданы latlng в удаленном местоположении.
• INVALID_REQUEST указывает на то, что запрос к API был неправильно сформирован, как правило, из-за отсутствия необходимых параметров запроса ( location или radius ).
• OVER_QUERY_LIMIT указывает на любой из следующих параметров:
  • Вы превысили лимиты QPS.
  • В вашем аккаунте не включена функция выставления счетов.
  • Ежемесячный лимит в 200 долларов, или самостоятельно установленный лимит использования, превышен.
  • Предоставленный способ оплаты больше недействителен (например, срок действия кредитной карты истек).
  Дополнительную информацию о том, как устранить эту ошибку, см. в разделе часто задаваемых вопросов о картах .
• REQUEST_DENIED указывает на то, что ваш запрос был отклонен, как правило, по следующей причине:
  • В запросе отсутствует ключ API.
  • key параметр недействителен.
• UNKNOWN_ERROR указывает на неизвестную ошибку.

Место

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

Поле	Необходимый	Тип	Описание
address_components	необязательный	Массив< AddressComponent >	Массив, содержащий отдельные компоненты, относящиеся к данному адресу. Дополнительную информацию см. в разделе AddressComponent .
adr_address	необязательный	нить	Представление адреса места в микроформате ADR .
business_status	необязательный	нить	Указывает на оперативный статус места, если это коммерческое предприятие. Если данные отсутствуют, business_status не возвращается. The allowed values include: OPERATIONAL , CLOSED_TEMPORARILY , and CLOSED_PERMANENTLY
curbside_pickup	необязательный	логический	Указывает, поддерживает ли предприятие самовывоз заказов.
current_opening_hours	необязательный	Часы работы заведения	Содержит часы работы на следующие семь дней (включая сегодняшний день). Период времени начинается в полночь в день запроса и заканчивается в 23:59 через шесть дней. Это поле включает в себя подполе special_days , содержащее все часы работы, установленные для дат с исключительными графиками. Дополнительную информацию см. в разделе PlaceOpeningHours .
delivery	необязательный	логический	Указывает, поддерживает ли компания доставку.
dine_in	необязательный	логический	Указывает, предоставляет ли заведение возможность размещения посетителей в помещении или на открытом воздухе.
editorial_summary	необязательный	МестоРедакционноеКраткое содержание	Содержит краткое описание места. Краткое описание представляет собой текстовый обзор, а также включает коды языков, если применимо. Текст краткого описания должен быть представлен в неизмененном виде и не может быть изменен или отредактирован. Дополнительную информацию см. в разделе PlaceEditorialSummary .
formatted_address	необязательный	нить	Строка, содержащая удобочитаемый адрес этого места. Часто этот адрес совпадает с почтовым адресом. Следует отметить, что в некоторых странах, например, в Великобритании, распространение настоящих почтовых адресов запрещено из-за ограничений, связанных с лицензированием. Отформатированный адрес логически состоит из одного или нескольких компонентов. Например, адрес «111 8th Avenue, New York, NY» состоит из следующих компонентов: «111» (номер дома), «8th Avenue» (маршрут), «New York» (город) и «NY» (штат США). Не следует программно обрабатывать отформатированный адрес. Вместо этого следует использовать отдельные компоненты адреса, которые, помимо поля отформатированного адреса, содержатся в ответе API.
formatted_phone_number	необязательный	нить	Содержит номер телефона населенного пункта в местном формате .
geometry	необязательный	Geometry	Содержит информацию о местоположении и области просмотра для данного местоположения. Дополнительную информацию см. в Geometry .
icon	необязательный	нить	Содержит URL-адрес предлагаемой иконки, которая может быть отображена пользователю при указании этого результата на карте.
icon_background_color	необязательный	нить	Содержит стандартный шестнадцатеричный цветовой код для категории места.
icon_mask_base_uri	необязательный	нить	Содержит URL-адрес рекомендуемой иконки, за исключением расширения файла .svg или .png .
international_phone_number	необязательный	нить	Содержит номер телефона места в международном формате. Международный формат включает код страны и предваряется знаком плюс (+). Например, международный номер телефона офиса Google в Сиднее, Австралия, — [phone] .
name	необязательный	нить	Содержит удобочитаемое название возвращаемого результата. Для результатов, establishment , это обычно канонизированное название компании.
opening_hours	необязательный	Часы работы заведения	Содержит информацию о стандартном графике работы. Дополнительную информацию см. в разделе PlaceOpeningHours .
permanently_closed	необязательный	логический	Параметр permanently_closed устарел. Используйте business_status для получения информации о текущем состоянии предприятий.
photos	необязательный	Массив< PlacePhoto >	Массив фотообъектов, каждый из которых содержит ссылку на изображение. Запрос может вернуть до десяти фотографий. Более подробную информацию о фотографиях мест и о том, как использовать изображения в вашем приложении, можно найти в документации по фотографиям мест . Дополнительную информацию см. на сайте PlacePhoto .
place_id	необязательный	нить	Текстовый идентификатор, однозначно определяющий местоположение. Для получения информации о месте передайте этот идентификатор в поле place_id запроса к Places API. Дополнительную информацию об идентификаторах мест см. в обзоре идентификаторов мест .
plus_code	необязательный	PlusCode	Закодированная координатная сетка местоположения, полученная из координат широты и долготы, представляет собой область размером 1/8000 градуса на 1/8000 градуса (примерно 14 м x 14 м на экваторе) или меньше. Плюс-коды могут использоваться в качестве замены адресов улиц в местах, где они отсутствуют (где здания не нумеруются или улицы не имеют названий). См. Открытый код местоположения и плюс-коды . Для получения более подробной информации см. PlusCode .
price_level	необязательный	число	Уровень цен в данном месте по шкале от 0 до 4. Точное значение, указанное в каждом конкретном случае, может варьироваться в зависимости от региона. Уровни цен интерпретируются следующим образом: 0 Бесплатно 1. Недорогой 2 Умеренный 3 Дорогой 4 Очень дорого
rating	необязательный	число	Содержит рейтинг места от 1,0 до 5,0, основанный на обобщенных отзывах пользователей.
reference	необязательный	нить	Использование reference устарело.
reservable	необязательный	логический	Указывает, поддерживает ли заведение бронирование.
reviews	необязательный	Массив< PlaceReview >	JSON-массив, содержащий до пяти отзывов. По умолчанию отзывы сортируются по релевантности. Используйте параметр запроса reviews_sort для управления сортировкой. Для most_relevant (по умолчанию) отзывы сортируются по релевантности; сервис будет отбирать отзывы, изначально написанные на предпочитаемом языке. Для newest отзывов они отсортированы в хронологическом порядке; предпочтительный язык не влияет на порядок сортировки. Google рекомендует указывать пользователям, отсортированы ли результаты по most_relevant или newest . Дополнительную информацию можно найти на сайте PlaceReview .
scope	необязательный	нить	scope устарела.
secondary_opening_hours	необязательный	Массив< PlaceOpeningHours >	Содержит массив записей на следующие семь дней, включая информацию о дополнительных часах работы предприятия. Дополнительные часы работы отличаются от основных часов работы предприятия. Например, ресторан может указать часы работы автокассы или часы доставки в качестве дополнительных часов работы. Это поле заполняет подполе type , которое выбирает значения из предопределенного списка типов часов работы (таких как DRIVE_THROUGH , PICKUP или TAKEOUT ) в зависимости от типа заведения. Это поле включает подполе special_days , содержащее все часы работы, установленные для дат с исключительными часами работы. Дополнительную информацию см. в разделе PlaceOpeningHours .
serves_beer	необязательный	логический	Указывает, подают ли в заведении пиво.
serves_breakfast	необязательный	логический	Указывает, подают ли в заведении завтрак.
serves_brunch	необязательный	логический	Указывает, подают ли в заведении бранч.
serves_dinner	необязательный	логический	Указывает, подают ли в заведении ужин.
serves_lunch	необязательный	логический	Указывает, подают ли в заведении обед.
serves_vegetarian_food	необязательный	логический	Указывает, подают ли в заведении вегетарианские блюда.
serves_wine	необязательный	логический	Указывает, подают ли в заведении вино.
takeout	необязательный	логический	Указывает, поддерживает ли заведение доставку еды на вынос.
types	необязательный	Массив<строка>	Содержит массив типов признаков, описывающих заданный результат. См. список поддерживаемых типов .
url	необязательный	нить	Содержит URL-адрес официальной страницы Google для этого места. Это будет страница, принадлежащая Google, содержащая наиболее полную доступную информацию о месте. Приложения должны ссылаться на эту страницу или встраивать её на любой экран, отображающий пользователю подробные результаты поиска по этому месту.
user_ratings_total	необязательный	число	Общее количество отзывов об этом месте, с текстом и без текста.
utc_offset	необязательный	число	Указывается смещение текущего часового пояса данного места относительно UTC на несколько минут. Например, для Сиднея, Австралия, во время действия летнего времени это будет 660 (+11 часов от UTC), а для Калифорнии вне летнего времени — -480 (-8 часов от UTC).
vicinity	необязательный	нить	В результатах поиска по типу заведения ( types:["establishment", ...]) поле " vicinity " содержит упрощенный адрес места, включая название улицы, номер дома и населенный пункт, но не провинцию/штат, почтовый индекс или страну. Для всех остальных результатов поле « vicinity содержит название наиболее узкого политического объекта ( types:["political", ...] ), присутствующего в адресе результата. Данный контент предназначен для прочтения в неизмененном виде. Не следует программно обрабатывать отформатированный адрес.
website	необязательный	нить	Авторитетный веб-сайт этого места, например, главная страница компании.
wheelchair_accessible_entrance	необязательный	логический	Указывает, есть ли в данном месте вход, приспособленный для людей в инвалидных колясках.

МестоРедакционноеКраткое содержание

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

Поле	Необходимый	Тип	Описание
language	необязательный	нить	Язык предыдущих полей. Может отсутствовать.
overview	необязательный	нить	Краткое текстовое описание места средней длины.

Часы работы заведения

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

Поле	Необходимый	Тип	Описание
open_now	необязательный	логический	Логическое значение, указывающее, открыто ли заведение в данный момент времени.
periods	необязательный	Array< PlaceOpeningHoursPeriod >	Представлен список периодов работы заведений, охватывающий семь дней, начиная с воскресенья, в хронологическом порядке. Дополнительную информацию см. в разделе PlaceOpeningHoursPeriod .
special_days	необязательный	Массив< PlaceSpecialDay >	Массив, содержащий до семи записей, соответствующих следующим семи дням. Дополнительную информацию можно найти на сайте PlaceSpecialDay .
type	необязательный	нить	Строка типа, используемая для идентификации типа дополнительных часов работы (например, DRIVE_THROUGH , HAPPY_HOUR , DELIVERY , TAKEOUT , KITCHEN , BREAKFAST , LUNCH , DINNER , BRUNCH , PICKUP , SENIOR_HOURS ). Устанавливается только для secondary_opening_hours .
weekday_text	необязательный	Массив<строка>	Массив строк, описывающих в удобочитаемом текстовом виде часы работы данного места.

Время работы заведения

Поле	Необходимый	Тип	Описание
open	необходимый	Информация о месте, часах работы, периоде работы.	Содержит пару объектов, отображающих день и время, указывающих, когда заведение открывается. Дополнительную информацию см. в разделе PlaceOpeningHoursPeriodDetail .
close	необязательный	Информация о месте, часах работы, периоде работы.	Может содержать пару объектов дня и времени, описывающих время закрытия заведения. Если заведение всегда открыто, раздел закрытия будет отсутствовать в ответе. Клиенты могут рассчитывать на то, что всегда открытое заведение будет представлено как период работы, содержащий день со значением 0 и время со значением 0000 , и без указания close . Дополнительную информацию см. в разделе PlaceOpeningHoursPeriodDetail .

PlaceSpecialDay

Поле	Необходимый	Тип	Описание
date	необязательный	нить	Дата, выраженная в формате RFC3339 в местном часовом поясе данного места, например, 2010-12-31.
exceptional_hours	необязательный	логический	Значение true, если в этот день есть исключительные часы. Если true , это означает, что в этот день есть как минимум одно исключение. Исключения приводят к изменению значений в подполях current_opening_hours и secondary_opening_hours таких как periods , weekday_text , open_now . Исключения применяются к часам, и часы используются для генерации других полей.

Информация о месте, часах работы, периоде работы.

Поле	Необходимый	Тип	Описание
day	необходимый	число	Число от 0 до 6, соответствующее дням недели, начиная с воскресенья. Например, 2 означает вторник.
time	необходимый	нить	Может содержать время суток в 24-часовом формате hhmm. Значения находятся в диапазоне 0000–2359. Время будет указано в часовом поясе данного места.
date	необязательный	нить	Дата, выраженная в формате RFC3339 в местном часовом поясе данного места, например, 2010-12-31.
truncated	необязательный	логический	Значение true, если заданный период был усечен из-за семидневного ограничения, то есть период начинается до полуночи в день запроса и/или заканчивается в полночь или после полуночи в последний день. Это свойство указывает на то, что период открытия или закрытия может выходить за рамки этого семидневного ограничения.

PlacePhoto

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

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

Более подробную информацию смотрите в разделе «Фотографии места» .

Поле	Необходимый	Тип	Описание
height	необходимый	число	Высота фотографии.
html_attributions	необходимый	Массив<строка>	HTML-код для фотографии.
photo_reference	необходимый	нить	Строка, используемая для идентификации фотографии при выполнении запроса на получение фотографии.
width	необходимый	число	Ширина фотографии.

PlaceReview

Отзыв о месте, оставленный пользователем.

Поле	Необходимый	Тип	Описание
author_name	необходимый	нить	Имя пользователя, оставившего отзыв. Анонимные отзывы приписываются «пользователю Google».
rating	необходимый	число	Общая оценка этого места пользователем. Это целое число от 1 до 5.
relative_time_description	необходимый	нить	Время, когда рецензия была отправлена ​​в текстовом виде, относительно текущего времени.
time	необходимый	число	Время отправки отзыва, измеренное в секундах с полуночи 1 января 1970 года по всемирному координированному времени (UTC).
author_url	необязательный	нить	URL-адрес профиля пользователя в Google Maps Local Guides, если таковой имеется.
language	необязательный	нить	Код языка IETF, указывающий язык возвращенного отзыва. Это поле содержит только основной языковой тег, а не вторичный тег, указывающий страну или регион. Например, все отзывы на английском языке помечаются тегом 'en', а не 'en-AU', 'en-UK' и так далее. Это поле пустое, если есть только оценка без текста отзыва.
original_language	необязательный	нить	Код языка IETF, указывающий на исходный язык отзыва. Если отзыв был переведен, то original_language != language . Это поле содержит только основной языковой тег, а не вторичный тег, указывающий на страну или регион. Например, все отзывы на английском языке помечаются тегом 'en', а не 'en-AU', 'en-UK' и так далее. Это поле пустое, если есть только оценка без текста отзыва.
profile_photo_url	необязательный	нить	URL-адрес фотографии профиля пользователя, если она доступна.
text	необязательный	нить	Отзыв пользователя. При написании отзыва о местоположении в Google Places текстовые отзывы считаются необязательными. Поэтому это поле может быть пустым. Обратите внимание, что это поле может содержать базовую HTML-разметку. Например, ссылка на объект & может представлять собой символ амперсанда.
translated	необязательный	логический	Логическое значение, указывающее, был ли отзыв переведен с исходного языка, на котором он был написан. Если отзыв был переведен (значение true), Google рекомендует сообщить об этом пользователям. Например, вы можете добавить к отзыву следующую строку: "Переведено Google".