移行の概要

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

このガイドでは、以前の Places Service と新しい Place クラスの主な違いについて説明します。Place クラスにアップグレードすると、パフォーマンスの向上や新しい料金モデルなど、大きなメリットがあります。Places を最大限に活用し、アプリを最新の状態に保つには、このガイドで説明する変更について理解しておく必要があります。

移行の請求に関するベスト プラクティス

このガイダンスは、API の使用量が第 2 階層の料金に移行するほど多い場合に適用されます。API の新しいバージョンに移行すると、別の SKU の料金も請求されます。移行月の費用増加を避けるため、できるだけ月の初めに本番環境で新しい API に切り替えることをおすすめします。これにより、移行月の月額料金階層を最も費用対効果の高いものにすることができます。料金階層については、料金ページと料金に関するよくある質問をご覧ください。

Places API を有効にする

プレイスクラスは Places API サービスに依存しています。新しい Place クラスの機能を使用するには、まず Google Cloud プロジェクトで Places API（新版）を有効にする必要があります。詳細については、スタートガイドをご覧ください。

全般的な変更点

次の表に、PlacesService と Place の主な違いをまとめます。

PlacesService（レガシー） Place（新規）
メソッドでは、結果オブジェクトと google.maps.places.PlacesServiceStatus レスポンスを処理するためにコールバックを使用する必要があります。 Promise を使用し、非同期で動作します。
メソッドには PlacesServiceStatus チェックが必要です。 ステータス チェックは不要で、標準のエラー処理を使用できます。
プレイス データ フィールドはスネークケースでフォーマットされます。 プレイス データ フィールドは、キャメルケースでフォーマットされます。
場所タイプと場所データ フィールドの固定セットに限定されます。 定期的に更新される場所のタイプと場所のデータ フィールドの選択肢が拡大されます。

API 固有の変更

プレイスクラスは、プレイス ライブラリを活用できる API で、Promise などの現代的な運用パターンにも対応しています。Place クラスは、以前の Places Service と同じプレイスデータ フィールドとプレイスタイプを公開し、プレイスデータ フィールドとプレイスタイプの新しい値も多数含んでいます。

次の表に、Places Service の機能と Place クラスの機能の対応関係を示します。

プレイス サービス（従来版） プレイスクラス（新規）
プレイスデータ フィールド プレイスクラスのデータ フィールド
場所タイプ 場所タイプ
PlacesService.findPlaceFromQuery() Place.searchByText()
PlacesService.findPlaceFromPhoneNumber() Place.searchByText()
PlacesService.textSearch() Place.searchByText()
PlacesService.nearbySearch() Place.searchNearby()
PlacesService.getDetails() Place.fetchFields()
Places.AutocompletionRequest Places.AutocompleteRequest
Places.AutocompletePrediction Places.PlacePrediction
Autocomplete クラス PlaceAutocompleteElement クラス
SearchBox クラス ---

プレイス ライブラリを読み込む

アプリが Places ライブラリを読み込む方法は、使用中のブートストラップ ローダーによって異なります。アプリで動的ライブラリのインポートを使用している場合は、await 演算子を使って importLibrary() を呼び出すことで、実行時に必要なライブラリを読み込むことができます。コードは以下のようになります。

const { Place } = await google.maps.importLibrary("places");

アプリでダイレクト スクリプト読み込みタグを使用している場合は、ローダースクリプトで places ライブラリをリクエストします。

<script async
    src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&loading=async&libraries=places&callback=initMap">
</script>

詳しくは、Maps JavaScript API の読み込みについての記事をご覧ください。

このセクションでは、最新バージョンの Places API を使用するようにアプリを移行する際に役立つ次のガイドを紹介します。