本頁面由 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`	使用點 (緯度/經度) 設定起始位置，以便計算路線。
`setOrigin(address)`	`DirectionFinder`	使用地址設定起點，以便計算路線。
`setRegion(region)`	`DirectionFinder`	設定解讀地點名稱時要使用的區域。

`DirectionFinderEnums`

屬性

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

`ElevationSampler`

方法

方法	傳回類型	簡短說明
`sampleLocation(latitude, longitude)`	`Object`	傳回單一點 (lat/lng) 的海拔高度資料。
`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 物件。
`setAuthentication(clientId, signingKey)`	`void`	啟用外部建立的 Google 地圖 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`	在目前路徑定義中新增點 (緯/經)。
`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`	衛星和道路地圖的混合圖層，在衛星地圖上顯示主要街道和地點名稱的透明圖層。