場所検索で place_id を取得したら、Place Details(以前のバージョン)リクエストを開始して、特定の店やスポットに関する詳細をリクエストできます。Place Details(以前のバージョン)リクエストは、指定の場所に関する包括的な情報(完全な住所、電話番号、ユーザーのレビューや評価など)を返します。
Place Details(従来版)リクエスト
プレイスの詳細(以前のバージョン)リクエストは、次の形式の HTTP URL です。
https://maps.googleapis.com/maps/api/place/details/output?parameters
ここで、output には次のいずれかの値を指定できます。
json(推奨)は、JavaScript Object Notation(JSON)で出力することを示します。xmlは、出力を XML として示す
検索リクエストを開始するには、特定のパラメータが必要です。URL の標準規則と同様に、すべてのパラメータはアンパサンド(&)文字を使用して区切ります。以下に、パラメータとその有効な値のリストを示します。
必須パラメータ
-
place_id
プレイス検索から返される、場所を一意に識別するテキスト表記の ID。プレイス ID について詳しくは、プレイス ID の概要をご覧ください。
オプション パラメータ
-
fields
注意: Place Search リクエストと Place Details リクエストで、同じフィールドが返されることはありません。Place Search リクエストでは、Place Details リクエストで返されるフィールドのサブセットが返されます。目的のフィールドが Place Search で返されない場合は、Place Search を使用してplace_idを取得してから、そのプレイス ID を使用して Place Details リクエストを実行します。Place Search リクエストで使用できないフィールドの詳細については、Places API のフィールドのサポートをご覧ください。fields パラメータを使用して、返す場所データのタイプのカンマ区切りのリストを指定します。例:
fields=formatted_address,name,geometry。複合的な値を指定する場合はスラッシュを使用します。例:opening_hours/open_now。フィールドは、基本、連絡先、雰囲気の 3 つの請求カテゴリに分けられます。Basic、Contact、Atmosphere の各 SKU は、それらをトリガーしたリクエストの基本 SKU(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、websiteAtmosphere
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
結果を返す言語。
- サポートされている言語の一覧をご覧ください。サポート対象の言語は頻繁に更新されるため、このリストで網羅されていない場合があります。
-
languageが指定されていない場合、API はAccept-Languageヘッダーで指定された優先言語を使用しようとします。 - API は、ユーザーと地元住民の両方が読める番地を可能な限り提供します。この目標を達成するため、優先言語を考慮し、必要に応じてユーザーが読める文字に音訳して、現地の言語で住所を返します。その他の住所はすべて、優先言語で返されます。住所コンポーネントはすべて同じ言語で返されます。この言語は最初のコンポーネントから選択されます。
- 優先言語で名前が使用できない場合、API は最も近い一致を使用します。
- 優先言語は、API が返す結果のセットと、それらが返される順序にわずかな影響を与えます。ジオコーダーは、言語によって略語(通りの種類の略語など)の解釈が異なります。また、ある言語では有効でも別の言語では有効でない同義語もあります。たとえば、ハンガリー語では utca と tér は通りの同義語です。
-
地域
地域コード。ccTLD(「トップレベル ドメイン」)の 2 文字の値として指定します。ほとんどの 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
課金目的で予測入力セッションを識別するランダムな文字列。
セッションは、ユーザーが検索語句を入力し始めたときに開始され、ユーザーが場所を選択し、Place Details が呼び出されると終了します。セッションによっては、複数の検索語句が入力された後に、1 つの場所が選択される場合もあります。セッション内の各リクエストで使用される API キーは、同じ Google Cloud Console プロジェクトに属している必要があります。セッションが終了すると、トークンは無効になります。アプリでは、セッションごとに新しいトークンを生成する必要があります。
sessiontokenパラメータを省略する場合や、セッション トークンを再利用する場合は、セッション トークンが指定されていない場合と同様にセッションが課金されます(各リクエストが個別に課金されます)。次のガイドラインに従うことをおすすめします。
- すべての予測入力セッションでセッション トークンを使用します。
- セッションごとに新しいトークンを生成します。バージョン 4 の UUID を使用することをおすすめします。
- セッション内のすべての Place Autocomplete リクエストと Place Details リクエストで使用される API キーが、同じ Cloud Console プロジェクトに属していることを確認します。
- 新しいセッションごとに固有のセッション トークンを渡すようにしてください。複数のセッションで同じトークンを使用すると、リクエストごとに課金されます。
Place Details(従来版)の例
次の例では、place_id で場所の詳細をリクエストし、name、rating、formatted_phone_number の各フィールドを含めています。
Shell
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(以前の機能)レスポンス
Place Details(レガシー)レスポンスは、リクエストの URL パス内の output フラグで示された形式で返されます。
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
| フィールド | 必須 | タイプ | 説明 |
|---|---|---|---|
|
required | Array<string> |
このリスティングに関する一連の帰属情報が含まれる場合があります。この情報はユーザーに表示する必要があります(一部のリスティングには帰属情報がない場合があります)。 |
|
required | Place |
リクエストされた場所に関する詳細情報が含まれます。 詳しくは、Place をご覧ください。 |
|
required | PlacesDetailsStatus |
リクエストのステータスが格納されます。リクエストが失敗した原因を追跡できるようにデバッグ情報が格納される場合もあります。 詳細については、PlacesDetailsStatus をご覧ください。 |
|
省略可 | Array<string> |
サービスがリクエスト仕様に関する追加情報を返す場合、レスポンス オブジェクト内に |
JSON レスポンスでは、これらはルート要素として表されます。XML レスポンスでは、これらは <PlaceDetailsResponse> の下のトップレベル要素として表示されます。
PlacesDetailsStatus
サービスから返されるステータス コード。
OKは、API リクエストが成功したことを示します。-
ZERO_RESULTS。参照された位置情報place_idは有効だったが、有効な結果を参照しなくなったことを示します。これは、施設が営業を終了した場合に発生することがあります。 -
NOT_FOUND: 参照された場所place_idがプレイス データベースで見つからなかったことを示します。 -
INVALID_REQUESTは、API リクエストの形式が正しくないことを示します。 -
OVER_QUERY_LIMITは、次のいずれかを示します。- QPS の上限を超えています。
- アカウントで課金が有効になっていません。
- 1 か月 $200 のクレジットまたはご自身で設定した使用量の上限を超えている。
- 設定したお支払い方法が無効になっている(クレジット カードの期限切れなど)。
-
REQUEST_DENIEDは、リクエストが拒否されたことを示します。通常、次の理由が考えられます。- リクエストに API キーがありません。
keyパラメータが無効です。
UNKNOWN_ERRORは、不明なエラーが発生したことを示します。
場所
場所を説明する属性。すべての属性がすべてのプレイス タイプで利用できるわけではありません。
| フィールド | 必須 | タイプ | 説明 |
|---|---|---|---|
|
省略可 |
Array<AddressComponent>
|
この住所に適用される個々のコンポーネントを含む配列。
詳しくは、 |
|
省略可 | 文字列 |
adr マイクロフォーマットでのプレイスの住所の表現。 |
|
省略可 | 文字列 |
その場所の営業状況を示します(場所がお店やサービスの場合)。データが存在しない場合、
The allowed values include:
OPERATIONAL,
CLOSED_TEMPORARILY, and CLOSED_PERMANENTLY
|
|
省略可 | ブール値 |
ビジネスがカーブサイド ピックアップをサポートしているかどうかを指定します。 |
|
省略可 | PlaceOpeningHours |
今後 7 日間(今日を含む)の営業時間が含まれます。期間は、リクエスト日の午前 0 時から 6 日後の午後 11 時 59 分までです。このフィールドには、例外的な時間がある日付に設定されたすべての時間の 詳しくは、PlaceOpeningHours をご覧ください。 |
|
省略可 | ブール値 |
ビジネスが配達をサポートしているかどうかを指定します。 |
|
省略可 | ブール値 |
ビジネスが屋内席または屋外席のオプションをサポートしているかどうかを指定します。 |
|
省略可 | PlaceEditorialSummary |
場所の概要が含まれています。概要はテキストによる概要で構成され、該当する場合は言語コードも含まれます。要約テキストは現状のまま提示する必要があり、変更や改変はできません。 詳しくは、PlaceEditorialSummary をご覧ください。 |
|
省略可 | 文字列 |
対人可読形式のこの場所の住所を含む文字列。 ほとんどの場合、この住所は「郵便の宛先」と同一です。イギリスなど一部の国では、ライセンス上の制限があるため実際の郵便の宛先は配信できません。 フォーマット済み住所は、論理的には 1 つ以上の住所コンポーネントで構成されます。たとえば、「111 8th Avenue, New York, NY」という住所は、「111」(番地)、「8th Avenue」(ルート)、「New York」(都市名)、「NY」(アメリカの州名)で構成されています。 フォーマット済み住所は、プログラムで解析しないでください。その代わりに、フォーマット済み住所のフィールドに加えて、API レスポンスに含まれる個々の住所コンポーネントを使用してください。 |
|
省略可 | 文字列 |
場所のローカル形式の電話番号が含まれます。 |
|
省略可 | Geometry |
場所の場所とビューポートが含まれます。 詳しくは、 |
|
省略可 | 文字列 |
地図上でこの結果を示すときにユーザーに表示される可能性がある、提案されたアイコンの URL が含まれます。 |
|
省略可 | 文字列 |
場所のカテゴリのデフォルトの 16 進数色コードが含まれます。 |
|
省略可 | 文字列 |
推奨アイコンの URL から |
|
省略可 | 文字列 |
場所の国際電話形式の電話番号が含まれます。国際電話形式には、国コードが含まれており、「+」記号が先頭に付きます。たとえば、オーストラリアにある Google のシドニー オフィスの international_phone_number は |
|
省略可 | 文字列 |
返された結果の人が読める形式の名前が含まれます。 |
|
省略可 | PlaceOpeningHours |
通常の営業時間が含まれます。 詳しくは、PlaceOpeningHours をご覧ください。 |
|
省略可 | ブール値 |
|
|
省略可 | Array<PlacePhoto> |
写真オブジェクトの配列。各オブジェクトには画像への参照が含まれています。リクエストは最大 10 枚の写真を返すことがあります。場所の写真と、アプリで画像を使用する方法について詳しくは、Place Photosのドキュメントをご覧ください。 詳しくは、PlacePhoto をご覧ください。 |
|
省略可 | 文字列 |
場所を一意に識別するテキスト表記の ID。場所に関する情報を取得するには、この ID を Places API リクエストの |
|
省略可 | PlusCode |
エンコードされた場所の参照情報です。緯度 / 経度の座標から取得され、8000 分の 1 x 8000 分の 1(14 メートル x 14 メートル)以下の領域を表します。Plus Codes は、番地がない場所(建物に番号が付いていない場所や、通りに名前がない場所)で、番地の代わりに使用できます。Open Location Code とプラスコードをご覧ください。 詳しくは、 |
|
省略可 | 数値 |
場所の価格帯(0 ~ 4)。特定の値で示される正確な金額は、地域によって異なります。価格レベルは次のように解釈されます。
|
|
省略可 | 数値 |
集計されたユーザー レビューに基づく場所の評価(1.0 ~ 5.0)が含まれます。 |
|
省略可 | 文字列 | |
|
省略可 | ブール値 |
予約に対応しているかどうかを指定します。 |
|
省略可 | Array<PlaceReview> |
最大 5 つのレビューの JSON 配列。デフォルトでは、クチコミは関連性の高い順に並べ替えられます。
Google は、検索結果が 詳しくは、PlaceReview をご覧ください。 |
|
省略可 | 文字列 | |
|
省略可 | Array<PlaceOpeningHours> |
ビジネスの営業時間に関する情報など、次の 7 日間のエントリの配列が含まれます。二次営業時間は、ビジネスのメイン営業時間とは異なります。たとえば、レストランはドライブスルーの営業時間や配達時間を二次的な営業時間として指定できます。このフィールドには 詳しくは、PlaceOpeningHours をご覧ください。 |
|
省略可 | ブール値 |
ビールを提供しているかどうかを指定します。 |
|
省略可 | ブール値 |
朝食を提供しているかどうかを指定します。 |
|
省略可 | ブール値 |
ブランチ メニューがあるかどうかを指定します。 |
|
省略可 | ブール値 |
ディナーを提供しているかどうかを指定します。 |
|
省略可 | ブール値 |
ランチを提供しているかどうかを指定します。 |
|
省略可 | ブール値 |
ベジタリアン料理を提供しているかどうかを指定します。 |
|
省略可 | ブール値 |
ワインを提供しているかどうかを指定します。 |
|
省略可 | ブール値 |
ビジネスがテイクアウトに対応しているかどうかを指定します。 |
|
省略可 | Array<string> |
指定された結果を表す対象物のタイプの配列が含まれます。サポートされているタイプのリストをご覧ください。 |
|
省略可 | 文字列 |
この場所の公式 Google ページの URL を指定します。これは、この場所について入手可能な最良の情報を含む Google のページです。アプリケーションでこの場所に関する詳細結果をユーザーに表示する場合、その画面にこのページへのリンクを設置するか、このページを埋め込む必要があります。 |
|
省略可 | 数値 |
この場所のクチコミの総数(テキストあり / なし)。 |
|
省略可 | 数値 |
この場所の現在のタイムゾーンが UTC からオフセットされている分数。たとえば、オーストラリアのシドニーで夏時間の場合、660(UTC から +11 時間)になります。カリフォルニアで夏時間以外の場合、-480(UTC から -8 時間)になります。 |
|
省略可 | 文字列 |
施設(
その他の結果の場合、 このコンテンツはそのまま読み取られます。フォーマット済み住所をプログラムで解析しないでください。 |
|
省略可 | 文字列 |
会社のホームページなど、当該の場所の公式ウェブサイト。 |
|
省略可 | ブール値 |
車椅子対応の入り口があるかどうかを指定します。 |
PlaceEditorialSummary
場所の概要が含まれています。概要はテキストの概要で構成され、該当する場合はこれらの言語コードも含まれます。要約テキストは現状のまま提示する必要があり、変更や改変はできません。
| フィールド | 必須 | タイプ | 説明 |
|---|---|---|---|
|
省略可 | 文字列 |
前のフィールドの言語。常に存在するとは限りません。 |
|
省略可 | 文字列 |
場所に関する中程度の長さのテキスト形式の要約。 |
PlaceOpeningHours
場所の営業時間を表すオブジェクト。
| フィールド | 必須 | タイプ | 説明 |
|---|---|---|---|
|
省略可 | ブール値 |
お店やサービスが現在営業しているかどうかを示すブール値。 |
|
省略可 | Array<PlaceOpeningHoursPeriod> |
日曜日から始まる 7 日間を時系列で格納する、場所が開いている期間の配列。 詳しくは、PlaceOpeningHoursPeriod をご覧ください。 |
|
省略可 | Array<PlaceSpecialDay> |
次の 7 日間に対応する最大 7 つのエントリの配列。 詳細については、PlaceSpecialDay をご覧ください。 |
|
省略可 | 文字列 |
補助時間のタイプを識別するために使用されるタイプ文字列( |
|
省略可 | Array<string> |
場所の営業時間を人が読める形式のテキストで説明する文字列の配列。 |
PlaceOpeningHoursPeriod
| フィールド | 必須 | タイプ | 説明 |
|---|---|---|---|
|
required | PlaceOpeningHoursPeriodDetail |
場所が開く時刻を表す日付オブジェクトと時刻オブジェクトのペアを含みます。 詳細については、PlaceOpeningHoursPeriodDetail をご覧ください。 |
|
省略可 | PlaceOpeningHoursPeriodDetail |
その場所が営業終了する曜日を表すオプションと時刻を表すオブジェクトのペアが含まれます。場所が年中無休の場合は、レスポンスに close セクションは含まれません。 詳細については、PlaceOpeningHoursPeriodDetail をご覧ください。 |
PlaceSpecialDay
| フィールド | 必須 | タイプ | 説明 |
|---|---|---|---|
|
省略可 | 文字列 |
場所のローカル タイムゾーンで RFC3339 形式で表された日付(例: 2010-12-31)。 |
|
省略可 | ブール値 |
この日に特別営業時間がある場合は true。 |
PlaceOpeningHoursPeriodDetail
| フィールド | 必須 | タイプ | 説明 |
|---|---|---|---|
|
required | 数値 |
日曜日から始まる曜日に対応する 0 ~ 6 の数字。たとえば、2 は火曜日を示します。 |
|
required | 文字列 |
24 時間の hhmm 形式の時刻を格納します。値の範囲は 0000 ~ 2359 です。時刻は場所のタイムゾーンで報告されます。 |
|
省略可 | 文字列 |
場所のローカル タイムゾーンで RFC3339 形式で表された日付(例: 2010-12-31)。 |
|
省略可 | ブール値 |
指定された期間が 7 日間のカットオフにより切り捨てられた場合に true を返します。この期間は、リクエスト日の午前 0 時より前に開始し、最終日の午前 0 時以降に終了します。このプロパティは、営業中または休業中の期間がこの 7 日間の締め切りを超えて延長される可能性があることを示します。 |
PlacePhoto
場所の写真。写真は、次のパターンの URL を使用して Place Photo API でアクセスできます。
https://maps.googleapis.com/maps/api/place/photo?maxwidth=400&photo_reference=photo_reference&key=YOUR_API_KEY
詳しくは、プレイスの写真をご覧ください。
| フィールド | 必須 | タイプ | 説明 |
|---|---|---|---|
|
required | 数値 |
写真の高さ。 |
|
required | Array<string> |
写真の HTML 帰属。 |
|
required | 文字列 |
Photo リクエストを実行するときに写真の識別に使用される文字列。 |
|
required | 数値 |
写真の幅。 |
PlaceReview
ユーザーが送信した場所のレビュー。
| フィールド | 必須 | タイプ | 説明 |
|---|---|---|---|
|
required | 文字列 |
レビューを送信したユーザーの名前。匿名のクチコミは「Google ユーザー」になります。 |
|
required | 数値 |
この場所に対するユーザーの総合評価。1 ~ 5 の整数が含まれます。 |
|
required | 文字列 |
レビューが送信された時刻を現在の時刻からの相対的なテキストで表します。 |
|
required | 数値 |
レビューが送信された時刻。1970 年 1 月 1 日午前 0 時(UTC)からの経過秒数で測定されます。 |
|
省略可 | 文字列 |
ユーザーの Google マップ ローカルガイド プロフィールの URL(プロフィールがある場合)。 |
|
省略可 | 文字列 |
返されたクチコミの言語を示す IETF 言語コード。このフィールドにはメイン言語のタグのみが含まれ、国または地域を示す 2 次タグは含まれません。たとえば、英語のクチコミはすべてが「en」とタグ付けされ、「en-AU」や「en-UK」などのタグは含まれません。クチコミのテキストがなく、評価のみがある場合は、このフィールドは空になります。 |
|
省略可 | 文字列 |
レビューの元の言語を示す IETF 言語コード。クチコミが翻訳されている場合、 |
|
省略可 | 文字列 |
ユーザーのプロフィール写真の URL(ある場合)。 |
|
省略可 | 文字列 |
ユーザーのレビュー。Google プレイスで場所のクチコミを投稿する場合、テキストのクチコミは省略可能です。そのため、このフィールドは空の場合があります。このフィールドには簡易 HTML マークアップが含まれる場合があります。たとえば、エンティティ参照 |
|
省略可 | ブール値 |
レビューが元の言語から翻訳されたかどうかを示すブール値。レビューが翻訳された場合(値が true の場合)、Google はユーザーにその旨を伝えることを推奨します。たとえば、「Google による翻訳」という文字列をレビューに追加できます。 |