Places API（新版）について

Places API（新版）には、次の 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 が含まれています。

  • テキスト検索（新規）

    場所を検索するテキスト文字列を指定できます。たとえば、「オーストラリアのシドニーでスパイシーなベジタリアン料理」や「カリフォルニア州パロアルト近郊の高級シーフード レストラン」などです。

    価格帯、現在の営業状況、評価、特定のプレイス タイプなどの詳細を指定して、検索を絞り込むことができます。特定の地域の結果を優先するように指定したり、検索を特定の地域に制限したりすることもできます。

  • Nearby Search（新規）

    検索する地域と場所の種類のリストを指定できます。中心点の緯度と経度の座標と半径（メートル単位）で定義された円としてリージョンを指定します。

    プレイスの特性を定義するプレイスタイプを 1 つ以上指定します。たとえば、「pizza_restaurant」と「shopping_mall」を指定して、指定した地域のショッピング モールに位置するピザレストランを検索します。

2 つの検索の主な違いは、テキスト検索（新版）では任意の検索文字列を指定できること、Nearby Search（新版）では検索する特定のエリアを指定する必要があることにあります。

Autocomplete（新規）とセッション トークン

Autocomplete (New) は、HTTP リクエストに応じて場所の候補とクエリ予測を返すウェブサービスです。リクエストでは、テキスト検索文字列に加え、検索対象地域を限定する地理的境界を指定します。

セッション トークンは、Autocomplete（新規）の呼び出しをセッションとして追跡するユーザー作成の文字列です。Autocomplete（新規）は、セッション トークンを使用して、予測入力検索でのユーザーのクエリと選択フェーズを、請求処理のために個別のセッションにグループ化します。

新しいフィールド、属性、ユーザー補助オプション

Places API（新規）には、場所に関する詳細情報をユーザーに提供する新しいフィールド、属性、ユーザー補助オプションが含まれています。これらの点については、以降のセクションで説明します。

フィールド

Places API（新規）には、いくつかの新しいフィールドが含まれています。

フィールド 説明
regularSecondaryOpeningHours 特定のオペレーションの特定の時間を表します。副業としての営業時間は、ビジネスの主な営業時間とは異なります。たとえば、レストランはドライブスルーの時間やデリバリーの時間を副業時間として指定できます。
paymentOptions 施設で利用できるお支払い方法。1 つの場所で複数のお支払い方法を利用できます。お支払い方法のデータが利用できない場合は、お支払い方法のフィールドが設定解除されます。選択できるオプションは次のとおりです。
  • クレジット カード
  • デビットカード
  • 現金のみ
  • NFC 支払い
parkingOptions 施設が提供する駐車場のオプション。選択できるオプションは次のとおりです。
  • 無料駐車場
  • 有料駐車場
  • 無料の路上駐車場
  • バレー パーキング
  • 無料の屋内駐車場
  • 有料の屋内駐車場
subDestinations 特定の場所に関連する一意の場所。たとえば、空港ターミナルは空港のサブデスティネーションと見なされます。
fuelOptions ガソリンスタンドで利用可能な燃料オプションに関する最新情報。なお、こうした情報は定期的に更新されます。次のオプションがあります。
  • Diesel
  • レギュラー無鉛
  • プラス
  • プレミアム
  • SP91
  • SP91 E10
  • SP92
  • SP95 E10
  • SP98
  • SP99
  • SP100
  • 液化石油ガス提供あり
  • E80
  • E85
  • メタン
  • バイオディーゼル
  • トラック用ディーゼル
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 を使用するようにアプリを移行する場合は、次の移行ドキュメントをご覧ください。