はじめに
Places API を使用すると、テキスト文字列または近接性を使用して、さまざまな場所のタイプに関する情報を検索して取得できます。Places API(従来版)は、Places API(新版)の従来版です。
次の表に、両方の API の対応するバージョンを示します。このガイドでは、2 つの API の主な違いを理解し、Places API(新版)に移行する方法について説明します。
Places API(以前のバージョン) | Places API(新規) | メモ |
---|---|---|
Find Place(レガシー) | テキスト検索(新機能) | Find Place(Legacy)の新しいバージョンはありません。この API はテキスト検索(新版)に置き換えられました。 |
Nearby Search(レガシー) | Nearby Search(新規) | テキスト クエリを含む以前の API を使用するすべてのリクエストでは、テキスト検索(新版)を使用する必要があります。これは、Nearby Search(新版)ではテキスト入力がサポートされていないためです。 |
テキスト検索(レガシー) | テキスト検索(新機能) | |
Place Details(レガシー) | Place Details(新しいバージョン) | |
Place Photos(レガシー) | Place Photos(新規) | |
Place Autocomplete(従来版) | オートコンプリート(新規) | |
Query Autocomplete(以前の方法) | オートコンプリート(新規) | Autocomplete(新版)に追加された機能。 |
新しい API に移行する
新しい API に移行するには、次の移行ガイドをご覧ください。
- Nearby Search(新規)に移行する
- Text Search(新)に移行する
- Place Details(新規)に移行する
- Place Photos(新)に移行する
- Autocomplete に移行する(新規)
Places API(新機能)に追加された主な機能
このセクションでは、Places API(新版)に追加された主な機能について説明します。
Google Cloud 標準プラットフォームで実装
Places API(新版)は、Google Cloud のサービス インフラストラクチャに実装されています。この実装により、OAuth などの強化されたセキュリティ オプションを備えた、安全で信頼性の高いプラットフォームが実現します。この標準 API 設計は、API 全体にある程度の一貫性をもたらし、Places API(New)での開発効率を向上させます。
パフォーマンスの向上
Places API(新版)はパフォーマンスが向上しているため、既存の Places API を使用しているアプリを置き換える価値があります。
シンプルな料金体系
Places API(新版)では、料金設定が簡素化され、使用したデータに対してのみ料金が発生します。シンプルな料金設定は、フィールド マスクを使用して実装されます。
Place Details(新版)、Nearby Search(新版)、テキスト検索(新版)では、フィールド マスクを使用して、レスポンスで返されるフィールドのリストを制御します。この場合、リクエストされたデータに対してのみ課金されます。フィールド マスキングを使用することは、不要なデータをリクエストしないようにするための優れた設計手法です。これにより、不要な処理時間と課金を回避できます。
ビジネスの一貫したレスポンス データ
以前の API では、Place Details(以前のバージョン)、Nearby Search(以前のバージョン)、Text Search(以前のバージョン)の各 API が、場所に対して異なるレスポンス データを返していました。Places API(新版)ではレスポンスが標準化され、これらの API はすべて同じ場所のデータを返します。
拡張された場所タイプ
API レスポンスに、場所のプライマリ タイプを含めることができるようになりました。テーブル A に記載されているように、すべての場所には、場所のプライマリ タイプとして指定された単一のタイプ値を設定できます。
新しい API には、いくつかの新しい型も含まれています。これらの新しいタイプと既存のタイプは、Nearby Search(新版)とテキスト検索(新版)の検索で使用できます。新しいタイプはすべて表 A に含まれています。
動的な場所データ
Places API(新)は、EV 充電スタンドの空き状況やガソリン スタンドの最新の燃料価格などの動的レスポンス データをサポートしています。これらのレスポンス フィールドを使用して、動的なユーザー エクスペリエンスを作成します。