Geocoder

Geocoder 類別

google.maps.Geocoder class

用於在地址和 LatLng 之間轉換的服務。

請呼叫 const {Geocoder} = await google.maps.importLibrary("geocoding") 存取。請參閱「Maps JavaScript API 中的程式庫」。
Geocoder
Geocoder()
參數：無
建立 Geocoder 的新例項，該例項會將地理編碼要求傳送至 Google 伺服器。
geocode
geocode(request[, callback])
參數： 
傳回值：  Promise<GeocoderResponse>
進行要求的地理編碼。

GeocoderRequest 介面

google.maps.GeocoderRequest 介面

要傳送至 Geocoder 的地理編碼要求規格。
address optional
類型：  string optional
要進行地理編碼的地址。必須提供 address、location 和 placeId 其中一個，且只能提供一個。
bounds optional
類型：  LatLngBounds|LatLngBoundsLiteral optional
LatLngBounds 內搜尋。選填。
componentRestrictions optional
類型：  GeocoderComponentRestrictions optional
元件可用於將結果限制在特定區域。篩選器包含下列一或多個項目：route、locality、administrativeArea、postalCode、country。系統只會傳回符合所有篩選器的結果。篩選器值與其他地理編碼要求一樣，支援相同的拼字校正及部分比對方法。選填。
BetaextraComputations optional
類型：  Array<ExtraGeocodeComputation> optional
可用來完成要求的額外運算清單。注意：這些額外運算可能會在回應中傳回額外欄位。
fulfillOnZeroResults optional
類型：  boolean optional
在回應中使用 ZERO_RESULT 狀態履行承諾。這是因為即使地理編碼結果為零，系統仍可能會傳回其他回應層級欄位。
language optional
類型：  string optional
語言 ID，用於指定應傳回結果的語言 (如有可能)。請參閱支援語言清單。
location optional
類型：  LatLng|LatLngLiteral optional
LatLng (或 LatLngLiteral) 的搜尋值。地理編碼器會執行反向地理編碼。詳情請參閱「 反向地理編碼」。必須提供 address、location 和 placeId 其中一個，且只能提供一個。
placeId optional
類型：  string optional
與位置相關聯的地點 ID。地點 ID 可以用來辨識 Google 地點介面集資料庫和 Google 地圖中的特定地點。如要進一步瞭解 Place ID，請參閱 Places API 開發人員指南。地理編碼器會執行反向地理編碼。詳情請參閱「反向地理編碼」。必須提供 address、location 和 placeId 其中一個，且只能提供一個。
region optional
類型：  string optional
用於偏向搜尋的國家/地區代碼，指定為兩位字元 (非數字) 萬國碼 (Unicode) 區域子標記/CLDR ID。選用設定。如需支援區域的相關資訊，請參閱 Google 地圖平台涵蓋範圍詳細資料。

GeocoderComponentRestrictions 介面

google.maps.GeocoderComponentRestrictions 介面

GeocoderComponentRestrictions 代表一組可解析為特定區域的篩選器。如要進一步瞭解運作方式，請參閱「 地理編碼元件篩選功能」。
administrativeArea optional
類型：  string optional
比對所有 administrative_area levels。選填。
country optional
類型：  string optional
比對國家/地區名稱或雙字母 ISO 3166-1 國家/地區代碼。選填。
locality optional
類型：  string optional
可比對 locality 和 sublocality 類型。選填。
postalCode optional
類型：  string optional
與 postal_code 和 postal_code_prefix 相符。選填。
route optional
類型：  string optional
比對 route 的全名或簡稱。選填。

ExtraGeocodeComputation 常數

google.maps.ExtraGeocodeComputation 常數

完成地理編碼要求時要執行的額外運算。

請呼叫 const {ExtraGeocodeComputation} = await google.maps.importLibrary("geocoding") 存取。請參閱「Maps JavaScript API 中的程式庫」。
ADDRESS_DESCRIPTORS 產生位址描述元。

GeocoderStatus 常數

google.maps.GeocoderStatus 常數

