Places API(従来版)クイック リファレンス

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 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 パラメータ。移行ガイドをご覧ください。