Информация о местах (устаревшая версия)

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

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

Этот продукт имеет устаревший статус. С октября 2026 г. Places API (устаревшая версия) нельзя будет включить для новых облачных проектов Google Cloud. Существующие проекты по-прежнему полностью поддерживаются. Чтобы получить доступ к новым функциям и повысить производительность, перейдите на Places API (New).

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

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

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

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

Запросы информации о местах (устаревшая версия)

Запрос информации о местах (устаревший) – это URL с протоколом HTTP следующего вида:

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

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

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

Для инициации запроса поиска места необходимо задать определенные параметры. Параметры разделяются амперсандами (&) в соответствии со стандартом написания URL. В разделах ниже перечислены параметры и их возможные значения.

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

place_id

Уникальный текстовый идентификатор места, возвращаемый поиском мест (устаревшая версия). Подробнее об идентификаторах мест…

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

fields

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

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

Поля делятся на три категории, которые оплачиваются по разным тарифам: основные данные, контактные данные и данные об атмосфере. Оплата по кодам 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 – это синонимы слова "улица" на венгерском языке.

регион

Код региона, указываемый как двухсимвольное значение национального домена верхнего уровня. Большинство кодов ccTLD совпадают с кодами ISO 3166-1, однако имеются некоторые исключения. Например, ccTLD Великобритании – uk (.co.uk), а код ISO 3166-1 – gb (технически для Соединенного Королевства Великобритании и Северной Ирландии).

reviews_no_translations

Укажите reviews_no_translations=true, чтобы отключить перевод отзывов, или reviews_no_translations=false, чтобы включить его. Отзывы возвращаются на языке оригинала.

Если параметр не указан или не имеет значения, перевод отзывов включен. Если в запросе указан параметр language, используйте указанный язык в качестве предпочтительного для перевода. Если параметр language не указан, API попытается использовать язык, заданный в заголовке Accept-Language.

reviews_sort

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

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

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

sessiontoken

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

Сеанс начинается в тот момент, когда пользователь начинает вводить запрос, а завершается тогда, когда он выбирает место и выполняется вызов информации о местах (Legacy). В каждом сеансе может быть несколько запросов, после которых следует выбор одного места. Ключи API, используемые для каждого запроса в рамках сеанса, должны принадлежать одному и тому же проекту Google Cloud Console. Когда сеанс завершается, токен перестает быть действительным. Ваше приложение должно создавать новый токен для каждого сеанса. Если параметр sessiontoken не указан или вы повторно используете токен сеанса, плата за сеанс будет начислена как при отсутствии токена (каждый запрос оплачивается отдельно).

Мы рекомендуем следующее:

• Используйте токены сеансов для всех сеансов автозаполнения.
• Создавайте новый токен для каждого сеанса. Рекомендуется использовать UUID версии 4.
• Убедитесь, что ключи API, используемые для всех запросов автозаполнения мест и информации о местах в рамках сеанса, принадлежат одному и тому же проекту Cloud Console.
• Обязательно передавайте уникальный токен сеанса для каждого нового сеанса. Если использовать один токен для нескольких сеансов, плата за каждый сеанс будет начислена по отдельности.

Внимание! Если вы не укажете хотя бы одно поле с запросом или если не включите параметр fields в запросе, возвращены будут все возможные поля, и за это будет начислена плата. Это относится только к запросам информации о местах (устаревшая версия).

---

Пример информации о местах (устаревшая версия)

В примере ниже запрашивается информация о месте по его идентификатору place_id и включаются поля name, rating и formatted_phone_number.

Ракушка

curl -L -X GET 'https://maps.googleapis.com/maps/api/place/details/json?place_id=ChIJN1t_tDeuEmsRUsoyG83frY4&fields=name%2Crating%2Cformatted_phone_number&key=YOUR_API_KEY'

HTTP

https://maps.googleapis.com/maps/api/place/details/json
  ?fields=name%2Crating%2Cformatted_phone_number
  &place_id=ChIJN1t_tDeuEmsRUsoyG83frY4
  &key=YOUR_API_KEY

