Maps Service

這項服務可讓指令碼產生靜態地圖、尋找路線、將地址轉換為地理編碼座標，以及取樣海拔高度。

類別

名稱	簡短說明
`Avoid`	列舉，代表尋找路線時要避免的限制類型。
`Color`	列舉，代表可在地圖圖片中使用的具名顏色。
`DirectionFinder`	可擷取地點之間的路線。
`DirectionFinderEnums`	`DirectionFinder` 使用的列舉集合。
`ElevationSampler`	可讓您在特定位置取樣海拔高度。
`Format`	代表地圖圖片格式的列舉。
`Geocoder`	可轉換地址和地理座標。
`Maps`	可尋找方向、進行地理編碼、取樣海拔高度，以及建立靜態地圖圖片。
`MarkerSize`	這個列舉代表新增至地圖的標記大小。
`Mode`	列舉，代表尋找路線時使用的交通方式。
`StaticMap`	可建立及裝飾靜態地圖圖片。
`StaticMapEnums`	`StaticMap` 使用的列舉集合。
`Type`	列舉，代表要算繪的地圖類型。

`Avoid`

屬性

屬性	類型	說明
`TOLLS`	`Enum`	避開收費路段。
`HIGHWAYS`	`Enum`	避開高速公路。

`Color`

屬性

屬性	類型	說明
`BLACK`	`Enum`
`BROWN`	`Enum`
`GREEN`	`Enum`
`PURPLE`	`Enum`
`YELLOW`	`Enum`
`BLUE`	`Enum`
`GRAY`	`Enum`
`ORANGE`	`Enum`
`RED`	`Enum`
`WHITE`	`Enum`

`DirectionFinder`

方法

方法	傳回類型	簡短說明
`addWaypoint(latitude, longitude)`	`DirectionFinder`	使用點 (緯度/經度) 新增路徑必須經過的路線點。
`addWaypoint(address)`	`DirectionFinder`	使用地址新增路徑必須經過的中途點。
`clearWaypoints()`	`DirectionFinder`	清除目前的航點集。
`getDirections()`	`Object`	使用設定的起點、終點和其他選項取得路線。
`setAlternatives(useAlternatives)`	`DirectionFinder`	設定是否應傳回替代路線，而非僅傳回排名最高的路線 (預設為 `false`)。
`setArrive(time)`	`DirectionFinder`	設定預計抵達時間 (如適用)。
`setAvoid(avoid)`	`DirectionFinder`	設定是否要避開特定類型的限制。
`setDepart(time)`	`DirectionFinder`	設定預計出發時間 (如適用)。
`setDestination(latitude, longitude)`	`DirectionFinder`	使用點 (緯度/經度) 設定要計算路線的終點位置。
`setDestination(address)`	`DirectionFinder`	使用地址設定要計算路線的終點。
`setLanguage(language)`	`DirectionFinder`	設定導航路線的語言。
`setMode(mode)`	`DirectionFinder`	設定交通方式 (預設為開車)。
`setOptimizeWaypoints(optimizeOrder)`	`DirectionFinder`	設定是否要透過更有效率的順序調整路線控點，進而規劃出最佳路線 (預設為 `false`)。
`setOrigin(latitude, longitude)`	`DirectionFinder`	使用點 (緯度/經度) 設定計算路線的起點。
`setOrigin(address)`	`DirectionFinder`	使用地址設定計算路線的起點。
`setRegion(region)`	`DirectionFinder`	設定解讀地點名稱時要使用的區域。

`DirectionFinderEnums`

屬性

屬性	類型	說明
`Avoid`	`Avoid`
`Mode`	`Mode`

`ElevationSampler`

方法

方法	傳回類型	簡短說明
`sampleLocation(latitude, longitude)`	`Object`	傳回單一點 (緯度/經度) 的海拔高度資料。
`sampleLocations(points)`	`Object`	傳回一系列點 (緯度/經度) 的海拔高度資料。
`sampleLocations(encodedPolyline)`	`Object`	傳回編碼折線中各點的海拔高度資料。
`samplePath(points, numSamples)`	`Object`	傳回沿線多個樣本的海拔高度資料，並使用一系列點定義路線。
`samplePath(encodedPolyline, numSamples)`	`Object`	傳回沿線多個樣本的海拔高度資料，並使用編碼折線定義。

`Format`

屬性

屬性	類型	說明
`PNG`	`Enum`	8 位元 PNG 格式。
`PNG8`	`Enum`	8 位元 PNG 格式。
`PNG32`	`Enum`	32 位元 PNG 格式。
`GIF`	`Enum`	GIF 格式。
`JPG`	`Enum`	JPEG 格式。
`JPG_BASELINE`	`Enum`	非漸進式 JPEG 格式。

`Geocoder`

方法

方法	傳回類型	簡短說明
`geocode(address)`	`Object`	取得指定地址的概略地理位置點。
`reverseGeocode(latitude, longitude)`	`Object`	取得指定地理位置點的概略地址。
`setBounds(swLatitude, swLongitude, neLatitude, neLongitude)`	`Geocoder`	設定區域的界線，搜尋結果應優先顯示該區域的內容。
`setLanguage(language)`	`Geocoder`	設定結果中使用的語言。
`setRegion(region)`	`Geocoder`	設定解讀地點名稱時要使用的區域。

`Maps`

屬性

