2026 年 10 月以降、新しい Google Cloud プロジェクトで Places API(従来版)を有効にすることはできなくなります。既存のプロジェクトは引き続き完全にサポートされます。新機能とパフォーマンスの向上をご利用いただくには、Places API(新版)に移行してください。
Places API(従来版): 主なポイント
- プロダクト: Places API(従来版)
- 別名: Places API(レガシー ウェブサービス)、Places API ウェブサービス(maps/api/place)
- カテゴリ: 場所
- プラットフォーム: ウェブサービス(REST)
- 実行場所: サーバー(バックエンド コード)
- リリース ステージ: GA
- ライフサイクル: レガシー
- 置き換え後の API: Places API(新版)
- 概要: Places API(従来版)の概要
Places API(従来版): 使用するケース
Places API(従来版)を使用する場合:
- Places API(従来版)がすでに有効になっていて、
maps.googleapis.com/maps/api/placeエンドポイントを呼び出す既存のプロジェクトを管理している。 - 移行中も、既存の Find Place、Nearby Search、テキスト検索、Details、Photos、Autocomplete(従来版)の呼び出しが引き続き機能する必要があります。
Places API(従来版)を使用すべきでない場合:
- 新しい Google Cloud プロジェクトを開始する。2026 年 10 月以降、新しいプロジェクトで Places API(従来版)を有効にすることはできなくなります。代わりに Places API(新版)を使用してください。
- Nearby Search とテキスト検索で、新機能、OAuth 認証、フィールド マスクが必要な場合。フィールド マスクを使用すると、リクエストしたフィールドに対してのみ料金が発生します。代わりに Places API(新版)を使用してください。
- 新しいコードで Find Place(従来版)または Query Autocomplete(従来版)が必要な場合。代わりに、テキスト検索(新版)と予測入力(新版)を使用します。代わりに Places API(新版)を使用してください。
Places API(従来版): 設定
- 有効にするサービス:
places-backend.googleapis.com - 認証: API キー
- 料金: Places API(従来版)の使用量と請求額
- ポリシー: Places API(従来版)のポリシー
Places API(従来版): よくある間違い
- 問題: Place Details(従来版)リクエストで
fieldsパラメータを省略するか、フィールドを指定しない場合、API はすべてのフィールドを返し、すべてのフィールドに対して課金されます。修正方法: 常にfieldsパラメータを設定するか、フィールド マスクを使用して Place Details(新版)に移行します。/maps/documentation/places/web-service/legacy/details をご覧ください。 - 問題: Nearby Search(従来版)とテキスト検索(従来版)では、どのフィールドを返すかを指定できません。これらの API は常に固定されたフィールド セット(Place Details フィールドのサブセット)を返し、Basic Data、Contact Data、Atmosphere Data の SKU が課金されます。修正方法: フィールド マスクを使用して Nearby Search(新版)またはテキスト検索(新版)に移行するか、
fieldsパラメータを指定して Find Place(従来版)を使用し、必要なフィールドのみをリクエストして料金を支払います。/maps/billing-and-pricing/sku-details/legacy#places_nearby-search-legacy-pro-sku をご覧ください。 - 問題:
photo_referenceはキャッシュに保存できず、有効期限が切れる可能性があるため、保存された参照が機能しなくなります。修正方法: 写真をリクエストする前に、Place Details、Find Place、Nearby Search、またはテキスト検索のレスポンスから新しいphoto_referenceを取得します。/maps/documentation/places/web-service/legacy/photos をご覧ください。 - 問題: Places API(従来版)が有効になっていないプロジェクトから Places API(従来版)を呼び出すと、
REQUEST_DENIEDが返され、「You're calling a legacy API, which is not enabled for your project...」というエラー メッセージが表示されます。(LegacyApiNotActivatedMapError)。2026 年 10 月以降、新しいプロジェクトで Places API(従来版)を有効にすることはできません。修正: 新しいプロジェクトには Places API(新版)を使用し、既存のアプリを移行します。移行中に、以前のページのフィードバック フォームから以前の API の短期的な有効化をリクエストできます。/maps/legacy#LegacyApiNotActivatedMapError をご覧ください。
Places API(従来版): 従来版の機能と非推奨の機能
permanently_closedレスポンス フィールド: 2020 年 5 月 26 日より非推奨。代替:business_statusフィールド。移行ガイドをご覧ください。referenceレスポンス フィールド: 2019 年 9 月 3 日より非推奨。代替:place_idフィールド。移行ガイドをご覧ください。- Nearby Search(従来版)の
nameリクエスト パラメータ: 非推奨。置換:keywordパラメータ。移行ガイドをご覧ください。