Places SDK を使用すると、テキスト文字列または近接性に基づいて、さまざまな場所タイプの情報を検索して取得できます。Places SDK は、Places SDK(新規)の以前のバージョンです。
このガイドでは、Places SDK のバージョン間の主な違いと、Places SDK(新規)への移行について説明します。
各バージョンで利用できる SDK 機能
次の表に、各 SDK 機能に必要な SDK と API のバージョンを示します。
機能 | API キーで Places API が有効になっている | 初期化方法 | 最小 SDK バージョン |
---|---|---|---|
Autocomplete(新規) | Places API(新規) | initializeWithNewPlacesApiEnabled() |
3.5.0 |
Place Details(新規) | Places API(新規) | initializeWithNewPlacesApiEnabled() |
3.3.0 |
Nearby Search(新規) | Places API(新規) | initializeWithNewPlacesApiEnabled() |
3.5.0 |
Place Photo(新規) | Places API(新規) | initializeWithNewPlacesApiEnabled() |
3.4.0 |
テキスト検索(新規) | Places API(新規) | initializeWithNewPlacesApiEnabled() |
3.3.0 |
Place Autocomplete | Places API | initialize() |
|
Current Place | Places API | initialize() |
|
Place Details | Places API | initialize() |
|
Place Photos | Places API | initialize() |
新しい API に移行する
新しい API に移行するには、次の移行ガイドをご覧ください。
Places SDK for Android の機能強化(新規)
このセクションでは、Places SDK for Android(新規)に追加された主な機能について説明します。
Google Cloud 標準プラットフォームに実装されている
Android 向け Places SDK(新規)は、Google Cloud のサービス インフラストラクチャに実装されています。この実装により、より安全で信頼性の高いプラットフォームが実現します。この標準設計により、SDK 全体に一貫性がもたらされ、Places SDK for Android(新規)での開発効率が向上します。
パフォーマンスの向上
Places SDK for Android(新規)はパフォーマンスが向上しているため、既存の SDK を使用するアプリを置き換える価値があります。
新機能
Places SDK for Android(新規)には、次のすべての SDK 機能の最新バージョンが含まれています。
新しいテキスト検索サービス
テキスト検索(新版)は、「渋谷 ピザショップ」「表参道 靴店」「123 番地」といった文字列に対して、場所のセットについての情報を返します。テキスト文字列と、その時点で設定済みの地域バイアスをもとに、場所のリストを返すサービスです。
Place Details(新版)と Place Photos(新版)に新しいレスポンス データが追加されました
Place Details(新版)のレスポンス
Place
オブジェクトに、新しい Review クラスが追加されました。Place クラスには、このフィールドをサポートする新しいgetReviews()
メソッドが含まれています。getReviews()
を呼び出して、場所に関するクチコミを最大 5 件返します。Place Photo(新規):
PhotoMetadata
クラスにAuthorAttributions
が追加されました。AuthorAttributions
には、AuthorAttribution
オブジェクトのList
が含まれています。
Place Photo(新規)に新しい URI レスポンスが追加されました
Place Photo(新規)を使用して、画像ビットマップの URI を返せるようになりました。これまでは、画像ビットマップ自体のみを返すことができました。
シンプルな料金体系
Places SDK for Android(新規)では料金設定が簡素化され、使用するデータに対してのみ料金が発生します。簡素化された料金は、フィールドリスト(フィールド マスク)を使用して実装されます。
Place Details と Text Search では、フィールドリストを使用して、レスポンスで返されるフィールドのリストを制御します。リクエストされたデータに対してのみ課金されます。フィールドリストを使用することは、不要なデータをリクエストしないようにするための優れた設計手法です。これにより、不要な処理時間と請求料金を回避できます。
両方の SDK の料金の詳細については、使用量と課金をご覧ください。
拡張されたプレイスタイプ
新しい SDK には、Place Details とテキスト検索のレスポンスの一部として返される新しい場所タイプが含まれています。これらの新しいタイプと既存のタイプは、Text Search での検索でも使用できます。新しいタイプは 表 A に記載されています。