Places SDK(従来版)の概要

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 に記載されています。