本頁面由 Cloud Translation API 翻譯而成。

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`	設定使用點 (lat/lng) 計算路線的起點。
`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`	建立新的地理編碼器物件。
`newStaticMap()`	`StaticMap`	建立新的 StaticMap 物件。
`setAuthentication(clientId, signingKey)`	`void`	支援使用外部建立的 Google Maps API 付費方案帳戶，以便運用額外的配額用途。

`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`	將新的點 (lat/lng) 新增至目前的路徑定義。
`addVisible(latitude, longitude)`	`StaticMap`	新增必須在地圖上可見的點 (經緯度)。
`addVisible(address)`	`StaticMap`	新增必須在地圖上顯示的地址位置。
`beginPath()`	`StaticMap`	開始新的路徑定義。
`clearMarkers()`	`StaticMap`	清除目前的標記集。
`clearPaths()`	`StaticMap`	清除目前的路徑組合。
`clearVisibles()`	`StaticMap`	清除目前顯示的位置集。
`endPath()`	`StaticMap`	完成以 startPath() 啟動的路徑定義。
`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`	設定地圖上文字要使用的語言 (「avaialbe」)。
`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`	衛星地圖和道路圖的混合地圖，在衛星地圖上顯示一個透明圖層，顯示主要街道和地點名稱。