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 クラスが含まれるようになりました。Place クラスには、このフィールドをサポートする新しい getReviews() メソッドが含まれています。getReviews() を呼び出して、場所のレビューを最大 5 件返します。

  • Place Photos (New) は、PhotoMetadata クラスに AuthorAttributions を追加します。AuthorAttributions には、AuthorAttribution オブジェクトの List が含まれます。

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

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

シンプルな料金体系

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

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

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

拡張された場所タイプ

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