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