Чтобы запрос работал в вашем приложении, замените ключ в этом примере на собственный ключ API.

Ответ с информацией о местах (устаревшая версия)

Ответы на запросы информации о местах (устаревшая версия) возвращаются в формате, указанном в параметре output в пути URL запроса.

JSON

{
  "html_attributions": [],
  "result":
    {
      "address_components":
        [
          { "long_name": "48", "short_name": "48", "types": ["street_number"] },
          {
            "long_name": "Pirrama Road",
            "short_name": "Pirrama Rd",
            "types": ["route"],
          },
          {
            "long_name": "Pyrmont",
            "short_name": "Pyrmont",
            "types": ["locality", "political"],
          },
          {
            "long_name": "City of Sydney",
            "short_name": "City of Sydney",
            "types": ["administrative_area_level_2", "political"],
          },
          {
            "long_name": "New South Wales",
            "short_name": "NSW",
            "types": ["administrative_area_level_1", "political"],
          },
          {
            "long_name": "Australia",
            "short_name": "AU",
            "types": ["country", "political"],
          },
          {
            "long_name": "2009",
            "short_name": "2009",
            "types": ["postal_code"],
          },
        ],
      "adr_address": "48 Pirrama Rd, Pyrmont NSW 2009, Australia",
      "business_status": "OPERATIONAL",
      "formatted_address": "48 Pirrama Rd, Pyrmont NSW 2009, Australia",
      "formatted_phone_number": "[phone]",
      "geometry":
        {
          "location": { "lat": -33.866489, "lng": 151.1958561 },
          "viewport":
            {
              "northeast":
                { "lat": -33.8655112697085, "lng": 151.1971156302915 },
              "southwest":
                { "lat": -33.86820923029149, "lng": 151.1944176697085 },
            },
        },
      "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",
      "international_phone_number": "[phone]",
      "name": "Google Workplace 6",
      "opening_hours":
        {
          "open_now": false,
          "periods":
            [
              {
                "close": { "day": 1, "time": "1700" },
                "open": { "day": 1, "time": "0900" },
              },
              {
                "close": { "day": 2, "time": "1700" },
                "open": { "day": 2, "time": "0900" },
              },
              {
                "close": { "day": 3, "time": "1700" },
                "open": { "day": 3, "time": "0900" },
              },
              {
                "close": { "day": 4, "time": "1700" },
                "open": { "day": 4, "time": "0900" },
              },
              {
                "close": { "day": 5, "time": "1700" },
                "open": { "day": 5, "time": "0900" },
              },
            ],
          "weekday_text":
            [
              "Monday: 9:00 AM – 5:00 PM",
              "Tuesday: 9:00 AM – 5:00 PM",
              "Wednesday: 9:00 AM – 5:00 PM",
              "Thursday: 9:00 AM – 5:00 PM",
              "Friday: 9:00 AM – 5:00 PM",
              "Saturday: Closed",
              "Sunday: Closed",
            ],
        },
      "photos":
        [
          {
            "height": 3024,
            "html_attributions":
              [
                "Cynthia Wei",
              ],
            "photo_reference": "Aap_uEC6jqtpflLS8GxQqPHBjlcwBf2sri0ZErk9q1ciHGZ6Zx5HBiiiEsPEO3emtB1PGyWbBQhgPL2r9CshoVlJEG4xzB71QMhGBTqqeaCNk1quO3vTTiP50aM1kmOaBQ-DF1ER7zpu6BQOEtnusKMul0m4KA45wfE3h6Xh2IxjLNzx-IiX",
            "width": 4032,
          },
          {
            "height": 3264,
            "html_attributions":
              [
                "Heyang Li",
              ],
            "photo_reference": "Aap_uECyRjHhOQgGaKTW6Z3ZfTEaDhNc44m0F6GrNSFIMffixwI5xqD35QhecdzVY-FUuDtVE1huu8-2HkxgI9Gwvy6W18fU-_E3UUkdSFBQqGK8_slKlT8BZZc66sTX53IEcTDrZfT-E5_YUBYBOm13yxOTOfWfEDABhaxCGC5Hu_XYh0fI",
            "width": 4912,
          },
          // ...
        ],
      "place_id": "ChIJN1t_tDeuEmsRUsoyG83frY4",
      "plus_code":
        {
          "compound_code": "45MW+C8 Pyrmont NSW, Australia",
          "global_code": "4RRH45MW+C8",
        },
      "rating": 4,
      "reference": "ChIJN1t_tDeuEmsRUsoyG83frY4",
      "reviews":
        [
          {
            "author_name": "Luke Archibald",
            "author_url": "https://www.google.com/maps/contrib/113389359827989670652/reviews",
            "language": "en",
            "profile_photo_url": "https://lh3.googleusercontent.com/a-/AOh14GhGGmTmvtD34HiRgwHdXVJUTzVbxpsk5_JnNKM5MA=s128-c0x00000000-cc-rp-mo",
            "rating": 1,
            "relative_time_description": "a week ago",
            "text": "Beautiful building with a great view.",
            "time": 1652286798,
          },
          {
            "author_name": "Tevita Taufoou",
            "author_url": "https://www.google.com/maps/contrib/105937236918123663309/reviews",
            "language": "en",
            "profile_photo_url": "https://lh3.googleusercontent.com/a/AATXAJwZANdRSSg96QeZG--6BazG5uv_BJMIvpZGqwSz=s128-c0x00000000-cc-rp-mo",
            "rating": 1,
            "relative_time_description": "6 months ago",
            "text": "Conference rooms were well equipped.",
            "time": 1637215605,
          },
          // ...
        ],
      "types": ["point_of_interest", "establishment"],
      "url": "https://maps.google.com/?cid=10281119596374313554",
      "user_ratings_total": 939,
      "utc_offset": 600,
      "vicinity": "48 Pirrama Road, Pyrmont",
      "website": "http://google.com/",
    },
  "status": "OK",
}
    

