Places SDK for Android クイック リファレンス

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 SDK for Android の公式パッケージ:

  • Maven: com.google.android.libraries.places:places

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

Places SDK for Android: Places

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