アプリで使用できる Places SDK for Android の機能は次のとおりです。 SDK のバージョン番号（3.5.0 など）と API キーで有効にする API、API 呼び出しを アプリを初期化します。このガイドでは、バージョンとバージョンの違いについて説明します。 アプリで有効にするバージョンを選択する方法。
SDK バージョン番号
アプリレベルの build.gradle に指定する SDK のバージョン番号 ファイルによって、追加された機能にアプリがアクセスできるかどうかが決まります 確認します。たとえば、予測入力（新）は SDK でのみ利用可能です バージョン 3.5.0 以降が必要です。
各 SDK バージョンでの変更点について詳しくは、プレイスに関するページ SDK for Android のリリース メモをご覧ください。
Places SDK for Android の Places API バージョン
SDK のバージョン番号を指定するほか、プレイス オプションも選択する必要があります。 SDK が Google Cloud コンソールで呼び出す API サービス。Places API または Places API（新規）。SDK のバージョン番号とともに、使用する API サービスは [選択] では、アプリで利用できる特定の機能のバージョンを指定します。 予測入力や予測入力（新版）などの 追加機能を提供しています指定できる SDK は 1 つのみですが、 で、Places API と Places API（新版）の両方を SDK が呼び出すサービスを選択します。 アプリで SDK の初期化に使用するメソッドを指定します。ただしほとんどの場合 Places API（新）を有効にして、（新）バージョンの Places API を 実装する方法を学びました
SDK バージョンと API サービスを選択する
アプリで使用できる SDK の機能を選択するには、次の手順を行います。
- Google Cloud プロジェクトで、Places API、Places API（新版）、または あります。詳細については、 API
- [API キー制限] で、Places API、Places API（新版）、または あります。詳細については、API の制限 あります。
アプリレベルの build.gradle ファイルで、バージョン番号を指定します。詳細情報 詳しくは、 インストール。
または
Places.initializeWithNewPlacesApiEnabled()またはPlaces.initialize()メソッドを呼び出します。
Places API サービスの選択について詳しくは、 Google Cloud プロジェクト。
各バージョンで使用できる SDK の機能
次の表に、各 SDK に必要な SDK と API のバージョンを示します。 feature:
| 機能 | 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() |
有効にするバージョンを選択する際の考慮事項
どのバージョンを選択するかを決定する際は、次の点を考慮してください。
- Places SDK for Android を初めて利用するお客様については、 次に、Places API（新版）と新しい SDK について説明します。
- 既存のお客様の場合は、引き続き既存の SDK をご利用いただけます。 ただし、パフォーマンスの向上と Cloud Logging の機能を 機能強化を行いましたので、新しい Places SDK for Android（新版）を できます。新しい SDK に移行する場合、移行の必要はありません。 SDK バージョンと API を選択する手順 サービス。
- Places SDK for Android（新版）では、セッション トークンを バージョン 3.5.0 では更新されません。詳しくは、セッション トークン。
- Place Autocomplete ウィジェットを使用して行われる呼び出しでは、常に Place Autocomplete を使用し、 Place Autocomplete（新版）影響を受けないため、 初期化メソッドを使用します。
- Place Photos（新規） はビットマップ画像の URI のみを返しますが、 フォトはビットマップのみを返す 説明します。
- 現在の場所: Places SDK for Android でのみ利用可能。Places SDK for Android では利用できない （新規）。
Places SDK for Android の機能強化（新規）
このセクションでは、Places SDK for Android（新規）に追加された主な機能について説明します。
Google Cloud の標準プラットフォームに実装
Places SDK for Android（新版）がサービスに実装されます。 インフラストラクチャ 説明しますこの実装により、より安全で信頼性の高いプラットフォームが実現します。 この標準的な設計により、SDK 間である程度の一貫性が保たれ、 Places SDK for Android で開発を効率化 （新規）。
パフォーマンスの向上
Places SDK for Android（新版）はパフォーマンスを向上させ、 既存の SDK を使用しているアプリを置き換える価値があります。
新機能
Places SDK for Android（新版）には、すべての SDK の最新バージョンが含まれている 機能:
新しいテキスト検索サービス
テキスト検索（新版）で情報が返される 「渋谷 ピザショップ」のように、文字列に基づいて場所のセットについて検索または 「東京近郊の靴屋」「123 Main Street」など）。サービスがリストを返します。 テキスト文字列と、設定されている場所のバイアスに一致する場所の数。
Placed Details（新版）と Place Photos（新版）に新しいレスポンス データを追加
Place Details （新規）に レビュー レスポンスの
Placeオブジェクト。「 Place クラス には、このフィールドをサポートする新しいgetReviews()メソッドが含まれています。発信getReviews(): 場所について最大 5 件のクチコミを返します。Place Photo （新規）は
AuthorAttributionsPhotoMetadataクラスに渡します。AuthorAttributionsには、次のListが含まれるAuthorAttribution説明します。
新しい URI レスポンスが Place Photos に追加されました（New）
このたび、 Place Photo （新規）画像ビットマップの URI を返します。これまでは、 作成します。
シンプルな料金体系
Places SDK for Android（新版）を使用すると、料金体系がシンプルになり、 使用した分の料金のみが請求されます。簡素化された料金設定は、フィールド リストを使用して実装されます。 フィールド マスクとも呼ばれます。
Place Details と Text Search では、フィールド リストを使用して、 レスポンスで返すことができます。その場合、課金対象はデータに対してのみ 渡されます。フィールド リストの使用は、 リクエストできるため、不要な処理時間を回避し、 請求料金を管理できます。
両方の SDK の詳細な料金情報については、使用量と お支払い。
拡張された場所のタイプ
新しい SDK では、次の表に示す場所タイプが追加されています。これらの型は、 Place Details の一部として返されます。 Text Search レスポンス。これらの新しいタイプを使用することもできます テキスト検索を使用した検索で返されます。 新しいタイプは、表 A.
| タイプ | |||
|---|---|---|---|
| american_restaurant | discount_store | ice_cream_shop | sandwich_shop |
| amusement_center | dog_park | indian_restaurant | school_district |
| athletic_field | electric_vehicle_charging_station | indonesian_restaurant | seafood_restaurant |
| auto_parts_store | event_venue | italian_restaurant | ski_resort |
| banquet_hall | extended_stay_hotel | japanese_restaurant | spanish_restaurant |
| barbecue_restaurant | farm | korean_restaurant | sporting_goods_store |
| barber_shop | ファームステイ | lebanese_restaurant | sports_club |
| bed_and_breakfast | fast_food_restaurant | Marina | sports_complex |
| brazilian_restaurant | ferry_terminal | 短縮 | steak_house |
| breakfast_restaurant | fitness_center | medical_lab | sushi_restaurant |
| brunch_restaurant | french_restaurant | mediterranean_restaurant | swimming_pool |
| bus_stop | gift_shop | mexican_restaurant | 仕立てる |
| camping_cabin | golf_course | middle_eastern_restaurant | telecommunications_service_provider |
| cell_phone_store | greek_restaurant | モーテル | thai_restaurant |
| child_care_agency | grocery_store | national_park | transit_depot |
| chinese_restaurant | guest_house | park_and_ride | truck_stop |
| coffee_shop | hair_salon | performing_arts_theater | turkish_restaurant |
| community_center | hamburger_restaurant | pizza_restaurant | vegan_restaurant |
| コンサルタント | ヘリポート | 遊び場 | vegetarian_restaurant |
| convention_center | hiking_area | 未就学児向け | vietnamese_restaurant |
| コテージ | historical_landmark | private_guest_room | visitor_center |
| courier_service | home_improvement_store | ramen_restaurant | wedding_venue |
| cultural_center | ホステル | resort_hotel | 卸売業者 |
| dental_clinic | ホテル | rest_stop |
これらの新しいタイプとともに、Places API（新版）では次のタイプを移動しました。 を Places API の表 2 から Places API（新版）の表 A に変更します。 つまり、これらの型を search:
countryadministrative_area_level_1administrative_area_level_2postal_codelocality