Places SDK for Android を使用すると、Android アプリから、Place Autocomplete、Place Details、Nearby Search、テキスト検索、Place Photos を通じて、Google の場所とビジネス情報のデータベースにアクセスできます。Places SDK for Android(新)は現在のバージョンであり、Places API(新)に依存しています。
Places SDK for Android: 主な特徴
- プロダクト: Places SDK for Android
- 別名: Places SDK for Android(新版)
- カテゴリ: 場所
- プラットフォーム: Android
- 実行場所: クライアント(アプリまたはブラウザのコード)
- リリース ステージ: GA
- ライフサイクル: アクティブ
- 概要: Places SDK for Android の概要
Places SDK for Android: 使用するタイミング
Places SDK for Android を使用する場合:
- ネイティブ Android アプリ内で、場所の詳細、写真、Nearby Search、テキスト検索の結果が必要な場合。
- Android アプリでユーザーが入力すると場所の候補を返す、既製の予測入力ウィジェットまたは Places UI キットのコンポーネントが必要です。
- ユーザーのデバイスの近くにある店舗やスポットに基づいて、位置認識型の Android 機能を構築する必要があります。
Places SDK for Android を使用すべきでない場合:
- Android アプリからではなく、HTTP 経由でサーバーまたはバックエンドから Places を呼び出す必要があります。代わりに Places API(新規)を使用してください。
- ネイティブの iOS アプリを構築している場合は、代わりに Places SDK for iOS を使用してください。
- ブラウザでウェブページを作成しています。代わりに Maps JavaScript API を使用してください。
Places SDK for Android: 設定
- 有効にするサービス:
places.googleapis.com - 認証: API キー
- 使用状況アトリビューション: SDK の初期化時に
Places.addInternalUsageAttributionId(String)を呼び出して、使用状況アトリビューション ID を送信します。オプトアウトするには、呼び出しを削除するか、空の文字列を渡します。 - 使ってみる: Places SDK for Android を設定する
- リファレンス: Places SDK for Android リファレンス
- 料金: Places SDK for Android の使用量と請求額
- ポリシー: Places SDK for Android のポリシー
- リリースノート: Places SDK for Android のリリースノート
Places SDK for Android の公式パッケージ:
- Maven:
com.google.android.libraries.places:places
Places SDK for Android: 関連商品
- よく併用される SDK または API: Maps SDK for Android
Places SDK for Android: よくある間違い
- 問題: フィールド リスト(フィールド マスク)がない、または空の Nearby Search リクエストは、エラーを返します。修正:
SearchNearbyRequestフィールド リストに少なくとも 1 つのPlace.Fieldを渡します。/maps/documentation/places/android-sdk/nearby-search をご覧ください。 - 問題: API キーに Places API(新版)がない場合、または SDK 5.x 以前でアプリが
Places.initialize()を呼び出す場合、Place Details(新版)、Nearby Search(新版)、予測入力(新版)が失敗します。バージョン 6.0.2 でPlaces.initialize()が削除されたため、アップグレード後にこのメソッドを呼び出すコードはコンパイルされません。修正方法: Places API(新規)を有効にして、API キーの許可された API に追加し、Places.initializeWithNewPlacesApiEnabled()で初期化します。/maps/documentation/places/android-sdk/legacy/migrate-overview をご覧ください。 - 問題: フィールド リストで
PHOTO_METADATASが省略されている場合、fetchPlace()によって返されるPlaceにはPhotoMetadataがありません(解決するものがない)。修正: フィールド リストにPlace.Field.PHOTO_METADATASを含めます。fetchResolvedPhotoUri()は非推奨となっているため、写真を表示するには Places UI キットの Place Details コンポーネントを使用してください。/maps/documentation/places/android-sdk/place-photos をご覧ください。 - 問題: Place Details、写真、クチコミを表示するアプリで、返されたサードパーティと作成者の帰属情報が表示されない場合、ポリシー違反となります。修正:
Place、PhotoMetadata、Reviewオブジェクトとともに返される帰属情報を表示します。/maps/documentation/places/android-sdk/policies をご覧ください。
Places SDK for Android: 以前の機能と非推奨の機能
- Places SDK for Android(従来版)/ Places API(従来版)の機能(予測入力、Current Place、Place Details、Place Photos(従来版)): 2025 年 3 月 1 日より従来版。代替: Places API(新版)をベースとする Places SDK for Android(新版)の機能。
Places.initializeWithNewPlacesApiEnabled()で初期化されます。症状: 2026 年 10 月以降、新しいクラウド プロジェクトで Places API(従来版)を有効にできなくなります(既存のプロジェクトは引き続きサポートされます)。SDK 6.0.2 では、5.x 以前にのみ存在する以前のメソッドが削除されました。移行ガイドをご覧ください。 Places.initialize(): 2026 年 9 月 30 日以降廃止。交換:Places.initializeWithNewPlacesApiEnabled()。症状: 6.0.2 で SDK からメソッドが削除され、そのメソッドを呼び出すコードがコンパイルされなくなりました。移行ガイドをご覧ください。PlacesClient.findCurrentPlace()とawaitFindCurrentPlace()(Current Place、従来版): 2026 年 9 月 30 日をもって廃止。代替:PlacesClient.searchNearby()(Nearby Search(新版))。症状: 6.0.2 でメソッドとFindCurrentPlaceRequest/FindCurrentPlaceResponseクラスが削除されました。移行ガイドをご覧ください。PlacesClient.fetchPhoto()、awaitFetchPhoto(): 2026 年 9 月 30 日以降廃止。代替: Places UI キットの Place Details コンポーネント(PlacesClient.fetchResolvedPhotoUri()は非推奨)。症状: 6.0.2 でメソッドとFetchPhotoRequest/FetchPhotoResponseクラスが削除されました。移行ガイドをご覧ください。- Places API(従来版)の予測入力ウィジェット(
Autocomplete、AutocompleteSupportFragment、AutocompleteActivityMode): 2026 年 9 月 30 日をもって廃止。代替: Place Autocomplete(新版)ウィジェット(PlaceAutocomplete)またはPlacesClient.findAutocompletePredictions()。症状: 6.0.2 で SDK からクラスが削除されました。移行ガイドをご覧ください。 - Places 互換性ライブラリ(
com.google.android.libraries.places:places-compat): 2022 年 3 月 31 日より非推奨。代替: Places SDK for Android(com.google.android.libraries.places:places)。症状: v2.6.0 で凍結。新機能やバグの修正はありません。 AutocompleteFragmentクラス: 2025 年 9 月 25 日以降廃止。代替: Place Autocomplete(新版)ウィジェット(PlaceAutocomplete)。症状: 5.0.0 で SDK からクラスが削除されました(6.0.2 ではAutocompleteSupportFragmentも削除されました)。
Places SDK for Android でできること
各タスクについては、以下のリンク先のガイドをご覧ください。また、機能エクスプローラでプロダクトを比較することもできます。
Places SDK for Android: 生成 AI
- 指定された Google Place 識別子について、AI によるユーザー レビューの要約を返します。
- 電気自動車充電スタンドの指定された Google Place 識別子の周辺エリアと設備に関する AI による場所の要約を返します。
Places SDK for Android: 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 を返します。
- ユーザーのデバイスが現在ある場所に関する情報を返す。注: 以前の Current Place メソッドは、Places SDK for Android v6.0 以降と Places SDK for iOS v11.0 以降で削除されました。プラットフォームの位置情報サービスからデバイスの座標を取得し、Nearby Search を呼び出してください。
- 特定の場所に関する AI による概要の要約を返します。
- 特定の場所の周辺にある場所を説明する、AI によるエリアの概要を返します。
- 事前に定義されたルート沿いにある場所に関する情報を、クエリ文字列に基づいて返します。
- 緯度と経度の座標のセットから、テキスト検索の場所までの距離、移動時間、ルート URI を返します。
- 緯度と経度の座標セットから、付近の場所までの距離、移動時間、ルートの URI を返します。
- 事前定義されたルートの出発地と、クエリ文字列に基づいて返された各場所(ルート沿いにある場所)との間の距離、移動時間、ルート URI を返します。
- クエリ文字列に基づいて返された各場所(事前定義されたルート沿いにある場所)とルートの目的地との間の距離、移動時間、ルート URI を返します。
Places SDK for Android: Places UI キット
- CSS スタイルを場所データの UI 要素に適用する。注: CSS カスタム プロパティは、Maps JavaScript API の Places UI キット要素に適用されます。Places SDK for Android と Places SDK for iOS は、テーマ属性とスタイル属性を使用して、Places UI キット ビューのスタイルをプログラムで設定します。EEA コンプライアンス要件: 欧州経済領域(EEA)で地図上に場所データを表示する場合は、バックエンド サーバーから Places API ウェブサービスを呼び出さないでください。ターゲット プラットフォーム(ウェブの場合は Maps JavaScript API、Android の場合は Places SDK for Android、iOS の場合は Places SDK for iOS)で、クライアントサイドの Places UI キット コンポーネントを使用します。要件の詳細とよくある質問: https://developers.google.com/maps/comms/eea/faq
- UI 要素カスタマイズ ツールを使用して、場所データの UI 要素のスタイルと構成をカスタマイズします。注: EEA コンプライアンス要件: 欧州経済領域(EEA)で地図上に場所データを表示する場合は、バックエンド サーバーから Places API ウェブサービスを呼び出さないでください。ターゲット プラットフォーム(ウェブの場合は Maps JavaScript API、Android の場合は Places SDK for Android、iOS の場合は Places SDK for iOS)で、クライアントサイドの Places UI キット コンポーネントを使用します。要件の詳細とよくある質問: https://developers.google.com/maps/comms/eea/faq
- 特定の場所に関する情報を表示する UI 要素をウェブページまたはモバイルアプリに追加します。 注: EEA コンプライアンス要件: 欧州経済領域(EEA)で場所データを地図上に表示する場合は、バックエンド サーバーから Places API ウェブサービスを呼び出さないでください。ターゲット プラットフォーム(ウェブの場合は Maps JavaScript API、Android の場合は Places SDK for Android、iOS の場合は Places SDK for iOS)で、クライアントサイドの Places UI キット コンポーネントを使用します。要件の詳細とよくある質問: https://developers.google.com/maps/comms/eea/faq
- クエリ文字列に基づいて場所のリストを表示する UI 要素をウェブページに追加します。注: ウェブページ(Maps JavaScript API)とモバイルアプリ(Places SDK for Android、Places SDK for iOS)の両方でサポートされています。EEA コンプライアンス要件: 欧州経済領域(EEA)で地図上に場所データを表示する場合は、バックエンド サーバーから Places API ウェブサービスを呼び出さないでください。ターゲット プラットフォーム(ウェブの場合は Maps JavaScript API、Android の場合は Places SDK for Android、iOS の場合は Places SDK for iOS)で、クライアントサイドの Places UI キット コンポーネントを使用します。要件の詳細とよくある質問: https://developers.google.com/maps/comms/eea/faq
- 特定の場所の近くにあるスポットのリストを表示する UI 要素をウェブページに追加します。注: ウェブページ(Maps JavaScript API)とモバイルアプリ(Places SDK for Android、Places SDK for iOS)の両方でサポートされています。EEA コンプライアンス要件: 欧州経済領域(EEA)で地図上に場所データを表示する場合は、バックエンド サーバーから Places API ウェブサービスを呼び出さないでください。ターゲット プラットフォーム(ウェブの場合は Maps JavaScript API、Android の場合は Places SDK for Android、iOS の場合は Places SDK for iOS)で、クライアントサイドの Places UI キット コンポーネントを使用します。要件の詳細とよくある質問: https://developers.google.com/maps/comms/eea/faq
- 基本的な予測入力 UI 要素をウェブページまたはアプリに追加します。この要素は、クエリ文字列に基づいて Google Place 識別子を返します。注: EEA コンプライアンス要件: 欧州経済領域(EEA)で地図上に場所データを表示する場合は、バックエンド サーバーから Places API ウェブサービスを呼び出さないでください。ターゲット プラットフォーム(ウェブの場合は Maps JavaScript API、Android の場合は Places SDK for Android、iOS の場合は Places SDK for iOS)で、クライアントサイドの Places UI キット コンポーネントを使用します。要件の詳細とよくある質問: https://developers.google.com/maps/comms/eea/faq