XML

<?xml version="1.0" encoding="UTF-8"?>
<PlaceDetailsResponse>
 <status>OK</status>
 <result>
  <name>Google Workplace 6</name>
  <vicinity>48 Pirrama Road, Pyrmont</vicinity>
  <type>point_of_interest</type>
  <type>establishment</type>
  <formatted_phone_number>[phone]</formatted_phone_number>
  <formatted_address>48 Pirrama Rd, Pyrmont NSW 2009, Australia</formatted_address>
  <address_component>
   <long_name>48</long_name>
   <short_name>48</short_name>
   <type>street_number</type>
  </address_component>
  <address_component>
   <long_name>Pirrama Road</long_name>
   <short_name>Pirrama Rd</short_name>
   <type>route</type>
  </address_component>
  <address_component>
   <long_name>Pyrmont</long_name>
   <short_name>Pyrmont</short_name>
   <type>locality</type>
   <type>political</type>
  </address_component>
  <address_component>
   <long_name>City of Sydney</long_name>
   <short_name>City of Sydney</short_name>
   <type>administrative_area_level_2</type>
   <type>political</type>
  </address_component>
  <address_component>
   <long_name>New South Wales</long_name>
   <short_name>NSW</short_name>
   <type>administrative_area_level_1</type>
   <type>political</type>
  </address_component>
  <address_component>
   <long_name>Australia</long_name>
   <short_name>AU</short_name>
   <type>country</type>
   <type>political</type>
  </address_component>
  <address_component>
   <long_name>2009</long_name>
   <short_name>2009</short_name>
   <type>postal_code</type>
  </address_component>
  <geometry>
   <location>
    <lat>-33.8664890</lat>
    <lng>151.1958561</lng>
   </location>
   <viewport>
    <southwest>
     <lat>-33.8682092</lat>
     <lng>151.1944177</lng>
    </southwest>
    <northeast>
     <lat>-33.8655113</lat>
     <lng>151.1971156</lng>
    </northeast>
   </viewport>
  </geometry>
  <rating>4.0</rating>
  <url>https://maps.google.com/?cid=10281119596374313554</url>
  <icon>https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/generic_business-71.png</icon>
  <reference>ChIJN1t_tDeuEmsRUsoyG83frY4</reference>
  <international_phone_number>[phone]</international_phone_number>
  <website>http://google.com/</website>
  <review>
   <time>1652286798</time>
   <text>Beautiful building with a great view.</text>
   <author_name>Luke Archibald</author_name>
   <author_url>https://www.google.com/maps/contrib/113389359827989670652/reviews</author_url>
   <rating>1.0</rating>
   <language>en</language>
   <profile_photo_url>https://lh3.googleusercontent.com/a-/AOh14GhGGmTmvtD34HiRgwHdXVJUTzVbxpsk5_JnNKM5MA=s128-c0x00000000-cc-rp-mo</profile_photo_url>
   <relative_time_description>a week ago</relative_time_description>
  </review>
  <review>
   <time>1637215605</time>
   <text>Conference rooms were well equipped.</text>
   <author_name>Joe Schmoe</author_name>
   <author_url>https://www.google.com/maps/contrib/105937236918123663309/reviews</author_url>
   <rating>1.0</rating>
   <language>en</language>
   <profile_photo_url>https://lh3.googleusercontent.com/a/AATXAJwZANdRSSg96QeZG--6BazG5uv_BJMIvpZGqwSz=s128-c0x00000000-cc-rp-mo</profile_photo_url>
   <relative_time_description>6 months ago</relative_time_description>
  </review>
  <!-- ... -->
  <opening_hours>
   <open_now>false</open_now>
   <period>
    <open>
     <day>1</day>
     <time>0900</time>
    </open>
    <close>
     <day>1</day>
     <time>1700</time>
    </close>
   </period>
   <period>
    <open>
     <day>2</day>
     <time>0900</time>
    </open>
    <close>
     <day>2</day>
     <time>1700</time>
    </close>
   </period>
   <period>
    <open>
     <day>3</day>
     <time>0900</time>
    </open>
    <close>
     <day>3</day>
     <time>1700</time>
    </close>
   </period>
   <period>
    <open>
     <day>4</day>
     <time>0900</time>
    </open>
    <close>
     <day>4</day>
     <time>1700</time>
    </close>
   </period>
   <period>
    <open>
     <day>5</day>
     <time>0900</time>
    </open>
    <close>
     <day>5</day>
     <time>1700</time>
    </close>
   </period>
   <weekday_text>Monday: 9:00 AM – 5:00 PM</weekday_text>
   <weekday_text>Tuesday: 9:00 AM – 5:00 PM</weekday_text>
   <weekday_text>Wednesday: 9:00 AM – 5:00 PM</weekday_text>
   <weekday_text>Thursday: 9:00 AM – 5:00 PM</weekday_text>
   <weekday_text>Friday: 9:00 AM – 5:00 PM</weekday_text>
   <weekday_text>Saturday: Closed</weekday_text>
   <weekday_text>Sunday: Closed</weekday_text>
  </opening_hours>
  <utc_offset>600</utc_offset>
  <photo>
   <photo_reference>Aap_uEDT4DC26Lk_VoI6CvsZl1NzU7BOPjEyqEHlf8tCA0hFtlrsI1Tmed_LmjSUQghWnZq-E7SsYZSlvGP0X5ZAfH6w0Tmw6biO4PPI8BTPwvo6FqLfZgC2RGNQyI81HRnJGB3ZJUAYEXvxBfA_upEcsITxk52joPkK9d7cfFptY0z-Oy7Y</photo_reference>
   <width>4032</width>
   <height>3024</height>
   <html_attribution>&lt;a href=&quot;https://maps.google.com/maps/contrib/117600448889234589608&quot;&gt;Cynthia Wei&lt;/a&gt;</html_attribution>
  </photo>
  <photo>
   <photo_reference>Aap_uEAPNVkxDxxHa0aRFAkA2gMygFUuaKujSSv-zdad_vuaxTkaDHgX-aVPeNATp7VEgwqa3A3QutoeKdDd6aGZPBPCLl8XTf1vYckEBxIWEXZjFlMXK2TwIVfe4qa6O31AbYQQ5TCrEs9nz2fuBBWJwifTiKIIrv4NrEpQok6i8nnn8xKS</photo_reference>
   <width>4912</width>
   <height>3264</height>
   <html_attribution>&lt;a href=&quot;https://maps.google.com/maps/contrib/102493344958625549078&quot;&gt;Heyang Li&lt;/a&gt;</html_attribution>
  </photo>
  <!-- ... -->
  <adr_address>&lt;span class=&quot;street-address&quot;&gt;48 Pirrama Rd&lt;/span&gt;, &lt;span class=&quot;locality&quot;&gt;Pyrmont&lt;/span&gt; &lt;span class=&quot;region&quot;&gt;NSW&lt;/span&gt; &lt;span class=&quot;postal-code&quot;&gt;2009&lt;/span&gt;, &lt;span class=&quot;country-name&quot;&gt;Australia&lt;/span&gt;</adr_address>
  <user_ratings_total>939</user_ratings_total>
  <place_id>ChIJN1t_tDeuEmsRUsoyG83frY4</place_id>
  <plus_code>
   <global_code>4RRH45MW+C8</global_code>
   <compound_code>45MW+C8 Pyrmont NSW, Australia</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>
