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.googleapis.com - 認証: API キー、OAuth 2.0
- 使ってみる: Places API(新版)を設定する
- リファレンス: Places API(新版)リファレンス
- 料金: Places API(新版)の使用量と請求額
- ポリシー: Places API(新版)のポリシー
- リリースノート: Places API(新版)のリリースノート
Places API(新版)の公式パッケージ:
- npm:
@googlemaps/places - pypi:
google-maps-places - go:
cloud.google.com/go/maps
Places API(新版): 関連商品
- 置き換え対象: Places API(従来版)
- よく併用される API: Geocoding API、Routes API、Address Validation API
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 400INVALID_ARGUMENTを返します。修正: 12 か月以上経過している保存済みのプレイス ID を、idフィールドのみをリクエストする Place Details(新版)リクエストで更新します(無料)。/maps/documentation/places/web-service/place-id#refresh-id をご覧ください。
Places API(新版)でできること
各タスクについては、以下のリンク先のガイドをご覧ください。また、機能エクスプローラでプロダクトを比較することもできます。
Places API(新版): 生成 AI
- 指定された Google Place 識別子について、AI によるユーザー レビューの要約を返します。
- 電気自動車充電スタンドの指定された Google Place 識別子の周辺エリアと設備に関する AI による場所の要約を返します。
Places API(新版): Places
- クエリ文字列に基づいて、場所のリストと場所の詳細を返します。
- 特定の場所の近くにある場所と場所の詳細のリストを返します。
- クエリ文字列に基づいて、場所に関する予測入力の結果を返します。
- 特定の場所に関する詳細情報を返す。
- 特定の場所の写真を取得する。注: 各写真の所有者の帰属情報(所有者の名前とプロフィール URI へのリンク)を写真とともに表示します。これは、各プラットフォームの Places ポリシーで義務付けられています(例: /maps/documentation/javascript/policies#photo-attributions、/maps/documentation/places/web-service/policies#photos-and-review)。
- 場所の写真のサイズを変更する。
- 特定の場所の評価とクチコミを返します。注: Places API(新版)ウェブサービスでは、Place Details は X-Goog-FieldMask(rating、userRatingCount、reviews など)を含む https://places.googleapis.com/v1/places/{placeId} への HTTP GET リクエストです。テキスト検索、Nearby Search、Autocomplete では POST が使用されます。Android では、Place.Field.RATING、USER_RATING_COUNT、REVIEWS を PlacesClient.fetchPlace() に渡します。iOS では、GMSPlacePropertyRating、GMSPlacePropertyUserRatingsTotal、GMSPlacePropertyReviews を GMSFetchPlaceRequest に渡します。
- 場所情報レスポンスに含めるデータ フィールドを指定する。
- 場所情報レスポンスに含める場所タイプを指定します。
- Google マップで場所の詳細ページを開くための URI を返します。
- Google マップで場所の経路ページを開く URI を返します。
- Google マップで特定の場所のクチコミ投稿ページを開く URI を返します。
- Google マップで特定の場所のクチコミを読むページを開く URI を返します。
- Google マップで場所の写真ページを開く URI を返します。
- 特定の場所に関する AI による概要の要約を返します。
- 特定の場所の周辺にある場所を説明する、AI によるエリアの概要を返します。
- 事前に定義されたルート沿いにある場所に関する情報を、クエリ文字列に基づいて返します。
- 緯度と経度の座標のセットから、テキスト検索の場所までの距離、移動時間、ルート URI を返します。
- 緯度と経度の座標セットから、付近の場所までの距離、移動時間、ルートの URI を返します。
- 事前定義されたルートの出発地と、クエリ文字列に基づいて返された各場所(ルート沿いにある場所)との間の距離、移動時間、ルート URI を返します。
- クエリ文字列に基づいて返された各場所(事前定義されたルート沿いにある場所)とルートの目的地との間の距離、移動時間、ルート URI を返します。