Places SDK for Android は、場所の詳細(以前のバージョン)をサポートしています。Places SDK for Android(レガシー)をご利用の場合、Place 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
クラスには、帰属情報と著者の帰属情報を含めることもできます。アプリにレビューを表示する場合は、帰属情報または著作者の帰属情報も表示する必要があります。詳しくは、レビューを表示するをご覧ください。
詳細については、アトリビューションに関するドキュメントをご覧ください。
場所の名前の言語コードにアクセスする
Places SDK for Android(レガシー)では、Place.getName()
メソッドは場所の名前を含むテキスト文字列を返します。Place
オブジェクトに場所の名前を入力するには、場所の詳細リクエストのフィールド リストに 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(New)をご覧ください。