Geocoder 在完成對 geocode() 的呼叫時傳回的狀態。您可以使用值或常數名稱來指定這些值。例如 'OK' 或 google.maps.GeocoderStatus.OK。

請呼叫 const {GeocoderStatus} = await google.maps.importLibrary("geocoding") 存取。請參閱「Maps JavaScript API 中的程式庫」。
ERROR 與 Google 伺服器連線時發生問題。
INVALID_REQUEST 這個 GeocoderRequest 無效。
OK 回應包含有效的 GeocoderResponse。
OVER_QUERY_LIMIT 網頁已在過短的時間內超過要求限制。
REQUEST_DENIED 不允許這個網頁使用 Geocoder。
UNKNOWN_ERROR 伺服器發生錯誤，因此無法處理地理編碼要求。如果您再試一次，該要求可能會成功。
ZERO_RESULTS 找不到與這個 GeocoderRequest 相符的結果。

GeocoderResponse 介面

google.maps.GeocoderResponse 介面

Geocoder 傳回的地理編碼器回應，其中包含 GeocoderResult 清單。
results
類型：  Array<GeocoderResult>
GeocoderResult 清單。
Betaaddress_descriptor optional
類型：  AddressDescriptor optional
地點的關聯說明。包含一組排名的附近地標，以及包含目標位置的區域。只有在啟用 ExtraGeocodeComputation.ADDRESS_DESCRIPTORS 時，才會針對反向地理編碼要求填入這項屬性。
plus_code optional
類型：  PlacePlusCode optional
與位置相關聯的 Plus Code。

GeocoderResult 介面

google.maps.GeocoderResult 介面

擷取自地理編碼伺服器的單一 Geocoder 結果。地理編碼要求可能會傳回多個結果物件。請注意，雖然這個結果是「類似 JSON」的格式，但並非嚴格 JSON，因為它間接包含 LatLng 物件。
address_components
GeocoderAddressComponent 陣列
formatted_address
類型：  string
包含這個地點的清楚易懂地址的字串。
geometry
類型：  GeocoderGeometry
GeocoderGeometry 物件
place_id
類型：  string
與位置相關聯的地點 ID。地點 ID 可以用來辨識 Google 地點介面集資料庫和 Google 地圖中的特定地點。如要進一步瞭解 Place ID，請參閱 Places API 開發人員指南。
types
類型：  Array<string>
註明傳回地理編碼元素類型的字串陣列。如需可能字串的清單，請參閱開發人員指南的「 地址元件類型」一節。
Betaaddress_descriptor optional
類型：  AddressDescriptor optional
與此地理編碼相關聯的地點的關聯說明。包含一組排名的附近地標，以及包含目標位置的區域。這個欄位只會在啟用 ExtraGeocodeComputation.ADDRESS_DESCRIPTORS 時，針對特定已本地化的地點，填入前向地理編碼和地點 ID 查詢要求的資料。
partial_match optional
類型：  boolean optional
地理編碼器是否未傳回與原始要求完全相符的結果，但可以比對部分要求的地址。如果完全比對成功，值會是 undefined。
plus_code optional
類型：  PlacePlusCode optional
與位置相關聯的 Plus Code。
postcode_localities optional
類型：  Array<string> optional
字串陣列，表示郵遞區號內含的所有縣市。系統只會在所傳回結果是包含多個位置的郵遞區號時，才會顯示這個陣列。

AddressDescriptor 介面

google.maps.AddressDescriptor 介面

地點的關聯說明。包含一組排名的附近地標，以及包含目標位置的區域。
areas
類型：  Array<Area>
包含或相鄰區域的排名清單。最實用 (可辨識且精確) 的區域會排在前面。
landmarks
類型：  Array<Landmark>
附近地標的排名清單。最實用 (可辨識且鄰近) 的地標會排在前面。

GeocoderAddressComponent 介面

google.maps.GeocoderAddressComponent 介面

GeocoderResult 中的單一地址元件。完整的地址可能包含多個地址元件。
long_name
類型：  string
地址元件的全文
short_name
類型：  string
指定地址元件的縮寫文字
types
類型：  Array<string>
字串陣列，表示此地址元件的類型。如要查看有效類型清單，請按這裡

