プレイス ID を取得したら、 特定の施設の詳細情報や 開始して Place Details(New) リクエストできます。A Place Details(新) リクエストにより、指定された場所に関するより包括的な情報が返される 詳細な住所、電話番号、ユーザーの評価、クチコミなど、
プレイス ID はさまざまな方法で取得できます。次を使用できます。
API Explorer を使用すると、ライブ リクエストを発行できるため、API と API オプション:
試してみるPlace Details (New) リクエスト
Place Details リクエストは、次の形式の HTTP GET リクエストです。
https://places.googleapis.com/v1/places/PLACE_ID
すべてのパラメータを URL パラメータとして、または GET リクエスト。例:
https://places.googleapis.com/v1/places/ChIJj61dQgK6j4AR4GeTYWZsKWw?fields=id,displayName&key=API_KEY
または、cURL コマンドで次のようにします。
curl -X GET -H 'Content-Type: application/json' \ -H "X-Goog-Api-Key: API_KEY" \ -H "X-Goog-FieldMask: id,displayName" \ https://places.googleapis.com/v1/places/ChIJj61dQgK6j4AR4GeTYWZsKWw
Place Details(新)レスポンス
Place Details (New) は、 <ph type="x-smartling-placeholder"></ph> レスポンスとしての JSON オブジェクト。レスポンスの説明:
- レスポンスは、トレーニング データの
Place
渡されます。Place
オブジェクトには、インスタンスに関する詳細情報が含まれます。 できます。 - リクエストで渡される FieldMask はフィールドのリストを指定します。
Place
オブジェクトで返されます。
完全な JSON オブジェクトの形式は次のとおりです。
{ "name": "places/ChIJkR8FdQNB0VQRm64T_lv1g1g", "id": "ChIJkR8FdQNB0VQRm64T_lv1g1g", "displayName": { "text": "Trinidad" } ... }
必須パラメータ
-
FieldMask
レスポンスで返すフィールドのリストを指定するには、 レスポンス フィールド マスク。 URL パラメータを使用してレスポンス フィールド マスクをメソッドに渡します。
$fields
またはfields
、または HTTP ヘッダーを使用するX-Goog-FieldMask
。レスポンスで返されるフィールドのデフォルトのリストはありません。 フィールド マスクを省略すると、メソッドはエラーを返します。フィールド マスキングは、API 呼び出しのリクエストを 保存し、不要な処理時間を回避して、 請求料金を管理できます。
返される場所のデータタイプをカンマ区切りのリストで指定します。たとえば 場所の表示名と住所を取得できます。
X-Goog-FieldMask: displayName,formattedAddress
*
を使用してすべてのフィールドを取得します。X-Goog-FieldMask: *
次のフィールドを 1 つ以上指定します。
以下のフィールドで Place Details(ID のみ)SKU がトリガーされます。
attributions
,id
,name
*、photos
*name
フィールドには場所のリソース名が含まれます 次の形式にします:places/PLACE_ID
。displayName
を使用する 場所のテキスト名にアクセスします。次のフィールドで Place Details(場所のみ)SKU がトリガーされます。
addressComponents
,adrFormatAddress
,formattedAddress
,location
,plusCode
,shortFormattedAddress
,types
,viewport
以下のフィールドで Place Details(Basic)SKU がトリガーされます。
accessibilityOptions
,businessStatus
,displayName
,googleMapsUri
,iconBackgroundColor
,iconMaskBaseUri
,primaryType
,primaryTypeDisplayName
,subDestinations
,utcOffsetMinutes
以下のフィールドで Place Details(Advanced)SKU がトリガーされます。
currentOpeningHours
,currentSecondaryOpeningHours
,internationalPhoneNumber
,nationalPhoneNumber
,priceLevel
,rating
,regularOpeningHours
,regularSecondaryOpeningHours
,userRatingCount
,websiteUri
以下のフィールドで Place Details(Preferred)SKU がトリガーされます。
allowsDogs
,curbsidePickup
,delivery
,dineIn
,editorialSummary
,evChargeOptions
,fuelOptions
,goodForChildren
,goodForGroups
,goodForWatchingSports
,liveMusic
,menuForChildren
,parkingOptions
,paymentOptions
,outdoorSeating
,reservable
,restroom
,reviews
,servesBeer
,servesBreakfast
,servesBrunch
,servesCocktails
,servesCoffee
,servesDessert
,servesDinner
,servesLunch
,servesVegetarianFood
,servesWine
,takeout
-
placeId
場所を一意に識別するテキスト表記の ID。 テキスト検索(新版) Nearby Search(新版)。 プレイス ID について詳しくは、 プレイス ID の概要をご覧ください。
文字列
places/PLACE_ID
は「場所」とも呼ばれます。 リソース名。Place Details(New)からのレスポンスで、 Nearby Search(新版)、テキスト検索(新版) この文字列はレスポンスのname
フィールドに格納されます。スタンドアロン プレイス ID はレスポンスのid
フィールドに含まれます。
オプション パラメータ
languageCode
結果を返す言語。
- 詳しくは、 サポートされている言語の一覧をご覧ください。Google は頻繁に更新 対応言語が限られているため、このリストがすべてを網羅しているとは限りません。
-
languageCode
が指定されていない場合、API はデフォルトでen
になります。条件 無効な言語コードを指定すると、API からINVALID_ARGUMENT
エラーが返されます。 - API は可能な限り判読可能な番地を提供する ローカルユーザーの両方に対応しますこの目標を達成するために、 ローカル言語で記述されたアドレスを、API によって読み取り可能なスクリプトに ユーザーが必要に応じて言語を観察します。その他 住所は優先言語で返されます。住所項目は次のとおりです。 すべて同じ言語が返されます。言語は、最初の言語から 説明します。
- 使用したい言語で名前が使用できない場合、API は 最も近いものを選択します
- 優先言語は、表示される結果セットにほとんど影響しません。 返される順序を指定します。「 ジオコーダは、略語を言語、 道路の種類の略語や同義語など、 ある言語では有効であっても別の言語では有効でない場合があります
regionCode
レスポンスのフォーマットに使用される地域コード。 <ph type="x-smartling-placeholder"></ph> 2 文字の CLDR コードの値。デフォルト値はありません。
レスポンスの
formattedAddress
フィールドの国名がregionCode
の場合、国コードはformattedAddress
から省略されます。 このパラメータはadrFormatAddress
(常に国を含む)には影響しません。 これを含まないshortFormattedAddress
で使用できます。ほとんどの CLDR コードは ISO 3166-1 コードと同一です。 いくつか例外がありますたとえば、英国の ccTLD は 「uk」(.co.uk)、ISO 3166-1 コードは「gb」(技術的には、 「グレート ブリテンおよび北アイルランド連合王国」という当事者である必要があります)。 このパラメータは、適用される法律に基づき、結果に影響する場合があります。
-
sessionToken
セッション トークンは、予測入力を追跡するユーザー生成文字列です。 (新規)通話を「セッション」と呼びます。予測入力(新版)ではセッション トークンを使用して ユーザーの予測入力検索のクエリと場所選択のフェーズを個別のセッションにグループ化する 請求に使用されます。セッション トークンが Place Details に渡される(新) 。詳細については、次をご覧ください: セッション トークン。
Place Details の例
次の例では、場所の詳細をリクエストしています。
placeId
:
curl -X GET -H 'Content-Type: application/json' \ -H "X-Goog-Api-Key: API_KEY" \ -H "X-Goog-FieldMask: id,displayName" \ https://places.googleapis.com/v1/places/ChIJj61dQgK6j4AR4GeTYWZsKWw
X-Goog-FieldMask
ヘッダーは、
レスポンス
データ フィールド id,displayName
が含まれています。
レスポンスは次の形式になります。
{ "id": "ChIJj61dQgK6j4AR4GeTYWZsKWw", "displayName": { "text": "Googleplex", "languageCode": "en" } }
追加情報を返すには、フィールド マスクにデータ型を追加します。
たとえば、formattedAddress,plusCode
を追加して
メールアドレスと Plus Code
response:
curl -X GET -H 'Content-Type: application/json' \ -H "X-Goog-Api-Key: API_KEY" \ -H "X-Goog-FieldMask: id,displayName,formattedAddress,plusCode" \ https://places.googleapis.com/v1/places/ChIJj61dQgK6j4AR4GeTYWZsKWw
レスポンスは次の形式になります。
{ "id": "ChIJj61dQgK6j4AR4GeTYWZsKWw", "formattedAddress": "1600 Amphitheatre Pkwy, Mountain View, CA 94043, USA", "plusCode": { "globalCode": "849VCWC7+RW", "compoundCode": "CWC7+RW Mountain View, CA, USA" }, "displayName": { "text": "Googleplex", "languageCode": "en" } }
試してみよう:
API Explorer を使用すると、サンプル リクエストを作成して、 API と API オプションに慣れることができます。
リクエストを行うには:
- API アイコン
を選択します。 。
- 必要に応じて、
name
パラメータを次のように設定します。places/PLACE_ID
- 必要に応じて [標準パラメータを表示] を展開し、次のように設定します。
fields
パラメータ フィールド マスクに追加します。 - [Execute] ボタンを選択します。ポップアップで、削除するアカウントを選択します。 使用します。
[API Explorer] パネルで、展開アイコンを選択します。
: API Explorer ウィンドウを展開します。