Place Details への移行(新規)

Places SDK for Android は、既存の Place Details をサポートしています。既存の 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 クラスには、アトリビューションと著者アトリビューションも含めることができます。アプリにレビューを表示する場合は、帰属情報または作成者の帰属情報も表示する必要があります。詳細については、レビューを表示するをご覧ください。

詳細については、アトリビューションに関するドキュメントをご覧ください。

地名の言語コードにアクセスする

既存の Place.getName() メソッドは、場所の名前を含むテキスト文字列を返します。Place オブジェクトに場所の名前を入力するには、場所の詳細リクエストのフィールドリストに Place.Field.DISPLAY_NAME を含める必要があります。

これで、Place オブジェクトに名前文字列の言語コードが含まれるようになりました。Place オブジェクトに言語コードを入力するには、次の操作を行う必要があります。

  1. リクエストのフィールドリストに Place.Field.DISPLAY_NAME を含めます。この値は、Place オブジェクトに場所の名前と言語コードの両方を含めるようにレスポンスを構成します。

  2. PlacesClient.fetchPlace() を呼び出します。PlacesClient.findCurrentPlace() は言語コード フィールドをサポートしていません。

  3. Place.getNameLanguageCode() メソッドを使用して、Place オブジェクトの言語コード フィールドにアクセスします。

地域コードを設定する

Places SDK for Android(新規)では、プレイス情報に地域コードのリクエスト パラメータが追加されました。地域コードはレスポンスのフォーマットに使用され、2 文字の CLDR コード値として指定されます。このパラメータは、検索結果にバイアス効果をもたらす可能性があります。デフォルト値はありません。地域コードを設定するには、新しい SDK を有効にする必要があります。

レスポンスの住所フィールドの国名が地域コードと一致する場合、住所から国コードが省略されます。

ほとんどの CLDR コードは ISO 3166-1 コードと同じですが、いくつかの例外があります。たとえば、英国の ccTLD は「uk」(.co.uk)ですが、ISO 3166-1 コードは「gb」(技術的には「グレート ブリテンおよび北アイルランド連合王国」のエンティティ)です。このパラメータは、適用される法律に基づいて結果に影響する可能性があります。

リクエスト例

完全な例については、場所の詳細(新規)をご覧ください。