GeocoderGeometry 介面

google.maps.GeocoderGeometry 介面

此 GeocoderResult 的幾何資訊
location
類型：  LatLng
這個結果的緯度/經度座標
location_type
location 中傳回的位置類型
viewport
類型：  LatLngBounds
建議可視區域的邊界，用於顯示此 GeocoderResult
bounds optional
類型：  LatLngBounds optional
此 GeocoderResult 的精確邊界 (如適用)

GeocoderLocationType 常數

google.maps.GeocoderLocationType 常數

說明從地理編碼傳回的位置類型。您可以使用值或常數名稱來指定這些值。例如 'ROOFTOP' 或 google.maps.GeocoderLocationType.ROOFTOP

請呼叫 const {GeocoderLocationType} = await google.maps.importLibrary("geocoding") 存取。請參閱「Maps JavaScript API 中的程式庫」。
APPROXIMATE 傳回的結果是約略的。
GEOMETRIC_CENTER 傳回的結果為一條線 (例如街道) 或多邊形 (區域) 結果的地理中心點。
RANGE_INTERPOLATED 傳回結果反映了插入在兩個精確點 (例如十字路口) 之間的近似值 (通常是在道路上)。如果 Geocoder 無法取得街道地址的精確定點地理編碼，就會傳回插入的結果。
ROOFTOP 傳回的結果反映精確的地理編碼。

地標介面

google.maps.Landmark 介面

代表地址參考點的地點。
display_name
類型：  string
地標的名稱。
display_name_language_code
類型：  string
地標名稱的語言。
place_id
類型：  string
做為地標的基礎設施 Place ID。可用於透過 Place Details 或 Place ID Lookup 解析地標的更多資訊。
spatial_relationship
定義目標位置與地標之間的空間關係。
straight_line_distance_meters
類型：  number
目標位置與地標之間的直線距離。
types
類型：  Array<string>
一或多個值，用來指出傳回結果的類型。詳情請參閱「類型 」。
travel_distance_meters optional
類型：  number optional
目標位置和地標之間，沿著道路網路的實際行程距離。如果地標與目標最近的道路網路部分脫節，或是目標位置實際上並未位於道路網路上，則可以不填入這個值。

Area 介面

google.maps.Area 介面

小區域，例如鄰里、次區域或包含目標位置的大型建築群。
containment
類型：  Containment
定義目標位置和區域之間的空間關係。
display_name
類型：  string
區域名稱。
display_name_language_code
類型：  string
區域名稱的語言。
place_id
類型：  string
底層區域的 Place ID。可用於透過 Place Details 或 Place ID Lookup 解析該區域的更多資訊。

包含常數

google.maps.Containment 常數

列舉項目，代表區域與目標位置之間的空間關係。

請呼叫 const {Containment} = await google.maps.importLibrary("geocoding") 存取。請參閱「Maps JavaScript API 中的程式庫」。
NEAR 目標位置不在指定區域內，但距離很近。
OUTSKIRTS 目標位置位於區域內，靠近邊緣。
WITHIN 目標位置位於區域範圍內，靠近中心位置。

SpatialRelationship 常數

google.maps.SpatialRelationship 常數

代表地標和目標之間空間關係的列舉。

請呼叫 const {SpatialRelationship} = await google.maps.importLibrary("geocoding") 存取。請參閱「Maps JavaScript API 中的程式庫」。
ACROSS_THE_ROAD 目標位於道路另一側的路標正對面。
AROUND_THE_CORNER 與地標不在同一條路，但只要轉一個彎就能抵達。
BEHIND 靠近地標建築物結構，但離存取點較遠。
BESIDE 目標位於地標旁邊。
DOWN_THE_ROAD 位於地標所在的路線上，但不位於地標旁邊或對面。
NEAR 如果沒有更具體的下方關係，則預設關係為此。
WITHIN 地標具有空間幾何圖形，且目標位於其範圍內。