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

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

Запрос Find Place (Legacy) принимает текстовый ввод и возвращает местоположение. В качестве ввода могут использоваться любые текстовые данные Places, такие как имя, адрес или номер телефона. Запрос должен быть строкой. Запрос Find Place (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". Это должно быть название места, адрес или категория заведений. Любые другие типы ввода могут привести к ошибкам и не гарантируют получения корректных результатов. API Places вернет подходящие варианты на основе этой строки и упорядочит результаты в зависимости от их предполагаемой релевантности.

  • входной тип

    Тип ввода. Это может быть либо 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.

Примеры 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

Поле Необходимый Тип Описание
необходимый Массив< Место >

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

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

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

необходимый PlacesSearchStatus

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

Дополнительную информацию см. в разделе PlacesSearchStatus .

необязательный нить

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

необязательный Массив<строка>

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

PlacesSearchStatus

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

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

Место

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

Поле Необходимый Тип Описание
необязательный Массив< AddressComponent >

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

Дополнительную информацию см. в разделе AddressComponent .

необязательный нить

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

необязательный нить

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

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

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

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

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

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

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

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

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

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

необязательный МестоРедакционноеКраткое содержание

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

Дополнительную информацию см. в разделе PlaceEditorialSummary .

необязательный нить

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

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

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

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

необязательный нить

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

необязательный Geometry

Содержит информацию о местоположении и области просмотра для данного местоположения.

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

необязательный нить

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

необязательный нить

Содержит стандартный шестнадцатеричный цветовой код для категории места.

необязательный нить

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

необязательный нить

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

необязательный нить

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

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

Содержит информацию о стандартном графике работы.

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

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

Используйте business_status для получения информации о текущем состоянии предприятий.

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

Массив фотообъектов, каждый из которых содержит ссылку на изображение. Запрос может вернуть до десяти фотографий. Более подробную информацию о фотографиях мест и о том, как использовать изображения в вашем приложении, можно найти в документации по фотографиям мест .

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

необязательный нить

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

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

Закодированная координатная сетка местоположения, полученная из координат широты и долготы, представляет собой область размером 1/8000 градуса на 1/8000 градуса (примерно 14 м x 14 м на экваторе) или меньше. Плюс-коды могут использоваться в качестве замены адресов улиц в местах, где они отсутствуют (где здания не нумеруются или улицы не имеют названий). См. Открытый код местоположения и плюс-коды .

Для получения более подробной информации см. PlusCode .

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

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

  • 0 Бесплатно
  • 1. Недорогой
  • 2 Умеренный
  • 3 Дорогой
  • 4 Очень дорого
необязательный число

Содержит рейтинг места от 1,0 до 5,0, основанный на обобщенных отзывах пользователей.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

необязательный Массив<строка>

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

необязательный нить

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

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

Общее количество отзывов об этом месте, с текстом и без текста.

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

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

необязательный нить

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

Для всех остальных результатов поле « vicinity содержит название наиболее узкого политического объекта ( types:["political", ...] ), присутствующего в адресе результата.

Данный контент предназначен для прочтения в неизмененном виде. Не следует программно обрабатывать отформатированный адрес.

необязательный нить

Авторитетный веб-сайт этого места, например, главная страница компании.

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

Указывает, есть ли в данном месте вход, приспособленный для людей в инвалидных колясках.

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

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

Поле Необходимый Тип Описание
необязательный нить

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

необязательный нить

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

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

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

Поле Необходимый Тип Описание
необязательный логический

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

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

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

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

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

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

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

необязательный нить

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

weekday_text

 необязательный Массив<строка>

Массив строк, описывающих в удобочитаемом текстовом виде часы работы данного места.

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

Поле Необходимый Тип Описание
необходимый Информация о месте, часах работы, периоде работы.

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

Дополнительную информацию см. в разделе PlaceOpeningHoursPeriodDetail .

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

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

Дополнительную информацию см. в разделе PlaceOpeningHoursPeriodDetail .

PlaceSpecialDay

Поле Необходимый Тип Описание
необязательный нить

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

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

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

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

Поле Необходимый Тип Описание
необходимый число

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

необходимый нить

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

необязательный нить

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

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

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

PlacePhoto

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

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

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

Поле Необходимый Тип Описание
необходимый число

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

необходимый Массив<строка>

HTML-код для фотографии.

необходимый нить

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

необходимый число

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

PlaceReview

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

Поле Необходимый Тип Описание
необходимый нить

Имя пользователя, оставившего отзыв. Анонимные отзывы приписываются «пользователю Google».

необходимый число

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

необходимый нить

Время, когда рецензия была отправлена ​​в текстовом виде, относительно текущего времени.

необходимый число

Время отправки отзыва, измеренное в секундах с полуночи 1 января 1970 года по всемирному координированному времени (UTC).

необязательный нить

URL-адрес профиля пользователя в Google Maps Local Guides, если таковой имеется.

необязательный нить

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

необязательный нить

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

необязательный нить

URL-адрес фотографии профиля пользователя, если таковая имеется.

text

 необязательный нить

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

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

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