Places SDK（従来版）の概要

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（新版）での開発効率を向上させます。

パフォーマンスの向上

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 に含まれています。