索引
LatLng
(訊息)PostalAddress
(訊息)
LatLng
代表經緯度組合的物件。以一對雙精準數表示經度度數和緯度度數。除非另有指定,否則這個物件必須符合 WGS84 標準。此外,值必須在正規化範圍內。
欄位 | |
---|---|
latitude |
緯度度數,必須介於 [-90.0, +90.0] 的範圍之間。 |
longitude |
經度度數,必須介於 [-180.0, +180.0] 的範圍之間。 |
PostalAddress
表示郵寄地址,如郵政快遞或付款地址。如果是郵寄地址,郵政服務可將貨品寄送到場所、郵政信箱或類似位置。此表示法並不適用於建立地理位置 (街道、鄉鎮或山區) 的模型。
在一般使用情況下,系統會根據處理作業的類型,以使用者輸入或匯入現有資料的方式來建立地址。
地址輸入/編輯的建議:- 使用國際化地址小工具 (例如 https://github.com/google/libaddressinput):在使用該欄位的國家/地區之外,不應向使用者顯示 UI 元素來輸入或編輯欄位。
如要進一步瞭解如何使用這個結構定義,請參閱:https://support.google.com/business/answer/6397478
欄位 | |
---|---|
revision |
|
region_code |
選用設定。地址所在國家/地區的 CLDR 地區代碼。詳情請參閱 https://cldr.unicode.org/ 和 https://www.unicode.org/cldr/charts/30/supplemental/territory_information.html。例如:瑞士的名稱為「CH」。如未提供區碼,則系統將從地址推斷。為獲得最佳成效,建議您加入區碼 (如果知道的話)。區域不一致或重複可能會導致效能不佳,舉例來說,如果 |
language_code |
輸入地址中的語言代碼保留供日後使用,今天會忽略此。API 會以適合地址所在地的適當語言傳回地址。 |
postal_code |
選用設定。地址的郵遞區號。並非所有國家/地區都使用郵遞區號或要求必須填寫郵遞區號,不過在使用郵遞區號時,可能會對地址其他部分觸發額外的驗證作業 (例如美國對州/郵遞區號的驗證)。 |
sorting_code |
選用設定。國家/地區專屬的其他分類代碼。大多數國家/地區並不使用這個代碼。在使用分類代碼的國家/地區中,這個值為與「CEDEX」相似的字串,後面選擇性加上一個數字 (例如「CEDEX 7」),或是只有單一數字,並用來表示「區段代碼」(牙買加)、「寄送區域指示碼」(馬拉威) 或「郵局指示碼」(如象牙海岸)。 |
administrative_area |
選用設定。最高行政區,用於國家/地區的郵遞地址。例如,此值可以是州、省或縣。以西班牙為例來具體說明,此欄位的值為省,而非自治區 (例如「巴塞隆納」省,而不是「加泰隆尼亞」自治區)。許多國家/地區的郵寄地址並沒有使用行政區。例如,就瑞士而言,該欄位應該留空不填。 |
locality |
選用設定。一般是指地址的縣市/鄉鎮部分。例如:美國城市、義大利市鎮、英國郵鎮。如為未明確定義縣市或其縣市不適用此結構的地區,請將 locality 留白,改用 address_lines。 |
sublocality |
選用設定。地址的縣市以下行政區,例如社區、自治市鎮和區等。 |
address_lines[] |
必要欄位。非結構化的地址行,說明地址的低層級項目。 |
recipients[] |
請避免設定這個欄位。Address Validation API 目前並未使用。雖然 API 目前不會拒絕已設定這個欄位的要求,但會捨棄資訊,也不會在回應中傳回相關資訊。 |
organization |
請避免設定這個欄位。Address Validation API 目前並未使用。雖然 API 目前不會拒絕已設定這個欄位的要求,但會捨棄資訊,也不會在回應中傳回相關資訊。 |