Find Place (устаревшая версия)

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

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

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

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

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

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

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

Запросы Find Place (устаревшая версия)

Запрос Find Place (Legacy) – это URL с протоколом HTTP следующего формата:

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

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

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

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

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

• ввод

  Строка, в которой нужно выполнить поиск. Нужно указать название места, его адрес или номер телефона (например, "улица Центральная, 123" или "Мэрия").

  Важно! input должно быть строкой. Запрос "Найти место (устаревшая версия)", в котором используются нестроковые данные, например координаты широты и долготы или код Plus Code, приводит к ошибке.

• inputtype

  Тип входных данных. Возможные значения: textquery или phonenumber. Номера телефонов должны быть указаны в международном формате: знак "+", за которым следуют код страны и сам номер телефона. Дополнительные сведения вы найдете в рекомендациях E.164 ITU.

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

• fields

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

  Чтобы указать типы данных о местах, которые нужно возвращать, используйте параметр fields. (например, fields=formatted_address,name,geometry). Если вы указываете составные значения, используйте косую черту. (например, opening_hours/open_now).

  Поля делятся на три категории, которые оплачиваются по разным тарифам: основные данные, контактные данные и данные об атмосфере. Поля Basic оплачиваются по базовой цене, а поля Contact и Atmosphere – по более высокой ставке. Коды Basic, Contact и Atmosphere оплачиваются в дополнение к основному коду (Places Details, Find Place, Nearby Search или Text Search) для запроса, который их вызвал. Подробнее о ценах…

  Basic

  К категории Basic относятся следующие поля: 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.

  Контакт

  В категорию Contact входят следующие поля: current_opening_hours, formatted_phone_number, international_phone_number, opening_hours, secondary_opening_hours, website.

  Atmosphere

  Категория Atmosphere содержит следующие поля: 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) независимо от того, запрашивалось ли это поле.

• language

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

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

• locationbias

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

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

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

Примеры использования функции "Найти место" (устаревшая версия)

Ниже приведен пример запроса Find Place (Legacy) для "Museum of Contemporary Art Australia" с полями photos, formatted_address, name, rating, opening_hours и geometry.

curl

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

HTTP

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

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

curl

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

HTTP

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

Ниже приведен пример запроса Find Place (Legacy) для номера телефона. Обратите внимание, что префикс международного звонка "+" был закодирован как %2B, чтобы запрос соответствовал требованиям к URL. Если не закодировать префикс +, он будет декодирован на сервере как пробел, что приведет к ошибке при поиске номера телефона.

curl

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

HTTP

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

Ответы на запросы Find Place (Legacy)

Ответ на запрос Find Place (устаревшая версия) содержит только типы данных, указанные с помощью параметра fields, а также html_attributions. В примере ниже показан ответ на запрос Find Place (устаревший) для "Museum of Contemporary Art Australia" с полями 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>	Содержит массив кандидатов на место. При запросах Поиск мест (устаревший) возвращается только часть полей, которые возвращаются при запросах информация о местах (устаревший). Если нужное поле не было возвращено Place Search (Legacy), с помощью Place Search (Legacy) можно получить place_id, а затем использовать этот идентификатор места в запросе Place Details (Legacy). Подробнее о местах…
status	Обязательно	PlacesSearchStatus	Содержит статус запроса и может включать отладочную информацию, которая поможет вам понять, почему запрос не был выполнен. Подробнее PlacesSearchStatus…
error_message	необязательно	string	Если сервис возвращает код статуса, отличный от OK<, в объекте ответа может быть дополнительное поле error_message. Это поле содержит более подробную информацию о причинах, по которым был возвращен данный код статуса. Это поле возвращается не всегда, а его содержимое может меняться.
info_messages	необязательно	Array<string>	Если сервис возвращает дополнительную информацию о спецификации запроса, в объекте ответа может быть дополнительное поле info_messages. Это поле возвращается только для успешных запросов. Оно может быть возвращено не всегда, а его содержание может меняться.

PlacesSearchStatus

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

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

Место

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

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

PlaceEditorialSummary

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

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

PlaceOpeningHours

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

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

PlaceOpeningHoursPeriod

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

PlaceSpecialDay

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

PlaceOpeningHoursPeriodDetail

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

PlacePhoto

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

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

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

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

PlaceReview

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

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