屬性	類型	說明
`DirectionFinder`	`DirectionFinderEnums`
`StaticMap`	`StaticMapEnums`

方法

方法	傳回類型	簡短說明
`decodePolyline(polyline)`	`Number[]`	將編碼折線字串解碼回點陣列。
`encodePolyline(points)`	`String`	將點陣列編碼為字串。
`newDirectionFinder()`	`DirectionFinder`	建立新的 DirectionFinder 物件。
`newElevationSampler()`	`ElevationSampler`	建立 ElevationSampler 物件。
`newGeocoder()`	`Geocoder`	建立新的 Geocoder 物件。
`newStaticMap()`	`StaticMap`	建立新的 StaticMap 物件。
`resetAuthenticationApiKey()`	`void`	將驗證憑證重設為使用預設配額。
`setAuthenticationByApiKey(apiKey)`	`void`	啟用 API 金鑰來驗證要求，以使用額外配額。
`setAuthenticationByApiKey(apiKey, signingKey)`	`void`	啟用 API 金鑰和簽署金鑰，驗證要求，以在 StaticMap 中使用額外配額。

`MarkerSize`

屬性

屬性	類型	說明
`TINY`	`Enum`	最小尺寸的市場 (最小可用尺寸)。
`MID`	`Enum`	中型標記 (最大可用大小)。
`SMALL`	`Enum`	小型標記。

`Mode`

屬性

屬性	類型	說明
`DRIVING`	`Enum`	透過道路取得行車路線。
`WALKING`	`Enum`	沿途設有人行道和騎樓 (如有) 的步行路線。
`BICYCLING`	`Enum`	沿途設有單車道與專用道路的單車路線 (如有)。
`TRANSIT`	`Enum`	大眾運輸路線 (如有)。

`StaticMap`

方法

方法	傳回類型	簡短說明
`addAddress(address)`	`StaticMap`	在目前的路徑定義中新增地址。
`addMarker(latitude, longitude)`	`StaticMap`	使用點 (緯度/經度) 在地圖上新增標記。
`addMarker(address)`	`StaticMap`	使用地址在地圖上新增標記。
`addPath(points)`	`StaticMap`	使用點陣列在地圖上新增路徑。
`addPath(polyline)`	`StaticMap`	使用編碼折線在地圖上新增路徑。
`addPoint(latitude, longitude)`	`StaticMap`	在目前的路徑定義中新增點 (緯度/經度)。
`addVisible(latitude, longitude)`	`StaticMap`	新增地圖中必須顯示的點 (緯度/經度) 位置。
`addVisible(address)`	`StaticMap`	新增必須在地圖上顯示的地址位置。
`beginPath()`	`StaticMap`	開始定義新路徑。
`clearMarkers()`	`StaticMap`	清除目前的標記集。
`clearPaths()`	`StaticMap`	清除目前的路徑集。
`clearVisibles()`	`StaticMap`	清除目前顯示的位置組合。
`endPath()`	`StaticMap`	完成以 beginPath() 開頭的路徑定義。
`getAs(contentType)`	`Blob`	以轉換為指定內容類型的 Blob 形式，傳回這個物件內的資料。
`getBlob()`	`Blob`	以 `Blob` 形式取得圖片資料。
`getMapImage()`	`Byte[]`	以位元組陣列形式取得原始圖片資料。
`getMapUrl()`	`String`	取得地圖圖片的網址。
`setCenter(latitude, longitude)`	`StaticMap`	使用點 (經緯度) 設定地圖中心。
`setCenter(address)`	`StaticMap`	使用地址設定地圖中心。
`setCustomMarkerStyle(imageUrl, useShadow)`	`StaticMap`	設定建立新標記時要使用的自訂標記圖片。
`setFormat(format)`	`StaticMap`	設定地圖圖片的格式。
`setLanguage(language)`	`StaticMap`	設定地圖上文字的顯示語言 (如有)。
`setMapType(mapType)`	`StaticMap`	設定要顯示的地圖類型。
`setMarkerStyle(size, color, label)`	`StaticMap`	設定建立新標記時要使用的標記樣式。
`setMobile(useMobileTiles)`	`StaticMap`	設定是否要為行動裝置使用專用圖塊集。
`setPathStyle(weight, color, fillColor)`	`StaticMap`	設定建立新路徑時要使用的路徑樣式。
`setSize(width, height)`	`StaticMap`	以像素為單位設定地圖圖片的寬度和高度。
`setZoom(zoom)`	`StaticMap`	設定地圖的縮放比例或放大倍率。

`StaticMapEnums`

屬性

屬性	類型	說明
`Color`	`Color`
`Format`	`Format`
`MarkerSize`	`MarkerSize`
`Type`	`Type`

`Type`

屬性

屬性	類型	說明
`ROADMAP`	`Enum`	標準路線圖，也就是 Google 地圖網站上通常顯示的路線圖。
`SATELLITE`	`Enum`	衛星地圖。
`TERRAIN`	`Enum`	實體地形圖，顯示地形和植被。
`HYBRID`	`Enum`	衛星和道路地圖的混合模式，衛星地圖上會顯示主要街道和地名的透明圖層。

Maps Service 透過集合功能整理內容 你可以依據偏好儲存及分類內容。

類別

屬性

屬性

方法

屬性

方法

屬性

方法

屬性

方法

屬性

屬性

方法

屬性

屬性

Maps Service