Places API（従来版）の概要

欧州経済領域（EEA）のデベロッパー

はじめに

Places API を使用すると、テキスト文字列または近接性を使用して、さまざまな場所のタイプに関する情報を検索して取得できます。Places API（従来版）は、Places API（新版）の以前のバージョンです。

次の表に、両方の API の対応するバージョンを示します。このガイドでは、2 つの API の主な違いを理解し、Places API（新版）に移行する方法について説明します。

Places API（以前のバージョン）	Places API（新規）	メモ
Find Place（レガシー）	テキスト検索（新機能）	Find Place（Legacy）の新しいバージョンはありません。テキスト検索（新版）に置き換えられました。
Nearby Search（レガシー）	Nearby Search（新規）	テキストクエリを含む以前の API を使用するすべてのリクエストでは、テキスト検索（新版）を使用する必要があります。これは、周辺検索（新版）ではテキスト入力がサポートされていないためです。
テキスト検索（レガシー）	テキスト検索（新機能）
Place Details（レガシー）	Place Details（新規）
Place Photos（レガシー）	Place Photos（新規）
Place Autocomplete（従来版）	オートコンプリート（新規）
Query Autocomplete（以前の方法）	オートコンプリート（新規）	Autocomplete（新版）に追加された機能。

新しい API に移行する

新しい API に移行するには、次の移行ガイドをご覧ください。

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 充電スタンドの空き状況やガソリンスタンドの最新の燃料価格などの動的レスポンスデータをサポートしています。これらのレスポンスフィールドを使用して、動的なユーザーエクスペリエンスを作成します。