Получив идентификатор места ( place_id из результатов поиска, вы можете запросить более подробную информацию о конкретном заведении или достопримечательности, инициировав запрос «Подробная информация о месте (устаревшая версия)». Запрос «Подробная информация о месте (устаревшая версия)» возвращает более полную информацию об указанном месте, такую как полный адрес, номер телефона, рейтинг пользователей и отзывы.
Запросы на подробную информацию о месте (устаревшие данные)
Запрос "Подробная информация о месте" (устаревшая версия) представляет собой HTTP-URL следующего вида:
https://maps.googleapis.com/maps/api/place/details/output?parameters
где output может быть одно из следующих значений:
-
json(рекомендуется) указывает на вывод в формате JSON (JavaScript Object Notation). -
xmlозначает вывод в формате XML
Для инициирования поискового запроса необходимы определенные параметры. Как это принято в URL-адресах, все параметры разделяются символом амперсанда ( & ). Ниже приведен список параметров и их возможных значений.
Необходимые параметры
place_id
Текстовый идентификатор, однозначно определяющий место, возвращаемый в результате поиска мест . Для получения дополнительной информации об идентификаторах мест см. обзор идентификаторов мест .
Дополнительные параметры
поля
Внимание: запросы на поиск мест и запросы на получение подробной информации о местах не возвращают одни и те же поля. Запросы на поиск мест возвращают подмножество полей, которые возвращаются запросами на получение подробной информации о местах. Если нужное вам поле не возвращается запросом на поиск мест, вы можете использовать поиск мест, чтобы получитьplace_id, а затем использовать этот Place_id для выполнения запроса на получение подробной информации о местах. Для получения дополнительной информации о полях, недоступных в запросе на поиск мест, см. раздел «Поддержка полей API мест» .Используйте параметр fields для указания списка типов данных о местах, разделенных запятыми, которые необходимо вернуть. Например:
fields=formatted_address,name,geometry. Используйте косую черту при указании составных значений. Например:opening_hours/open_now.Поля разделены на три категории оплаты: «Основные» , «Контакты» и «Атмосфера» . За услуги категорий «Основные», «Контакты» и «Атмосфера» взимается дополнительная плата к базовой услуге (подробная информация о местах, поиск места, поиск поблизости или текстовый поиск) за запрос, который их инициировал. Для получения дополнительной информации см. прайс-лист .
Базовый
Категория «Основные» включает следующие поля:
address_components,adr_address,business_status,formatted_address,geometry,icon,icon_mask_base_uri,icon_background_color,name,permanently_closed( устарело ),photo,place_id,plus_code,type,url,utc_offset,vicinity,wheelchair_accessible_entrance.Контакт
Категория «Контакты» включает следующие поля:
current_opening_hours,formatted_phone_number,international_phone_number,opening_hours,secondary_opening_hours,websiteАтмосфера
Категория «Атмосфера» включает следующие поля:
curbside_pickup,delivery,dine_in,editorial_summary,price_level,rating,reservable,reviews,serves_beer,serves_breakfast,serves_brunch,serves_dinner,serves_lunch,serves_vegetarian_food,serves_wine,takeout,user_ratings_total.Примечание: Атрибуцииhtml_attributions) всегда возвращаются при каждом вызове, независимо от того, запрашивалось ли это поле ранее.язык
Язык, на котором будут возвращаться результаты.
- См. список поддерживаемых языков . Google часто обновляет список поддерживаемых языков, поэтому этот список может быть неполным.
- Если
languageне указан, API пытается использовать предпочтительный язык, указанный в заголовкеAccept-Language. - API делает все возможное, чтобы предоставить уличный адрес, понятный как пользователю, так и местным жителям. Для достижения этой цели он возвращает уличные адреса на местном языке, при необходимости транслитерированные в письменность, понятную пользователю, с учетом предпочтительного языка. Все остальные адреса возвращаются на предпочтительном языке. Все компоненты адреса возвращаются на одном языке, который выбирается из первого компонента.
- Если имя недоступно на предпочитаемом языке, API использует наиболее близкое совпадение.
- Предпочитаемый язык оказывает небольшое влияние на набор результатов, которые API выбирает для возврата, и на порядок их возврата. Геокодер по-разному интерпретирует сокращения в зависимости от языка, например, сокращения для типов улиц или синонимы, которые могут быть допустимы в одном языке, но не в другом. Например, utca и tér являются синонимами слова «улица» на венгерском языке.
область
Код региона указывается в виде двухсимвольного значения 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 рекомендует показывать конечному пользователю, как именно сортируются отзывы.
- Для
сессионный токен
Случайная строка, идентифицирующая сессию автозаполнения для целей выставления счетов.
Сессия начинается, когда пользователь начинает вводить запрос, и завершается, когда он выбирает место и выполняется вызов функции «Подробная информация о месте». Каждая сессия может содержать несколько запросов, за которыми следует один выбор места. 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-ключ.
Ответ на запрос "Подробная информация о месте (устаревшее)".
Ответы функции Place Details (Legacy) возвращаются в формате, указанном флагом 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
| Поле | Необходимый | Тип | Описание |
|---|---|---|---|
| необходимый | Массив<строка> | Может содержать набор сведений об этом объявлении, которые должны быть показаны пользователю (некоторые объявления могут не содержать сведений). |
| необходимый | Место | Содержит подробную информацию о запрашиваемом месте. Более подробную информацию см. в разделе «Место» . |
| необходимый | МестаПодробностиСтатус | Содержит информацию о статусе запроса и может включать отладочные данные, которые помогут вам выяснить причину сбоя запроса. Дополнительную информацию см. в разделе PlacesDetailsStatus . |
| необязательный | Массив<строка> | Когда сервис возвращает дополнительную информацию о спецификации запроса, в объекте ответа может появиться дополнительное поле |
В JSON-ответе они представлены как корневые элементы. В XML-ответе они отображаются как элементы верхнего уровня под <PlaceDetailsResponse> .
МестаПодробностиСтатус
Коды состояния, возвращаемые службой.
-
OKозначает, что запрос к API был успешно выполнен. -
ZERO_RESULTSуказывает на то, что указанное местоположениеplace_idбыло действительным, но больше не соответствует допустимому результату. Это может произойти, если заведение прекратило свою деятельность. -
NOT_FOUNDуказывает на то, что указанное местоположение,place_id, не найдено в базе данных Places. -
INVALID_REQUESTуказывает на то, что запрос к API был неправильно сформирован. -
OVER_QUERY_LIMITуказывает на любой из следующих параметров:- Вы превысили лимиты QPS.
- В вашем аккаунте не включена функция выставления счетов.
- Ежемесячный лимит в 200 долларов, или самостоятельно установленный лимит использования, превышен.
- Предоставленный способ оплаты больше недействителен (например, срок действия кредитной карты истек).
-
REQUEST_DENIEDуказывает на то, что ваш запрос был отклонен, как правило, по следующей причине:- В запросе отсутствует ключ API.
-
keyпараметр недействителен.
-
UNKNOWN_ERRORуказывает на неизвестную ошибку.
Место
Атрибуты, описывающие место. Не все атрибуты будут доступны для всех типов мест.
| Поле | Необходимый | Тип | Описание |
|---|---|---|---|
| необязательный | Массив< AddressComponent > | Массив, содержащий отдельные компоненты, относящиеся к данному адресу. Дополнительную информацию см. в разделе |
| необязательный | нить | Представление адреса места в микроформате ADR . |
| необязательный | нить | Указывает на оперативный статус места, если это коммерческое предприятие. Если данные отсутствуют,
The allowed values include: OPERATIONAL ,
CLOSED_TEMPORARILY , and CLOSED_PERMANENTLY
|
| необязательный | логический | Указывает, поддерживает ли предприятие самовывоз заказов. |
| необязательный | Часы работы заведения | Содержит часы работы на следующие семь дней (включая сегодняшний день). Период времени начинается в полночь в день запроса и заканчивается в 23:59 через шесть дней. Это поле включает в себя подполе Дополнительную информацию см. в разделе PlaceOpeningHours . |
| необязательный | логический | Указывает, поддерживает ли компания доставку. |
| необязательный | логический | Указывает, предоставляет ли заведение возможность размещения посетителей в помещении или на открытом воздухе. |
| необязательный | МестоРедакционноеКраткое содержание | Содержит краткое описание места. Краткое описание представляет собой текстовый обзор, а также включает коды языков, если применимо. Текст краткого описания должен быть представлен в неизмененном виде и не может быть изменен или отредактирован. Дополнительную информацию см. в разделе PlaceEditorialSummary . |
| необязательный | нить | Строка, содержащая удобочитаемый адрес этого места. Часто этот адрес совпадает с почтовым адресом. Следует отметить, что в некоторых странах, например, в Великобритании, распространение настоящих почтовых адресов запрещено из-за ограничений, связанных с лицензированием. Отформатированный адрес логически состоит из одного или нескольких компонентов. Например, адрес «111 8th Avenue, New York, NY» состоит из следующих компонентов: «111» (номер дома), «8th Avenue» (маршрут), «New York» (город) и «NY» (штат США). Не следует программно обрабатывать отформатированный адрес. Вместо этого следует использовать отдельные компоненты адреса, которые, помимо поля отформатированного адреса, содержатся в ответе API. |
| необязательный | нить | Содержит номер телефона населенного пункта в местном формате . |
| необязательный | Geometry | Содержит информацию о местоположении и области просмотра для данного местоположения. Дополнительную информацию см. в |
| необязательный | нить | Содержит URL-адрес предлагаемой иконки, которая может быть отображена пользователю при указании этого результата на карте. |
| необязательный | нить | Содержит стандартный шестнадцатеричный цветовой код для категории места. |
| необязательный | нить | Содержит URL-адрес рекомендуемой иконки, за исключением расширения файла |
| необязательный | нить | Содержит номер телефона места в международном формате. Международный формат включает код страны и предваряется знаком плюс (+). Например, международный номер телефона офиса Google в Сиднее, Австралия, — |
| необязательный | нить | Содержит удобочитаемое название возвращаемого результата. Для результатов, |
| необязательный | Часы работы заведения | Содержит информацию о стандартном графике работы. Дополнительную информацию см. в разделе PlaceOpeningHours . |
| необязательный | логический | Используйте |
| необязательный | Массив< PlacePhoto > | Массив фотообъектов, каждый из которых содержит ссылку на изображение. Запрос может вернуть до десяти фотографий. Более подробную информацию о фотографиях мест и о том, как использовать изображения в вашем приложении, можно найти в документации по фотографиям мест . Дополнительную информацию см. на сайте PlacePhoto . |
| необязательный | нить | Текстовый идентификатор, однозначно определяющий местоположение. Для получения информации о месте передайте этот идентификатор в поле |
| необязательный | PlusCode | Закодированная координатная сетка местоположения, полученная из координат широты и долготы, представляет собой область размером 1/8000 градуса на 1/8000 градуса (примерно 14 м x 14 м на экваторе) или меньше. Плюс-коды могут использоваться в качестве замены адресов улиц в местах, где они отсутствуют (где здания не нумеруются или улицы не имеют названий). См. Открытый код местоположения и плюс-коды . Для получения более подробной информации см. |
| необязательный | число | Уровень цен в данном месте по шкале от 0 до 4. Точное значение, указанное в каждом конкретном случае, может варьироваться в зависимости от региона. Уровни цен интерпретируются следующим образом:
|
| необязательный | число | Содержит рейтинг места от 1,0 до 5,0, основанный на обобщенных отзывах пользователей. |
| необязательный | нить | |
| необязательный | логический | Указывает, поддерживает ли заведение бронирование. |
| необязательный | Массив< PlaceReview > | JSON-массив, содержащий до пяти отзывов. По умолчанию отзывы сортируются по релевантности. Используйте параметр запроса
Google рекомендует указывать пользователям, отсортированы ли результаты по Дополнительную информацию можно найти на сайте PlaceReview . |
| необязательный | нить | |
| необязательный | Массив< PlaceOpeningHours > | Содержит массив записей на следующие семь дней, включая информацию о дополнительных часах работы предприятия. Дополнительные часы работы отличаются от основных часов работы предприятия. Например, ресторан может указать часы работы автокассы или часы доставки в качестве дополнительных часов работы. Это поле заполняет подполе Дополнительную информацию см. в разделе PlaceOpeningHours . |
| необязательный | логический | Указывает, подают ли в заведении пиво. |
| необязательный | логический | Указывает, подают ли в заведении завтрак. |
| необязательный | логический | Указывает, подают ли в заведении бранч. |
| необязательный | логический | Указывает, подают ли в заведении ужин. |
| необязательный | логический | Указывает, подают ли в заведении обед. |
| необязательный | логический | Указывает, подают ли в заведении вегетарианские блюда. |
| необязательный | логический | Указывает, подают ли в заведении вино. |
| необязательный | логический | Указывает, поддерживает ли заведение доставку еды на вынос. |
| необязательный | Массив<строка> | Содержит массив типов признаков, описывающих заданный результат. См. список поддерживаемых типов . |
| необязательный | нить | Содержит URL-адрес официальной страницы Google для этого места. Это будет страница, принадлежащая Google, содержащая наиболее полную доступную информацию о месте. Приложения должны ссылаться на эту страницу или встраивать её на любой экран, отображающий пользователю подробные результаты поиска по этому месту. |
| необязательный | число | Общее количество отзывов об этом месте, с текстом и без текста. |
| необязательный | число | Указывается смещение текущего часового пояса данного места относительно UTC на несколько минут. Например, для Сиднея, Австралия, во время действия летнего времени это будет 660 (+11 часов от UTC), а для Калифорнии вне летнего времени — -480 (-8 часов от UTC). |
| необязательный | нить | В результатах поиска по типу заведения ( Для всех остальных результатов поле « Данный контент предназначен для прочтения в неизмененном виде. Не следует программно обрабатывать отформатированный адрес. |
| необязательный | нить | Авторитетный веб-сайт этого места, например, главная страница компании. |
| необязательный | логический | Указывает, есть ли в данном месте вход, приспособленный для людей в инвалидных колясках. |
МестоРедакционноеКраткое содержание
Содержит краткое описание места. Краткое описание представляет собой текстовый обзор, а также включает коды языков, если применимо. Текст краткого описания должен быть представлен в неизмененном виде и не может быть изменен или отредактирован.
| Поле | Необходимый | Тип | Описание |
|---|---|---|---|
| необязательный | нить | Язык предыдущих полей. Может отсутствовать. |
| необязательный | нить | Краткое текстовое описание места средней длины. |
Часы работы заведения
Объект, описывающий часы работы какого-либо места.
| Поле | Необходимый | Тип | Описание |
|---|---|---|---|
| необязательный | логический | Логическое значение, указывающее, открыто ли заведение в данный момент времени. |
| необязательный | Array< PlaceOpeningHoursPeriod > | Представлен список периодов работы заведений, охватывающий семь дней, начиная с воскресенья, в хронологическом порядке. Дополнительную информацию см. в разделе PlaceOpeningHoursPeriod . |
| необязательный | Массив< PlaceSpecialDay > | Массив, содержащий до семи записей, соответствующих следующим семи дням. Дополнительную информацию можно найти на сайте PlaceSpecialDay . |
| необязательный | нить | Строка типа, используемая для идентификации типа дополнительных часов работы (например, |
| необязательный | Массив<строка> | Массив строк, описывающих в удобочитаемом текстовом виде часы работы данного места. |
Время работы заведения
| Поле | Необходимый | Тип | Описание |
|---|---|---|---|
| необходимый | Информация о месте, часах работы, периоде работы. | Содержит пару объектов, отображающих день и время, указывающих, когда заведение открывается. Дополнительную информацию см. в разделе PlaceOpeningHoursPeriodDetail . |
| необязательный | Информация о месте, часах работы, периоде работы. | Может содержать пару объектов дня и времени, описывающих время закрытия заведения. Если заведение всегда открыто, раздел закрытия будет отсутствовать в ответе. Клиенты могут рассчитывать на то, что всегда открытое заведение будет представлено как период работы, содержащий день со значением Дополнительную информацию см. в разделе PlaceOpeningHoursPeriodDetail . |
PlaceSpecialDay
| Поле | Необходимый | Тип | Описание |
|---|---|---|---|
| необязательный | нить | Дата, выраженная в формате RFC3339 в местном часовом поясе данного места, например, 2010-12-31. |
| необязательный | логический | Значение true, если в этот день есть исключительные часы. Если |
Информация о месте, часах работы, периоде работы.
| Поле | Необходимый | Тип | Описание |
|---|---|---|---|
| необходимый | число | Число от 0 до 6, соответствующее дням недели, начиная с воскресенья. Например, 2 означает вторник. |
| необходимый | нить | Может содержать время суток в 24-часовом формате hhmm. Значения находятся в диапазоне 0000–2359. Время будет указано в часовом поясе данного места. |
| необязательный | нить | Дата, выраженная в формате RFC3339 в местном часовом поясе данного места, например, 2010-12-31. |
| необязательный | логический | Значение true, если заданный период был усечен из-за семидневного ограничения, то есть период начинается до полуночи в день запроса и/или заканчивается в полночь или после полуночи в последний день. Это свойство указывает на то, что период открытия или закрытия может выходить за рамки этого семидневного ограничения. |
PlacePhoto
Фотография места. Доступ к фотографии можно получить с помощью API фотографий мест, используя URL-адрес в следующем формате:
https://maps.googleapis.com/maps/api/place/photo?maxwidth=400&photo_reference=photo_reference&key=YOUR_API_KEY
Более подробную информацию смотрите в разделе «Фотографии места» .
| Поле | Необходимый | Тип | Описание |
|---|---|---|---|
| необходимый | число | Высота фотографии. |
| необходимый | Массив<строка> | HTML-код для фотографии. |
| необходимый | нить | Строка, используемая для идентификации фотографии при выполнении запроса на получение фотографии. |
| необходимый | число | Ширина фотографии. |
PlaceReview
Отзыв о месте, оставленный пользователем.
| Поле | Необходимый | Тип | Описание |
|---|---|---|---|
| необходимый | нить | Имя пользователя, оставившего отзыв. Анонимные отзывы приписываются «пользователю Google». |
| необходимый | число | Общая оценка этого места пользователем. Это целое число от 1 до 5. |
| необходимый | нить | Время, когда рецензия была отправлена в текстовом виде, относительно текущего времени. |
| необходимый | число | Время отправки отзыва, измеренное в секундах с полуночи 1 января 1970 года по всемирному координированному времени (UTC). |
| необязательный | нить | URL-адрес профиля пользователя в Google Maps Local Guides, если таковой имеется. |
| необязательный | нить | Код языка IETF, указывающий язык возвращенного отзыва. Это поле содержит только основной языковой тег, а не вторичный тег, указывающий страну или регион. Например, все отзывы на английском языке помечаются тегом 'en', а не 'en-AU', 'en-UK' и так далее. Это поле пустое, если есть только оценка без текста отзыва. |
| необязательный | нить | Код языка IETF, указывающий на исходный язык отзыва. Если отзыв был переведен, то |
| необязательный | нить | URL-адрес фотографии профиля пользователя, если таковая имеется. |
| необязательный | нить | Отзыв пользователя. При написании отзыва о местоположении в Google Places текстовые отзывы считаются необязательными. Поэтому это поле может быть пустым. Обратите внимание, что это поле может содержать базовую HTML-разметку. Например, ссылка на объект |
| необязательный | логический | Логическое значение, указывающее, был ли отзыв переведен с исходного языка, на котором он был написан. Если отзыв был переведен (значение true), Google рекомендует сообщить об этом пользователям. Например, вы можете добавить к отзыву следующую строку: "Переведено Google". |