</PlaceDetailsResponse>

    

Ответы JSON и XML содержат следующие элементы:

PlacesDetailsResponse

Поле	Обязательно	Тип	Описание
html_attributions	Обязательно	Array<string>	Может содержать набор атрибутов, которые должны быть показаны пользователю (у некоторых объектов атрибуты могут отсутствовать).
result	Обязательно	Место	Содержит подробную информацию о запрашиваемом месте. Подробнее о местах…
status	Обязательно	PlacesDetailsStatus	Содержит статус запроса и может содержать сведения для отладки, которые помогут вам выяснить, почему запрос не был выполнен. Подробную информацию можно найти в разделе PlacesDetailsStatus.
info_messages	необязательно	Array<string>	Если сервис возвращает дополнительную информацию о спецификации запроса, в объекте ответа может быть дополнительное поле info_messages. Это поле возвращается только для успешных запросов. Оно может возвращаться не всегда, а его содержимое может меняться.

В ответе JSON они представлены как корневые элементы. В ответе XML они представлены как элементы верхнего уровня под <PlaceDetailsResponse>.

PlacesDetailsStatus

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

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

Место

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

Поле	Обязательно	Тип	Описание
address_components	необязательно	Array<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 в Сиднее (Австралия) значение international_phone_number – [phone].
name	необязательно	string	Содержит человекочитаемое название возвращенного результата. Для результатов типа establishment это обычно канонизированное название компании.
opening_hours	необязательно	PlaceOpeningHours	Обычные часы работы. Дополнительную информацию см. в разделе PlaceOpeningHours.
permanently_closed	необязательно	Логическое значение	permanently_closed больше не поддерживается. Используйте business_status, чтобы получать данные о статусе компаний.
photos	необязательно	Array<PlacePhoto>	Массив объектов фотографий, каждый из которых содержит ссылку на изображение. В ответе на запрос может быть до десяти фотографий. Дополнительную информацию о фотографиях мест и о том, как использовать их в приложении, можно найти в документации по Place Photos. Подробную информацию можно найти в статье 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	необязательно	Array<PlaceOpeningHoursPeriod>	Хронологически упорядоченный массив часов работы, содержащий данные по семи дням недели, начиная с воскресенья. Дополнительную информацию можно найти в описании PlaceOpeningHoursPeriod.
special_days	необязательно	Array<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. Можно уверенно считать, что место работает круглосуточно, если период open содержит параметр 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

Подробнее о Place Photos…

Поле	Обязательно	Тип	Описание
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	Обязательно	число	Время отправки отзыва, измеряемое в секундах, прошедших с полуночи 1 января 1970 года по всемирному координированному времени.
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".