遷移至 Place Details (新推出)

Places SDK for Android 支援現有的 Place Details。如果您熟悉現有的 Places SDK for Android,新版 Place Details 會進行以下變更:

以下各節將說明其他變更。

存取新的地點類型

每個地點都可能與一或多個類型值相關聯。Android 版 Places SDK 3.3.0 以上版本新增許多類型值。如需完整清單,請參閱「擴充地點類型」。

Place.getPlaceTypes() 方法會傳回類型值,做為字串值清單。傳回的值取決於您使用的 Places SDK for Android 版本:

  • Places SDK for Android (新版):傳回「Place Types (新版)」中顯示的「Table A」和「Table B」所定義的字串,包括在 3.3.0 版中新增的所有地點類型。

  • Places SDK for Android:傳回 Place.Types 定義的列舉,但不包含 3.3.0 以上版本新增的新類型。

存取地點評論

Places SDK for Android (新版) 新增了 Review 類別,其中包含地點的評論。Place 物件最多可包含五則評論。

Review 類別也可以包含出處註明和作者出處註明。如果您在應用程式中顯示評論,則必須一併顯示任何出處資訊或作者出處資訊。詳情請參閱「顯示評論」。

詳情請參閱歸因說明文件。

存取地點名稱語言代碼

現有的 Place.getName() 方法會傳回包含地點名稱的文字字串。如要使用地點名稱填入 Place 物件,您必須在 Place Details 要求的欄位清單中加入 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 (新版) 會將區域代碼要求參數新增至 Place Details。區域代碼用於設定回應格式,並指定為 兩位數 CLDR 代碼值。這個參數也會對搜尋結果產生偏差效果。沒有預設值。您必須啟用新 SDK 才能設定區域代碼。

如果回應中的地址欄位國家/地區名稱與區域代碼相符,系統就會從地址中省略國家/地區代碼。

大多數 CLDR 代碼與 ISO 3166-1 代碼相同,但有一些例外情況。舉例來說,英國的 ccTLD 是「uk」(.co.uk),而 ISO 3166-1 代碼則是「gb」(技術上代表「大不列顛與北愛爾蘭聯合王國」實體)。這個參數可能會影響適用法律的結果。

要求範例

如需完整範例,請參閱「Place Details (新版)」。