遷移至 Place Details (新推出)

Android 版 Places SDK 支援現有的 地點詳細資料。如果您熟悉現有的 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 以上版本新增的新類型。

存取地點評論

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

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

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

存取地點名稱語言代碼

現有的 Place.getName() 方法會傳回包含地點名稱的文字字串。如要為 Place 物件填入地點名稱,您必須在 PlaceDetails 要求的欄位清單中加入 Place.Field.DISPLAY_NAME

Place 物件現在包含名稱字串的語言代碼。如要為 Place 物件填入語言代碼,您必須:

  1. 在要求的欄位清單中加入 Place.Field.DISPLAY_NAME。這個值會將回應設為在 Place 物件中加入地點名稱和語言代碼。

  2. 呼叫 PlacesClient.fetchPlace()PlacesClient.findCurrentPlace() 不支援語言代碼欄位。

  3. 使用 Place.getNameLanguageCode() 方法存取 Place 物件中的語言代碼欄位。

設定區域代碼

Android 版 Places SDK (新版) 會在 Place Details 中新增區域代碼要求參數。區域代碼用於設定回應格式,並指定為 兩個字元的 CLDR 代碼值。這個參數也會對搜尋結果產生偏差效果。沒有預設值。您必須啟用新的 SDK 才能設定區域代碼。

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

大多數 CLDR 代碼與 ISO 3166-1 代碼相同,但有些例外狀況。舉例來說,英國的 ccTLD 是「uk」(.co.uk),而 ISO 3166-1 代碼則是「gb」(技術上是「The United Kingdom of Great Britain and Northern Ireland」實體)。這個參數可能會影響適用法律的結果。

要求範例

如需完整範例,請參閱「地點詳細資料 (新版)」。