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