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

Places API(新版)は、施設、地理的位置、スポットに関する JSON 形式の位置情報を返すウェブサービスです。テキスト検索(新版)、Nearby Search(新版)、Autocomplete(新版)、Place Details(新版)、Place Photos(新版)をサポートしています。

Places API(新版): 主な特長

  • プロダクト: Places API(新版)
  • 別名: Places API
  • カテゴリ: 場所
  • プラットフォーム: ウェブサービス(REST)
  • 実行場所: サーバー(バックエンド コード)
  • リリース ステージ: GA
  • ライフサイクル: アクティブ
  • 概要: Places API(新版)の概要
  • 対象地域: グローバル。EEA の請求先住所が設定されているプロジェクトには、Google Maps Platform の EEA における利用規約(2025 年 7 月 8 日発効)が適用されます。この規約では、緯度、経度、プレイス ID 以外の Places API コンテンツは、Places UI キットを介する場合を除き、どの地図でも使用できません。AI による場所、レビュー、地域の概要は、サポートされている言語と地域でのみご利用いただけます。

Places API(新版): 使用する場面

Places API(新版)を使用するケース:

  • サーバーからテキストクエリ(テキスト検索(新版))または場所の周辺(Nearby Search(新版))で場所を検索する必要がある。
  • Autocomplete(新版)を介して、バックエンドから場所またはクエリの予測入力候補を取得する必要がある。
  • プレイス ID があり、住所、電話番号、評価、クチコミ、写真などの詳細情報が必要な場合。
  • 場所、レビュー、地域の AI による要約が必要な場合。

Places API(新版)を使用しない場合:

  • ネイティブ Android アプリを構築している場合は、代わりに Places SDK for Android を使用してください。
  • ネイティブの iOS アプリを構築している場合は、代わりに Places SDK for iOS を使用してください。
  • ブラウザ ウェブアプリを構築しており、JavaScript で Places ライブラリを読み込む必要がある。代わりに Maps JavaScript API を使用してください。

Places API(新版): 設定

Places API(新版)の公式パッケージ:

  • npm: @googlemaps/places
  • pypi: google-maps-places
  • go: cloud.google.com/go/maps

Places API(新版): よくある間違い

  • 問題: Place Details(新版)、Nearby Search(新版)、テキスト検索(新版)には、返されるフィールドのデフォルト リストがありません。フィールド マスクのないリクエストはエラーを返します。修正: fields パラメータ、$fields パラメータ、または X-Goog-FieldMask ヘッダーを使用して、レスポンス フィールド マスクを渡します。/maps/documentation/places/web-service/choose-fields をご覧ください。
  • 問題: Autocomplete(新版)のセッション トークンが省略されている場合や、セッションの終了後に再利用されている場合、各リクエストは SKU: Autocomplete Requests として個別に課金されます。修正方法: セッションごとに新しいセッション トークン(UUID v4 を推奨)を生成し、Place Details(新版)または Address Validation のリクエストでセッションを終了します。/maps/documentation/places/web-service/place-session-tokens をご覧ください。
  • 問題: 以前の API が有効になっていないプロジェクトで、Places API(従来版)または Maps JavaScript API PlacesService を呼び出す既存のコードまたは AI 生成コードが LegacyApiNotActivatedMapError で失敗する。修正方法: 呼び出しを Places API(新版)に移行し、必要なフィールド マスクを含めます。/maps/legacy#LegacyApiNotActivatedMapError をご覧ください。
  • 問題: 保存されたプレイス ID が古くなると、Place Details(新版)は NOT_FOUND(HTTP 404)を返し、不正な形式の ID や切り捨てられた ID は HTTP 400 INVALID_ARGUMENT を返します。修正: 12 か月以上経過している保存済みのプレイス ID を、id フィールドのみをリクエストする Place Details(新版)リクエストで更新します(無料)。/maps/documentation/places/web-service/place-id#refresh-id をご覧ください。

Places API(新版)でできること

各タスクについては、以下のリンク先のガイドをご覧ください。また、機能エクスプローラでプロダクトを比較することもできます。

Places API(新版): 生成 AI

Places API(新版): Places