Получив place_id в результате поиска места, вы можете запросить дополнительную информацию об определенном заведении или достопримечательности, отправив запрос "Информация о месте (устаревшая версия)". Запрос 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) в виде двух символов. Большинство кодов 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отзывы сортируются в хронологическом порядке. Предпочитаемый язык не влияет на порядок сортировки.
Google рекомендует показывать конечным пользователям, как сортируются отзывы.
-
Для
-
sessiontoken
Случайная строка, которая идентифицирует сеанс автозаполнения для выставления счетов.
Сеанс начинается в тот момент, когда пользователь начинает вводить запрос, а завершается тогда, когда он выбирает место и выполняется вызов информации о местах (устаревшая версия). В каждом сеансе может быть несколько запросов, после которых следует выбор одного места. Ключи API, используемые для каждого запроса в рамках сеанса, должны относиться к одному и тому же проекту Google Cloud Console. Когда сеанс завершается, токен перестает быть действительным. Ваше приложение должно создавать новый токен для каждого сеанса. Если параметр
sessiontokenне указан или вы повторно используете токен сеанса, плата за сеанс будет начислена как при отсутствии токена (каждый запрос оплачивается отдельно).Мы рекомендуем следовать следующим правилам:
- Используйте токены сеансов для всех сеансов автозаполнения.
- Создавайте новый токен для каждого сеанса. Рекомендуется использовать UUID версии 4.
- Убедитесь, что ключи API, используемые для всех запросов автозаполнения мест и информации о местах в рамках сеанса, относятся к одному и тому же проекту Cloud Console.
- Обязательно передавайте уникальный токен сеанса для каждого нового сеанса. Если использовать один токен для нескольких сеансов, плата за каждый сеанс будет начислена по отдельности.
Пример информации о местах (устаревшая версия)
В примере ниже показан запрос сведений о месте по идентификатору 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, }, { "height": 3036, "html_attributions": [ "Anna Linetsky", ], "photo_reference": "Aap_uEAumTzSdhRHDutPAj6wVPSZZmBV-brI6TPFwI0tcQlbSR74z44mUPr4aXMQKck_AzHaKmbfR3P2c1qsu45i1RQPHrcpIXxrA78FmDjCdWYYZWUnFozdcmEj9OQ_V0G08adpKivMKZyeaQ1NuwRy9GhSopeKpzkzkFZG5vXMYPPSgpa1", "width": 4048, }, { "height": 4016, "html_attributions": [ "Jonah Dell", ], "photo_reference": "Aap_uECC7cSbDkh-TdmXr6m5d5pgVXJmvXg8dF2jzhL0b0Ko4CtnVll6-tIvdz7vhbCsd3hl2u9EgZ4Y30FBxKmFcimfeYUgW2XJyv8JY5IYGuXsKkCLqpV3QH9dIGwoUv2uX0eosDsUsTN2DOlyOasUgVxcYqzIzEmrL5ofIssThQWZeozD", "width": 6016, }, { "height": 3024, "html_attributions": [ "Anthony Huynh", ], "photo_reference": "Aap_uEDTdw58CglFmZZAR9iZ05x3y2oK9r5_dRqKWnbZKSS9gs6gp9AeBa1QDvBL6dzZyQAZfN8H2Eppu6y4NBaPOp-GkulZYiKRM7Yww8sUEv-8dmcq35Tx38pe4LEX2wIicFkQHedRgMc0FfV9aFtgosQ5ps5-HCjJSApg8eLGyuxxqPm9", "width": 4032, }, { "height": 3024, "html_attributions": [ "Jasen Baker", ], "photo_reference": "Aap_uEAGqslqZPhZUk0T2Y6l7mkCYnY7JN9li4g5NkZsE0N4Cdy7_cZ-fZWyV02VhpQR4Ph4fLUL6_WTXrlGMXXzUJXUcSmSTs2d_Dzf3Q_A1y07Dm-vtv7pS3JXsWyrWETGIoT1pIj81PPdUc1vlR2i3GFMWAbx9rCC472ZJclY8JlvMg-x", "width": 4032, }, { "height": 3024, "html_attributions": [ "Jeremy Hsiao", ], "photo_reference": "Aap_uEBaGxeN90YFjD-AUjxZqM44kpMcICKKBBhb0RQQS7DHHFaay8RRAwjWsAt8GEmmB5QnxrbQWHU3TwhVXXHP0m-YNp9Ds3ihpiFan0moNv4QB7kern5cfjWhhrWe8B0dz_vYvmPssJE24P-24YfWWHubOo0L2MjQyueZfDv57N_RvDZk", "width": 4032, }, { "height": 1515, "html_attributions": [ "Andrew W", ], "photo_reference": "Aap_uEBDzJlmTeNUreMop6_hkC1HKTCRLyPs5fikJi58qCejtkWp5PIM6vzNN3HErkSWUwnamTr_WLyT7jXMAIdByR-hx8dG-OHjj5JxzmcPvuT_VeVLmdSbNPeIlpmp6EUcPOhaVrhEKojSd44QXkl0za29eZ0oj1KDOnAsGxmhanDFW7lI", "width": 2048, }, { "height": 3024, "html_attributions": [ "Jeremy Hsiao", ], "photo_reference": "Aap_uEBvYFpzCDQzvQ0kdBxxB70lTkLbTM0yH3xF-BCHsb7DQ63cuWnutvwv8oVLDSbA14_kns3WVlEInTyy2elvmH5lzQteb6zzRu3exkwE65_55TgJqdLO7RYYiPFliWk4ocszn9nn5ELv5uP2BQmqr9QET5vwgxR-0eshyVmcdM42jb39", "width": 4032, }, { "height": 4032, "html_attributions": [ "Jeremy Hsiao", ], "photo_reference": "Aap_uECQynuD_EnSnbz8sJQ6-B6uR-j2tuu4Z1tuGUjq8xnxFDk-W8OdeLzWBX8suNKTCsPlkzTqC22BXf_hX33XclGPL4SS9xnPmHcMrLoUl0H_xHYevFvT17Hgw5DZpSyVmLvDvxzzJ1rsZTh55QwopmAty083a1r1ZIfL32iXh_q8FUas", "width": 3024, }, ], "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, }, { "author_name": "Jordy Baker", "author_url": "https://www.google.com/maps/contrib/102582237417399865640/reviews", "language": "en", "profile_photo_url": "https://lh3.googleusercontent.com/a/AATXAJwgg1tM4aVA4nJCMjlfJtHtFZuxF475Vb6tT74S=s128-c0x00000000-cc-rp-mo", "rating": 1, "relative_time_description": "4 months ago", "text": "The staff is very friendly.", "time": 1641389490, }, { "author_name": "Prem Rathod", "author_url": "https://www.google.com/maps/contrib/115981614018592114142/reviews", "language": "en", "profile_photo_url": "https://lh3.googleusercontent.com/a/AATXAJyEQpqs4YvPPzMPG2dnnRTFPC4jxJfn8YXnm2gz=s128-c0x00000000-cc-rp-mo", "rating": 1, "relative_time_description": "4 months ago", "text": "The location is convenient and easy to find.", "time": 1640159655, }, { "author_name": "Husuni Hamza", "author_url": "https://www.google.com/maps/contrib/102167316656574288776/reviews", "language": "en", "profile_photo_url": "https://lh3.googleusercontent.com/a/AATXAJwRkyvoSlgd06ahkF9XI9D39o6Zc_Oycm5EKuRg=s128-c0x00000000-cc-rp-mo", "rating": 5, "relative_time_description": "7 months ago", "text": "A modern and impressive facility.", "time": 1633197305, }, ], "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> <review> <time>1641389490</time> <text>The staff is very friendly.</text> <author_name>Jordy Baker</author_name> <author_url>https://www.google.com/maps/contrib/102582237417399865640/reviews</author_url> <rating>1.0</rating> <language>en</language> <profile_photo_url>https://lh3.googleusercontent.com/a/AATXAJwgg1tM4aVA4nJCMjlfJtHtFZuxF475Vb6tT74S=s128-c0x00000000-cc-rp-mo</profile_photo_url> <relative_time_description>4 months ago</relative_time_description> </review> <review> <time>1640159655</time> <text>The location is convenient and easy to find.</text> <author_name>Prem Rathod</author_name> <author_url>https://www.google.com/maps/contrib/115981614018592114142/reviews</author_url> <rating>1.0</rating> <language>en</language> <profile_photo_url>https://lh3.googleusercontent.com/a/AATXAJyEQpqs4YvPPzMPG2dnnRTFPC4jxJfn8YXnm2gz=s128-c0x00000000-cc-rp-mo</profile_photo_url> <relative_time_description>4 months ago</relative_time_description> </review> <review> <time>1633197305</time> <text>A modern and impressive facility.</text> <author_name>Husuni Hamza</author_name> <author_url>https://www.google.com/maps/contrib/102167316656574288776/reviews</author_url> <rating>5.0</rating> <language>en</language> <profile_photo_url>https://lh3.googleusercontent.com/a/AATXAJwRkyvoSlgd06ahkF9XI9D39o6Zc_Oycm5EKuRg=s128-c0x00000000-cc-rp-mo</profile_photo_url> <relative_time_description>7 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><a href="https://maps.google.com/maps/contrib/117600448889234589608">Cynthia Wei</a></html_attribution> </photo> <photo> <photo_reference>Aap_uEAPNVkxDxxHa0aRFAkA2gMygFUuaKujSSv-zdad_vuaxTkaDHgX-aVPeNATp7VEgwqa3A3QutoeKdDd6aGZPBPCLl8XTf1vYckEBxIWEXZjFlMXK2TwIVfe4qa6O31AbYQQ5TCrEs9nz2fuBBWJwifTiKIIrv4NrEpQok6i8nnn8xKS</photo_reference> <width>4912</width> <height>3264</height> <html_attribution><a href="https://maps.google.com/maps/contrib/102493344958625549078">Heyang Li</a></html_attribution> </photo> <photo> <photo_reference>Aap_uEBXOmqXNblj10HJavekmUNyUwccggfNN9KVE9TjYcU9HXkBHdvnwfYHDx3dfrjJJwnN8yooP-5412iJNRk8cwUbAVYbD2326cfiJJ3oK6pOrAi1oBmCYuAwKTHnX3EQvSbheVhJZPNDHlT5TjKcwfwAb80eyLB2UNyWl3Y6D7YS7ZSf</photo_reference> <width>4048</width> <height>3036</height> <html_attribution><a href="https://maps.google.com/maps/contrib/104829437842034782235">Anna Linetsky</a></html_attribution> </photo> <photo> <photo_reference>Aap_uEAWyGsK1fp3SE73xICq8FJNlrVVqRk8E6YfMiz-o8IJj1vESmuDj4NnPDP4S2kWFrfoBpqw9lmXBGxtYo6nPMySfBAcRIbdEg0ko4dcdzsBvo6cRUz9XpmlcoptCpIAKEb6f7Bh_OD0zFntYbTz-pLdQ9ZHB8tBvTb3kzfTdK2Du0yC</photo_reference> <width>6016</width> <height>4016</height> <html_attribution><a href="https://maps.google.com/maps/contrib/107755640736541028674">Jonah Dell</a></html_attribution> </photo> <photo> <photo_reference>Aap_uEAxbn61tx1hwCo3kUMd2KPlWaBkrFhXHxsZDgkYxpJqc-ZYC6U0MH6urfbHVrwmMoosOG0G39anmR68B7p2Up3AACxTa21vCopSL6-RHIphVsBhfhOrFMlGNqBDEsnmY15X0FzzNMKASXqmqtzBphiRyGhAFKfRs3Js1ymXP_FWjqzT</photo_reference> <width>4032</width> <height>3024</height> <html_attribution><a href="https://maps.google.com/maps/contrib/115886271727815775491">Anthony Huynh</a></html_attribution> </photo> <photo> <photo_reference>Aap_uEClwnjuvgS58OknaXxZeVGf5ydyG6U6lO9srr8FU7tPoZ4DvqQo-GUeemssC11tzDBUMWit4ILWF-GmlRfIHS8FuAtttOgp2wvgPhs-ADUrznLRXYKBRkNQnRLEIA1PBgJN9Eev8tFWxpY_jBMklkEUZJRjm-mk9R0bSKSelpPgMYAz</photo_reference> <width>4032</width> <height>3024</height> <html_attribution><a href="https://maps.google.com/maps/contrib/102939237947063969663">Jasen Baker</a></html_attribution> </photo> <photo> <photo_reference>Aap_uEBvISYtwjSgTQntTJJ_-XhPUF4CVCQF3wxM0FjcQJuzomYLfZWFlIWsOgXhwt2Sd8K6OqFrSP8XHHrBaqQJHD-om-H_wfRLVmiAoQa8QG5oxt540AucTMP4H2QfhTXngqEoNuOcbb-xo2l01OPUetTdIZQ3S6U5s2iyGrHpTs3qz8CH</photo_reference> <width>4032</width> <height>3024</height> <html_attribution><a href="https://maps.google.com/maps/contrib/100678816592586275978">Jeremy Hsiao</a></html_attribution> </photo> <photo> <photo_reference>Aap_uEB2cYxbKE7uIXQ_IhX3TvZHDcFHXjWSwezoiwP3eWlfIDTWwq3xtsYZY7QSrhR2d9s1eWmZlM5zr9iHlC_n0gsJXNeRcfd2JjuLFaNuC7VfpeIsdQchhOybG0drJ2CxzD187Az-Foip-6MutDA22LINPw0Iyc_yT04WbxQDxhiwu2Cn</photo_reference> <width>2048</width> <height>1515</height> <html_attribution><a href="https://maps.google.com/maps/contrib/112343109286948028063">Andrew W</a></html_attribution> </photo> <photo> <photo_reference>Aap_uEBJyLgeilgow1JnoKW83IBsl8CPkmryN8nGYtBzzLaiLjFicWxC1YPQusM-_Fvfb1bkbuShrzjXmHCOp5HoBgJsgit8o0HPYWgjSwrdySqde1BgfKbwS-TWbPg_dwTnVR8LrVPxa_vpLzNlx1b-WpDZo3-_KvxH2GARhVrcvWkvMYD0</photo_reference> <width>4032</width> <height>3024</height> <html_attribution><a href="https://maps.google.com/maps/contrib/100678816592586275978">Jeremy Hsiao</a></html_attribution> </photo> <photo> <photo_reference>Aap_uEADyMSxLevgbLWCJeHA8kIN3w6-JcndbuHvTB0oqR-IlWbml4bbYmR-_iYU15HBh8xi3w5hZ455pda6m-BlLCscr6g_Zc5FmBOHW56IsZF3Pxif5UmeGZSsg3WIjHCoL-JyndN0nkfyzS31E05tZi61RfXQ2UPY2_5ceKYua5U6d5Zd</photo_reference> <width>3024</width> <height>4032</height> <html_attribution><a href="https://maps.google.com/maps/contrib/100678816592586275978">Jeremy Hsiao</a></html_attribution> </photo> <adr_address><span class="street-address">48 Pirrama Rd</span>, <span class="locality">Pyrmont</span> <span class="region">NSW</span> <span class="postal-code">2009</span>, <span class="country-name">Australia</span></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
| Поле | Обязательно | Тип | Описание |
|---|---|---|---|
|
Обязательно | Array<string> |
Может содержать набор атрибуций для этого предложения, которые должны быть показаны пользователю (некоторые предложения могут не иметь атрибуций). |
|
Обязательно | Место |
Содержит подробную информацию о запрашиваемом месте. Подробнее о местах… |
|
Обязательно | PlacesDetailsStatus |
Содержит статус запроса и может содержать сведения для отладки, которые помогут вам выяснить, почему запрос не был выполнен. Подробнее PlacesDetailsStatus… |
|
необязательно | Array<string> |
Если сервис возвращает дополнительную информацию о спецификации запроса, в объекте ответа может быть дополнительное поле |
В ответе 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означает неизвестную ошибку.
Место
Атрибуты, описывающие место. Не все атрибуты доступны для всех типов мест.
| Поле | Обязательно | Тип | Описание |
|---|---|---|---|
|
необязательно |
Массив<AddressComponent>
|
Массив, содержащий отдельные компоненты адреса.
Подробнее: |
|
необязательно | string |
Представление адреса места в микроформате adr. |
|
необязательно | string |
Указывает, работает ли место, если оно является компанией.
Если информация отсутствует, свойство
The allowed values include:
OPERATIONAL,
CLOSED_TEMPORARILY, and CLOSED_PERMANENTLY
|
|
необязательно | Логическое значение |
Указывает, поддерживает ли компания получение заказа на улице. |
|
необязательно | PlaceOpeningHours |
Содержит часы работы на следующие семь дней (включая сегодняшний). Период времени начинается в полночь в день запроса и заканчивается в 23:59 шесть дней спустя. Это поле содержит подполе Подробнее PlaceOpeningHours… |
|
необязательно | Логическое значение |
Указывает, поддерживает ли компания доставку. |
|
необязательно | Логическое значение |
Указывает, есть ли в заведении места в помещении или на улице. |
|
необязательно | PlaceEditorialSummary |
Содержит краткое описание места. Сводка состоит из текстового обзора и, если применимо, кода языка. Текст краткого пересказа должен быть представлен без изменений. Подробнее PlaceEditorialSummary… |
|
необязательно | string |
Строка, содержащая человекочитаемый адрес этого места. Часто это почтовый адрес. В некоторых странах, таких как Великобритания, не разрешено распространение настоящих почтовых адресов в связи с ограничениями лицензирования. Отформатированный адрес состоит из одного или нескольких компонентов адреса. Например, адрес "111 8th Avenue, New York, NY" содержит отдельные компоненты "111" (номер дома), "8th Avenue" (улица), "New York" (город) и "NY" (штат США). Не анализируйте отформатированный адрес программно. Вместо этого используйте отдельные компоненты адреса, которые ответ API включает в дополнение к полю отформатированного адреса. |
|
необязательно | string |
Содержит номер телефона в местном формате. |
|
необязательно | Geometry |
Содержит местоположение и область просмотра для него. Подробнее: |
|
необязательно | string |
Содержит URL предложенного значка, который может быть показан пользователю при отображении этого результата на карте. |
|
необязательно | string |
Содержит шестнадцатеричный код цвета категории места (по умолчанию). |
|
необязательно | string |
Содержит URL рекомендуемого значка без расширения типа файла |
|
необязательно | string |
Содержит номер телефона в международном формате,
Международный формат включает код страны и имеет префикс в виде знака «плюс» (+). Например, международный номер телефона офиса Google в Сиднее (Австралия): |
|
необязательно | string |
Содержит человекочитаемое название возвращенного результата. Для результатов типа |
|
необязательно | PlaceOpeningHours |
Содержит обычные часы работы. Дополнительную информацию можно найти в описании PlaceOpeningHours. |
|
необязательно | Логическое значение |
Используйте |
|
необязательно | Массив<PlacePhoto> |
Массив объектов фотографий, каждый из которых содержит ссылку на изображение. В ответе на запрос может быть до 10 фотографий. Дополнительную информацию о фотографиях мест и о том, как использовать их в приложении, можно найти в документации по фотографиям мест. Подробнее о классе PlacePhoto… |
|
необязательно | string |
уникальный текстовый идентификатор места. Чтобы извлечь информацию о месте, передайте этот идентификатор в поле |
|
необязательно | PlusCode |
Закодированная ссылка на местоположение на основе координат широты и долготы, которая представляет область: 1/8000 градуса на 1/8000 градуса (приблизительно 14 x 14 метров на экваторе) или меньше. Коды Plus Code можно использовать в качестве замены почтовым адресам там, где эти адреса не существуют (здания не пронумерованы или улицам не присвоены названия). Подробнее об Open Location Code и кодах Plus Code… Подробнее: |
|
необязательно | число |
Уровень цен в заведении по шкале от 0 до 4. Точная сумма, соответствующая определенному значению, зависит от региона. Уровни цен интерпретируются следующим образом:
|
|
необязательно | число |
Оценка места в диапазоне от 1, 0 до 5, 0 на основе агрегированных отзывов пользователей. |
|
необязательно | string | |
|
необязательно | Логическое значение |
Указывает, можно ли забронировать места в заведении. |
|
необязательно | Массив<PlaceReview> |
Массив JSON, содержащий до пяти отзывов. По умолчанию отзывы сортируются по релевантности. Для управления сортировкой используйте параметр запроса
Google рекомендует указывать пользователям, как упорядочены результаты: по Подробнее PlaceReview… |
|
необязательно | string | |
|
необязательно | Массив<PlaceOpeningHours> |
Содержит массив записей для следующих семи дней, включая информацию о дополнительных часах работы компании. Дополнительные часы работы отличаются от основных. Например, ресторан может указать часы работы окна выдачи заказов или доставки в качестве дополнительных. Это поле заполняет подполе Подробнее PlaceOpeningHours… |
|
необязательно | Логическое значение |
Указывает, подают ли в заведении пиво. |
|
необязательно | Логическое значение |
Указывает, подают ли в заведении завтрак. |
|
необязательно | Логическое значение |
Указывает, подают ли в заведении поздний завтрак. |
|
необязательно | Логическое значение |
Указывает, можно ли поужинать в этом месте. |
|
необязательно | Логическое значение |
Указывает, подают ли в заведении обед. |
|
необязательно | Логическое значение |
Указывает, подают ли в заведении вегетарианские блюда. |
|
необязательно | Логическое значение |
Указывает, подают ли в заведении вино. |
|
необязательно | Логическое значение |
Указывает, можно ли заказать еду на вынос. |
|
необязательно | Array<string> |
Содержит массив типов объектов, описывающих данный результат. Ознакомьтесь с поддерживаемыми типами. |
|
необязательно | string |
URL официальной страницы этого места в Google. Это страница Google, содержащая всю имеющуюся информацию об этом месте. Приложения должны показывать пользователю встроенную страницу места или ссылку на нее на любом экране с подробным описанием этого места. |
|
необязательно | число |
Общее количество отзывов о месте (с текстом или без него). |
|
необязательно | число |
Содержит количество минут, на которое текущий часовой пояс этого места отличается от UTC. Например, для Сиднея (Австралия) в период летнего времени это значение будет равно 660 (+11 часов от UTC), а для Калифорнии в период зимнего времени – -480 (-8 часов от UTC). |
|
необязательно | string |
Для результатов, относящихся к заведениям (
Для всех остальных результатов поле Этот текст должен отображаться "как есть", без дополнительной программной обработки. |
|
необязательно | string |
Официальный сайт, связанный с этим местом, например адрес домашней страницы компании. |
|
необязательно | Логическое значение |
Указывает, есть ли в месте вход, доступный для инвалидов-колясочников. |
PlaceEditorialSummary
Содержит краткое описание места. Сводка состоит из текстового описания и, если применимо, кода языка. Текст краткого пересказа должен быть представлен без изменений.
| Поле | Обязательно | Тип | Описание |
|---|---|---|---|
|
необязательно | string |
Язык предыдущих полей. Может отсутствовать. |
|
необязательно | string |
Краткое текстовое описание места. |
PlaceOpeningHours
Объект, описывающий часы работы места.
| Поле | Обязательно | Тип | Описание |
|---|---|---|---|
|
необязательно | Логическое значение |
Логическое значение, указывающее, работает или нет в текущий момент это место. |
|
необязательно | Массив<PlaceOpeningHoursPeriod> |
Массив часов работы, содержащий данные по семи дням недели, начиная с воскресенья, в хронологическом порядке. Дополнительную информацию можно найти в описании PlaceOpeningHoursPeriod. |
|
необязательно | Array<PlaceSpecialDay> |
Массив, содержащий до семи записей, соответствующих следующим семи дням. Подробнее о том, PlaceSpecialDay… |
|
необязательно | string |
Строка типа, используемая для определения типа дополнительных часов (например, |
|
необязательно | Array<string> |
Массив строк, описывающих часы работы места в человекочитаемом формате. |
PlaceOpeningHoursPeriod
| Поле | Обязательно | Тип | Описание |
|---|---|---|---|
|
Обязательно | PlaceOpeningHoursPeriodDetail |
Содержит пару объектов дня недели и времени, описывающих время начала работы места. Подробнее о PlaceOpeningHoursPeriodDetail… |
|
необязательно | PlaceOpeningHoursPeriodDetail |
Может содержать пару объектов дня недели и времени, описывающих время окончания работы места. Если место работает круглосуточно, в ответе не будет раздела "Закрытие". Можно уверенно считать, что место работает круглосуточно, если период содержит параметр day со значением Подробнее о PlaceOpeningHoursPeriodDetail… |
PlaceSpecialDay
| Поле | Обязательно | Тип | Описание |
|---|---|---|---|
|
необязательно | string |
Дата в формате RFC3339 в местном часовом поясе, например 2010-12-31. |
|
необязательно | Логическое значение |
Значение True, если для этого дня задан измененный график работы. Если значение параметра |
PlaceOpeningHoursPeriodDetail
| Поле | Обязательно | Тип | Описание |
|---|---|---|---|
|
Обязательно | число |
Номер дня недели в диапазоне от 0 до 6, начиная с воскресенья. Например, 2 обозначает вторник. |
|
Обязательно | string |
Может содержать время в 24-часовом формате "ччмм". Значения находятся в диапазоне 0000–2359. Время указывается в часовом поясе этого места. |
|
необязательно | string |
Дата в формате RFC3339 в местном часовом поясе, например 2010-12-31. |
|
необязательно | Логическое значение |
Значение True, если заданный период был усечен из-за семидневного ограничения, когда период начинается до полуночи в день запроса и/или заканчивается в полночь или позже в последний день. Это свойство указывает, что период открытия или закрытия может быть больше семи дней. |
PlacePhoto
Фотография места. Фотографию можно получить с помощью Place Photo API, используя URL следующего формата:
https://maps.googleapis.com/maps/api/place/photo?maxwidth=400&photo_reference=photo_reference&key=YOUR_API_KEY
Подробнее о фотографиях мест…
| Поле | Обязательно | Тип | Описание |
|---|---|---|---|
|
Обязательно | число |
Высота фотографии. |
|
Обязательно | Array<string> |
HTML-атрибуты для фотографии. |
|
Обязательно | string |
Строка, используемая для идентификации фотографии при выполнении запроса на получение фотографии. |
|
Обязательно | число |
Ширина фотографии. |
PlaceReview
Отзыв пользователя о месте.
| Поле | Обязательно | Тип | Описание |
|---|---|---|---|
|
Обязательно | string |
Имя пользователя, отправившего отзыв. К анонимным отзывам добавляется подпись "A Google user". |
|
Обязательно | число |
Общая оценка пользователя для данного места. Она представляет собой целое число от 1 до 5. |
|
Обязательно | string |
Время отправки отзыва в текстовом формате относительно текущего времени. |
|
Обязательно | число |
Время отправки отзыва в секундах с 00:00 1 января 1970 г. по UTC. |
|
необязательно | string |
URL профиля местного эксперта Google Карт (если указан). |
|
необязательно | string |
Код языка IETF, указывающий язык возвращенного отзыва.Это поле содержит только основной тег языка и не содержит дополнительный тег страны или региона. Например, все отзывы на английском языке имеют тег "en", но не "en-AU", "en-UK" и т. д. Это поле остается пустым, если пользователь поставил оценку, но не оставил отзыв. |
|
необязательно | string |
Код языка IETF, указывающий исходный язык отзыва. Если отзыв переведен, то |
|
необязательно | string |
URL фотографии профиля пользователя (если доступен). |
|
необязательно | string |
Отзыв пользователя. В сервисе Google Places поле текста отзыва не является обязательным. Поэтому это поле может быть пустым. Обратите внимание, что это поле может содержать базовую разметку HTML. Например, ссылка на объект |
|
необязательно | Логическое значение |
Булево значение, указывающее, был ли отзыв переведен с языка оригинала.Если отзыв был переведен (значение true), Google рекомендует сообщить об этом пользователям. Например, вы можете добавить в отзыв строку "Переведено Google". |