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