Places SDK for Android(以前のバージョン)の概要

このガイドでは、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 クラスが追加されました。The Place クラスには、このフィールドをサポートする新しい getReviews() メソッドが含まれています。getReviews() を呼び出して、場所のクチコミを最大 5 件返します。

  • Place Photos(新版) では、 AuthorAttributions が PhotoMetadata クラスに追加されます。AuthorAttributions には、List の AuthorAttribution オブジェクトが含まれています。

Place Photos(新版)に追加された新しい URI レスポンス

Place Photos(新版) を使用して、画像ビットマップの URI を返すことができるようになりました。以前は、画像ビットマップ自体しか返せませんでした。

シンプルな料金体系

Places SDK for Android(新版)では、使用したデータに対してのみ料金が発生するように、料金体系が簡素化されています。シンプルな料金体系は、フィールド リスト(フィールド マスクとも呼ばれます)を使用して実装されます。

Place Details(新版)とテキスト検索(新版)では、フィールド リストを使用して、レスポンスで返すフィールドのリストを制御します。リクエストされたデータに対してのみ課金されます。フィールド リストを使用することは、不要なデータをリクエストしないようにするための優れた設計手法です。これにより、不要な処理時間や課金が発生するのを防ぐことができます。

料金の詳細については、使用量と 課金をご覧ください。

拡張された場所タイプ

新しい SDK には、Place Details(新版)とテキスト検索(新版)のレスポンスの一部として返される新しい場所タイプが含まれています。これらの新しいタイプと既存のタイプは、テキスト検索(新版)を使用した検索でも使用できます。新しいタイプは表 Aに記載されています。