Places SDK for Android は、既存の Place Details をサポートしています。既存の Places SDK for Android に精通している場合、Places Details の新しいバージョンでは次の変更が加えられています。
新しい料金モデルを使用します。すべての API の料金については、 Places SDK for Android（新規）をご覧ください。
Places.initializeWithNewPlacesApiEnabled()メソッドを呼び出してアプリを初期化する必要があります。Places API サービスの選択の詳細については、Google Cloud プロジェクトを設定するをご覧ください。フィールドのマスキングは必須です。レスポンスで返すフィールドを指定する必要があります。返されるフィールドのデフォルト リストはありません。このリストを省略すると、メソッドはエラーを返します。
以降のセクションでは、その他の変更について説明します。
新しい場所のタイプにアクセスする
各場所には、1 つ以上のタイプ値を関連付けることができます。Android 版 Places SDK バージョン 3.3.0 以降では、多くの新しい型値が追加されています。完全なリストについては、拡張された場所の種類をご覧ください。
Place.getPlaceTypes() メソッドは、型値を文字列値のリストとして返します。返される値は、使用している Places SDK for Android のバージョンによって異なります。
Places SDK for Android（新規）: 場所の種類（新規）に示す表 A と表 B で定義された文字列を返します。バージョン 3.3.0 で追加されたすべての場所の種類が含まれます。
Places SDK for Android:
Place.Typesで定義された列挙型を返します。バージョン 3.3.0 以降で追加された新しい型は含まれません。
場所のレビューにアクセスする
Places SDK for Android（新規）には、場所のクチコミを含む Review クラスが追加されています。Place オブジェクトには最大 5 つのクチコミを含めることができます。
Review クラスには、アトリビューションと著者アトリビューションも含めることができます。アプリにクチコミを表示する場合は、帰属情報または著作者の帰属情報も表示する必要があります。詳細については、レビューを表示するをご覧ください。
詳細については、アトリビューションに関するドキュメントをご覧ください。
地名の言語コードにアクセスする
既存の Place.getName() メソッドは、場所の名前を含むテキスト文字列を返します。Place オブジェクトに場所の名前を入力するには、Place Details リクエストのフィールドリストに Place.Field.DISPLAY_NAME を含める必要があります。
Place オブジェクトに、名前文字列の言語コードが含まれています。Place オブジェクトに言語コードを入力するには、次の操作を行う必要があります。
リクエストのフィールドリストに
Place.Field.DISPLAY_NAMEを含めます。この値は、Placeオブジェクトに場所の名前と言語コードの両方を含めるようにレスポンスを構成します。PlacesClient.fetchPlace()を呼び出します。PlacesClient.findCurrentPlace()は言語コード フィールドをサポートしていません。Place.getNameLanguageCode()メソッドを使用して、Placeオブジェクトの言語コード フィールドにアクセスします。
地域コードを設定する
Places SDK for Android（新版）では、Place Details に地域コードのリクエスト パラメータが追加されました。地域コードはレスポンスのフォーマットに使用され、2 文字の CLDR コード値として指定します。このパラメータは、検索結果にバイアス効果をもたらす可能性があります。デフォルト値はありません。リージョン コードを設定するには、新しい SDK を有効にする必要があります。
レスポンスの住所フィールドの国名が地域コードと一致する場合、住所から国コードが省略されます。
ほとんどの CLDR コードは ISO 3166-1 コードと同一ですが、いくつか注意が必要な例外もあります。たとえば、英国の ccTLD は「uk」（.co.uk）ですが、ISO 3166-1 コードは「gb」（技術的には「英国（グレートブリテンおよび北アイルランド連合王国）」のエンティティ）です。このパラメータは、適用される法律に基づいて結果に影響する可能性があります。
リクエスト例
完全な例については、Place Details（新規）をご覧ください。