Geocoder

Geocoder 類別

google.maps.Geocoder 類別

用於在地址和 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
要進行地理編碼的地址。必須提供一項,且只能擇一提供 addresslocationplaceId 其中之一。
bounds optional
類型:  LatLngBounds|LatLngBoundsLiteral optional
要搜尋時使用的 LatLngBounds。選用。
componentRestrictions optional
類型:  GeocoderComponentRestrictions optional
元件可用來將結果限制在特定區域。篩選器包含一或多個:routelocalityadministrativeAreapostalCodecountry。系統只會傳回符合所有篩選器的結果。篩選器值與其他地理編碼要求一樣,支援相同的拼字校正及部分比對方法。選用。
language optional
類型:  string optional
結果傳回該語言的語言 ID (可能的話)。請參閱支援語言清單
location optional
類型:  LatLng|LatLngLiteral optional
要搜尋的 LatLng (或 LatLngLiteral)。地理編碼器會執行反向地理編碼。詳情請參閱 反向地理編碼。必須提供一項,且只能擇一提供 addresslocationplaceId 其中之一。
placeId optional
類型:  string optional
與地點相關聯的地點 ID。地點 ID 可以用來辨識 Google 地點介面集資料庫和 Google 地圖中的特定地點。請參閱 Places API 開發人員指南,進一步瞭解地點 ID。地理編碼器會執行反向地理編碼。詳情請參閱反向地理編碼。必須提供一項,且只能擇一提供 addresslocationplaceId 其中之一。
region optional
類型:  string optional
用於自訂調整搜尋的國家/地區代碼,以雙字元 (非數字) Unicode 區域子標記/CLDR 識別碼指定。選用設定。如要瞭解支援的區域,請參閱 Google 地圖平台涵蓋範圍詳細資料

GeocoderComponentRestrictions 介面

google.maps.GeocoderComponentRestrictions 介面

GeocoderComponentRestrictions 代表一組會解析為特定區域的篩選器。若要進一步瞭解相關運作方式,請參閱「 地理編碼元件篩選」一文。

administrativeArea optional
類型:  string optional
符合所有 administrative_area levels。選用。
country optional
類型:  string optional
比對國家/地區名稱或雙字母 ISO 3166-1 國家/地區代碼。選用。
locality optional
類型:  string optional
比對 localitysublocality 類型。選用。
postalCode optional
類型:  string optional
符合 postal_codepostal_code_prefix。選用。
route optional
類型:  string optional
比對 route 的長或簡稱。選用。

GeocoderStatus 常數

google.maps.GeocoderStatus 常數

呼叫 geocode() 完成後,由 Geocoder 傳回的狀態。您可以採用值或常數名稱來指定這些參數。例如 '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 清單。

GeocoderResult 介面

google.maps.GeocoderResult 介面

擷取自地理編碼伺服器的單一 Geocoder 結果。地理編碼要求可能會傳回多個結果物件。請注意,雖然這個結果很類似 JSON,但因其間接包含 LatLng 物件,所以不算是 JSON。

address_components
GeocoderAddressComponent 的陣列
formatted_address
類型:  string
包含這個位置人類可讀地址的字串。
geometry
類型:  GeocoderGeometry
GeocoderGeometry 物件
place_id
類型:  string
與地點相關聯的地點 ID。地點 ID 可以用來辨識 Google 地點介面集資料庫和 Google 地圖中的特定地點。請參閱 Places API 開發人員指南,進一步瞭解地點 ID
types
類型:  Array<string>
註明傳回地理編碼元素類型的字串陣列。如要查看可能的字串清單,請參閱開發人員指南的「 地址元件類型」一節。
partial_match optional
類型:  boolean optional
指出地理編碼器是否沒有傳回與原始要求完全相符的結果,但可以比對部分要求的地址。如果完全相符,則值會是 undefined
plus_code optional
類型:  PlacePlusCode optional
與位置相關的 Plus Code。
postcode_localities optional
類型:  Array<string> optional
字串陣列,表示郵遞區號內含的所有縣市。系統只會在所傳回結果是包含多個位置的郵遞區號時,才會顯示這個陣列。

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 傳回的結果反映精確的地理編碼。