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

Чтобы переводить контент на ваш предпочитаемый язык, Google использует технологии на основе искусственного интеллекта. Переводы от ИИ могут содержать ошибки.

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

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

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

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) возвращают разные поля. При запросах Place Search (Legacy) возвращается только часть полей, которые возвращаются при запросах Place Details (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": "(02) 9374 4000",
      "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": "+61 2 9374 4000",
      "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>(02) 9374 4000</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>+61 2 9374 4000</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`	Обязательно	Place	Содержит подробную информацию о запрашиваемом месте. Подробнее о типе Place…
`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`	необязательно	Массив<`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 – `+61 2 9374 4000`.
`name`	необязательно	string	Содержит человекочитаемое название возвращенного результата. Для результатов `establishment` это обычно канонизированное название компании.
`opening_hours`	необязательно	PlaceOpeningHours	Обычные часы работы. Дополнительную информацию см. в разделе PlaceOpeningHours.
`permanently_closed`	необязательно	Логическое значение	`permanently_closed` больше не поддерживается. Используйте `business_status`, чтобы получать данные о статусе компаний.
`photos`	необязательно	Массив<PlacePhoto>	Массив объектов фотографий, каждый из которых содержит ссылку на изображение. В ответе на запрос может быть до 10 фотографий. Дополнительную информацию о фотографиях мест и о том, как использовать их в приложении, можно найти в документации по 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`	необязательно	Массив<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

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

Поле	Обязательно	Тип	Описание
`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".

Информация о местах (устаревшая версия) Оптимизируйте свои подборки Сохраняйте и классифицируйте контент в соответствии со своими настройками.

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

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

place_id

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

fields

language

регион

reviews_no_translations

reviews_sort

sessiontoken

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

Ракушка

HTTP

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

JSON

XML

PlacesDetailsResponse

html_attributions

result

status

info_messages

PlacesDetailsStatus

Место

address_components

adr_address

business_status

curbside_pickup

current_opening_hours

delivery

dine_in

editorial_summary

formatted_address

formatted_phone_number

geometry

icon

icon_background_color

icon_mask_base_uri

international_phone_number

name

opening_hours

permanently_closed

photos

place_id

plus_code

price_level

rating

reference

reservable

reviews

scope

secondary_opening_hours

serves_beer

serves_breakfast

serves_brunch

serves_dinner

serves_lunch

serves_vegetarian_food

serves_wine

takeout

types

url

user_ratings_total

utc_offset

vicinity

website

wheelchair_accessible_entrance

PlaceEditorialSummary

language

overview

PlaceOpeningHours

open_now

periods

special_days

type

weekday_text

PlaceOpeningHoursPeriod

open

close

PlaceSpecialDay

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

`html_attributions`

`result`

`status`

`info_messages`

`address_components`

`adr_address`

`business_status`

`curbside_pickup`

`current_opening_hours`

`delivery`

`dine_in`

`editorial_summary`

`formatted_address`

`formatted_phone_number`

`geometry`

`icon`

`icon_background_color`

`icon_mask_base_uri`

`international_phone_number`

`name`

`opening_hours`

`permanently_closed`

`photos`

`place_id`

`plus_code`

`price_level`

`rating`

`reference`

`reservable`

`reviews`

`scope`

`secondary_opening_hours`

`serves_beer`

`serves_breakfast`

`serves_brunch`

`serves_dinner`

`serves_lunch`

`serves_vegetarian_food`

`serves_wine`

`takeout`

`types`

`url`

`user_ratings_total`

`utc_offset`

`vicinity`

`website`

`wheelchair_accessible_entrance`

`language`

`overview`

`open_now`

`periods`

`special_days`

`type`

`weekday_text`

`open`

`close`

`date`

`exceptional_hours`

`day`

`time`

`date`

`truncated`

`height`

`html_attributions`

`photo_reference`

`width`

`author_name`

`rating`

`relative_time_description`

`time`

`author_url`

`language`

`original_language`

`profile_photo_url`

`text`

`translated`