Places API (New) には、次の API が含まれています。
このドキュメントでは、これらの新しい API の概要について説明します。
Place Details(新規)
プレイス ID は、Google プレイスのデータベースと Google マップで、プレイスを一意に識別します。プレイス ID を使用して、Place Details (New) リクエストを開始して、特定の店舗やスポットの詳細をリクエストできます。Place Details (New) リクエストは、完全な住所、電話番号、ユーザーの評価、クチコミなど、指定されたプレイスに関する包括的な情報を返します。
プレイス ID を取得する方法はいくつかあります。次を使用できます。
Place Photo(新規)
Place Photo(新規)API を使用すると、Google プレイス データベースに保存されている数百万件の写真にアクセスして、質の高い写真コンテンツをアプリケーションに追加できます。Place Photo(新規)API を使用すると、写真にアクセスして、アプリケーションに最適なサイズに画像のサイズを変更できます。
Place Photo(新規)API へのすべてのリクエストには、返される写真を一意に識別する写真リソース名を含める必要があります。写真リソース名を取得するには、次のコマンドを使用します。
Place Details(新版)、テキスト検索(新版)、Nearby Search(新版)のリクエストからのレスポンスに写真リソース名を含めるには、リクエストのフィールド マスクに photos
フィールドを含める必要があります。
テキスト検索(新版)と Nearby Search(新版)
Places API には、次の 2 つの検索 API が含まれています。
-
場所を検索するテキスト文字列を指定できます。たとえば、「オーストラリアのシドニーでスパイシーなベジタリアン料理」や「カリフォルニア州パロアルト近郊の高級シーフード レストラン」などです。
価格帯、現在の営業状況、評価、特定のプレイス タイプなどの詳細を指定することで、検索を絞り込むことができます。特定の地域の結果を優先するように指定したり、検索を特定の地域に制限したりすることもできます。
-
検索する地域と場所の種類のリストを指定できます。中心点の緯度と経度の座標と半径(メートル単位)で定義された円としてリージョンを指定します。
プレイスの特性を定義するプレイスタイプを 1 つ以上指定します。たとえば、「
pizza_restaurant
」と「shopping_mall
」を指定して、指定した地域のショッピング モールに位置するピザレストランを検索します。
2 つの検索の主な違いは、Text Search(新規)では任意の検索文字列を指定できること、Nearby Search(新規)では検索する特定のエリアが必要になることです。
Autocomplete(新規)とセッション トークン
Autocomplete (New) は、HTTP リクエストに応じて場所の候補とクエリ予測を返すウェブサービスです。リクエストでは、テキスト検索文字列に加え、検索対象地域を限定する地理的境界を指定します。
セッション トークンは、Autocomplete(新規)の呼び出しをセッションとして追跡するユーザー作成の文字列です。Autocomplete(新規)は、セッション トークンを使用して、ユーザーの予測入力検索のクエリと選択フェーズを、請求処理のために個別のセッションにグループ化します。
新しいフィールド、属性、ユーザー補助オプション
Places API(新規)には、場所に関する詳細情報をユーザーに提供する新しいフィールド、属性、ユーザー補助オプションが含まれています。これらの点については、以降のセクションで説明します。
フィールド
Places API(新規)には、いくつかの新しいフィールドが含まれています。
フィールド | 説明 |
---|---|
regularSecondaryOpeningHours |
特定のオペレーションの特定の時間を表します。副業としての営業時間は、ビジネスの主な営業時間とは異なります。たとえば、レストランはドライブスルーの時間やデリバリーの時間を副業時間として指定できます。 |
paymentOptions |
施設で利用できるお支払い方法。1 つの場所で複数のお支払い方法を利用できます。お支払い方法のデータが利用できない場合は、お支払い方法のフィールドが設定解除されます。選択できるオプションは次のとおりです。
|
parkingOptions |
施設が提供する駐車場のオプション。選択できるオプションは次のとおりです。
|
subDestinations |
特定の場所に関連する一意の場所。たとえば、空港ターミナルは空港のサブデスティネーションと見なされます。 |
fuelOptions |
ガソリンスタンドで利用可能な燃料オプションに関する最新情報。なお、こうした情報は定期的に更新されます。次のオプションがあります。
|
evChargeOptions |
このスタンドにある電気自動車(EV)充電器の数。EV 充電器には複数のコネクタが付いているものもありますが、各充電器で一度に充電できる車両は 1 台のみです。そのため、このフィールドには、特定の時点で利用可能な EV 充電器の数が表示されます。 |
shortFormattedAddress |
場所の短い、人が読める住所。 |
primaryType |
指定された結果の主なタイプ。たとえば、場所は cafe または airport に分類されます。プレイスには、プライマリ タイプを 1 つだけ指定できます。有効な値の一覧については、サポートされているタイプをご覧ください。 |
primaryTypeDisplayName |
メインタイプの表示名(該当する場合はリクエスト言語にローカライズ)。有効な値の一覧については、サポートされているタイプをご覧ください。 |
属性
Places API(新規)には、次のような新しい属性が含まれています。
属性 | 説明 |
---|---|
outdoorSeating |
屋外席がある。 |
liveMusic |
ライブ音楽を提供する場所。 |
menuForChildren |
キッズメニューがある。 |
servesCocktails |
カクテルを提供する場所。 |
servesDessert |
デザートを提供している場所。 |
servesCoffee |
コーヒーを提供する場所。 |
goodForChildren |
子供連れに適した場所です。 |
allowsDogs |
犬の同伴可。 |
restroom |
トイレがある。 |
goodForGroups |
グループに対応している場所。 |
goodForWatchingSports |
スポーツ観戦に適した場所。 |
ユーザー補助機能の設定
Places API(新規)には、次のユーザー補助オプション フィールドが含まれています。
フィールド | 説明 |
---|---|
wheelchairAccessibleParking |
車椅子対応の駐車場がある。 |
wheelchairAccessibleEntrance |
車椅子対応の入り口がある。 |
wheelchairAccessibleRestroom |
車椅子対応のトイレがある。 |
wheelchairAccessibleSeating |
車椅子対応の座席がある。 |
新しい Places API に移行する
既存の Places API ユーザーで、新しい API を使用するようにアプリを移行する場合は、次の移行ドキュメントをご覧ください。
- Place Details に移行する(新規)
- Nearby Search(新規)に移行する
- Text Search(新規)に移行する
- Place Photo(新規)に移行する
- Autocomplete に移行する(新規)