Geocoder

Geocoding 類別

google.maps.Geocoder 類別

用來轉換地址和 LatLng 的服務。
Geocoder
Geocoder()
參數：無
建立新的 Geocoder 執行個體，將地理編碼要求傳送至 Google 伺服器。
geocode
geocode(request[, callback])
參數：
傳回值：Promise<GeocoderResponse>
進行要求的地理編碼。

GeocodingRequest 介面

google.maps.GeocoderRequest 介面

要傳送至 Geocoder 的地理編碼要求規格。
address optional
類型：string optional
進行地理編碼的地址。必須提供一個 address、location 和 placeId 中的一個。
bounds optional
要搜尋的LatLngBounds。選用。
componentRestrictions optional
元件可用來將結果限制在特定區域。篩選器包含以下一或多個項目：route、locality、administrativeArea、postalCode、country。系統只會傳回符合所有篩選器的結果。篩選器值與其他地理編碼要求一樣，支援相同的拼字校正及部分比對方法。選用。
">language optional
類型：string optional
如果可以的話，應傳回結果的語言語言識別碼。請參閱支援語言清單。
location optional
類型：LatLng|LatLngLiteral optional
要搜尋的LatLng (或LatLngLiteral)。地理編碼器會執行反向地理編碼。詳情請參閱反向地理編碼。必須提供一個 address、location 和 placeId 中的一個。
placeId optional
類型：string optional
與地點相關聯的地點 ID。地點 ID 可以用來辨識 Google 地點介面集資料庫和 Google 地圖中的特定地點。請參閱 Places API 開發人員指南，進一步瞭解地點 ID。地理編碼器會執行反向地理編碼。詳情請參閱反向地理編碼。必須提供一個 address、location 和 placeId 中的一個。
region optional
類型：string optional
用來縮小搜尋的國家/地區代碼，指定為兩個字元 (非數字) 萬國碼 (Unicode) 區域子標記/CLDR 識別碼。選用，請參閱 Google 地圖平台涵蓋範圍詳細資料，查看支援地區資訊。

GeocodingComponentRestrictions 介面

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 的全名或簡稱。選用。

GeocodingStatus 常數

google.maps.GeocoderStatus 常數

呼叫geocode()後Geocoder傳回的狀態。您可以使用值或透過常數名稱指定這些值。例如，'OK' 或 google.maps.GeocoderStatus.OK。
ERROR 與 Google 伺服器連線時發生問題。
INVALID_REQUEST 這個GeocoderRequest無效。
OK 回應包含有效的 GeocoderResponse。
OVER_QUERY_LIMIT 網頁已在過短的時間內超過要求限制。
REQUEST_DENIED 不允許這個網頁使用 Geocoder。
UNKNOWN_ERROR 伺服器發生錯誤，因此無法處理地理編碼要求。如果您再試一次，可能會成功進行要求。
ZERO_RESULTS 找不到與這個「GeocoderRequest」相符的結果。

GeocodingResponse 介面

google.maps.GeocoderResponse 介面

Geocoder 傳回的 Geocoding 回應，其中包含 GeocoderResult 的清單。
results
GeocoderResult 清單。

GeocodingResult 介面

google.maps.GeocoderResult 介面

擷取自地理編碼伺服器的單一 Geocoder 結果。地理編碼要求可能會傳回多個結果物件。請注意，雖然這個結果是與「JSON 類似」的結果，但並非完全採用 JSON，因為它會間接包含 LatLng 物件。
address_components
GeocoderAddressComponent 的陣列
formatted_address
類型：string
包含這個位置使用者可理解的地址字串。
geometry
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
字串的陣列，代表郵遞區號中包含的所有地區。系統只會在所傳回結果是包含多個位置的郵遞區號時，才會顯示這個陣列。

GeocodingAddressComponent 介面

google.maps.GeocoderAddressComponent 介面

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

GeocodingGeometry 介面

google.maps.GeocoderGeometry 介面

這個GeocoderResult的幾何圖形資訊
location
類型：LatLng
這個結果的緯度/經度座標
location_type
location 傳回的地點類型
viewport
類型：LatLngBounds
顯示這個GeocoderResult的建議可視區域邊界
bounds optional
類型：LatLngBounds optional
這個 GeocoderResult 的精確範圍 (如適用)

GeocodingLocationType 常數

google.maps.GeocoderLocationType 常數

說明從地理編碼傳回的位置類型。您可以使用值或透過常數名稱指定這些值。例如 'ROOFTOP' 或 google.maps.GeocoderLocationType.ROOFTOP。
APPROXIMATE 傳回的結果是約略的。
GEOMETRIC_CENTER 傳回的結果為一條線 (例如街道) 或多邊形 (區域) 結果的地理中心點。
RANGE_INTERPOLATED 傳回的結果代表插入兩個精確位置 (例如十字路口) 之間的近似值 (通常在道路上)。如果 Geocoder 無法取得街道地址的精確定點地理編碼，就會傳回插入的結果。
ROOFTOP 傳回的結果反映精確的地理編碼。