本頁面由 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`	使用點 (lat/lng) 新增路線必須通過的路線控點。
`addWaypoint(address)`	`DirectionFinder`	使用地址新增路線必須通過的路線控點。
`clearWaypoints()`	`DirectionFinder`	清除目前的路線控點。
`getDirections()`	`Object`	使用已設定的起點、目的地和其他選項取得路線。
`setAlternatives(useAlternatives)`	`DirectionFinder`	設定是否應傳回替代路徑，而非只有最高排名路徑 (預設為 false)。
`setArrive(time)`	`DirectionFinder`	設定所需的抵達時間 (如適用)。
`setAvoid(avoid)`	`DirectionFinder`	設定是否要避免特定類型的限制。
`setDepart(time)`	`DirectionFinder`	設定所需的出發時間 (如適用)。
`setDestination(latitude, longitude)`	`DirectionFinder`	使用點 (lat/lng) 設定用於計算路線的結束位置。
`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`	傳回單一點的海拔高度資料 (lat/lng)。
`sampleLocations(points)`	`Object`	傳回一系列點的經緯度資料 (lat/lng)。
`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`	建立新的 Geocoding 物件。
`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`	使用點 (lat/lng) 在地圖上新增標記。
`addMarker(address)`	`StaticMap`	使用地址在地圖上加入標記。
`addPath(points)`	`StaticMap`	使用點陣列新增地圖路徑。
`addPath(polyline)`	`StaticMap`	使用編碼的折線為地圖新增路徑。
`addPoint(latitude, longitude)`	`StaticMap`	在目前的路徑定義中新增點 (lat/lng)。
`addVisible(latitude, longitude)`	`StaticMap`	新增必須在地圖中顯示的點 (lat/lng) 位置。
`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`	使用點 (lat/lng) 設定地圖的中心。
`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`	衛星和藍圖地圖的混合地圖，在衛星地圖上顯示主要街道和地點名稱的透明層。