Maps Service

地圖介面集

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

類別

名稱簡短說明
Avoid列舉代表尋找路線時應避免的限制類型。
Color列舉代表地圖圖片中可用的具名顏色。
DirectionFinder允許擷取地點之間的路線。
DirectionFinderEnumsDirectionFinder 使用的列舉項目集合。
ElevationSampler允許對特定位置的海拔高度取樣。
Format列舉代表地圖圖片的格式。
Geocoder允許在地址和地理座標之間進行轉換。
Maps允許搜尋方向、地理編碼、海拔高度取樣,以及建立靜態地圖圖片。
MarkerSize列舉代表加入地圖中的標記大小。
Mode列舉代表尋找路線時使用的交通方式。
StaticMap允許建立和修飾靜態地圖圖片。
StaticMapEnumsStaticMap 使用的列舉項目集合。
Type列舉代表要算繪的地圖類型。

Avoid

屬性

屬性類型說明
TOLLSEnum避開收費站。
HIGHWAYSEnum避開高速公路。

Color

屬性

屬性類型說明
BLACKEnum
BROWNEnum
GREENEnum
PURPLEEnum
YELLOWEnum
BLUEEnum
GRAYEnum
ORANGEEnum
REDEnum
WHITEEnum

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

屬性

屬性類型說明
AvoidAvoid
ModeMode

ElevationSampler

方法

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

Format

屬性

屬性類型說明
PNGEnum8 位元 PNG 格式。
PNG8Enum8 位元 PNG 格式。
PNG32Enum32 位元 PNG 格式。
GIFEnumGIF 格式。
JPGEnumJPEG 格式。
JPG_BASELINEEnum非漸進式 JPEG 格式。

Geocoder

方法

方法傳回類型簡短說明
geocode(address)Object取得特定地址的近似地理點。
reverseGeocode(latitude, longitude)Object取得指定地理點的約略地址。
setBounds(swLatitude, swLongitude, neLatitude, neLongitude)Geocoder設定應在結果中要進行額外偏好設定的區域邊界。
setLanguage(language)Geocoder設定在結果中使用的語言。
setRegion(region)Geocoder設定解譯位置名稱時使用的區域。

Maps

屬性

屬性類型說明
DirectionFinderDirectionFinderEnums
StaticMapStaticMapEnums

方法

方法傳回類型簡短說明
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

屬性

屬性類型說明
TINYEnum小型市場 (供應者最小)。
MIDEnum中等大小的標記 (可使用最大)。
SMALLEnum小型標記。

Mode

屬性

屬性類型說明
DRIVINGEnum開車路線。
WALKINGEnum行人步道和騎樓的步行路線 (如適用)。
BICYCLINGEnum單車路線,以及專用道路和專用道路 (如適用) 的單車路線。
TRANSITEnum使用大眾運輸路線的大眾運輸路線 (如有)。

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

屬性

屬性類型說明
ColorColor
FormatFormat
MarkerSizeMarkerSize
TypeType

Type

屬性

屬性類型說明
ROADMAPEnum標準藍圖,通常顯示在 Google 地圖網站上。
SATELLITEEnum衛星地圖。
TERRAINEnum實際地形圖,顯示地形和植被。
HYBRIDEnum衛星地圖和道路圖的混合地圖,在衛星地圖上顯示一個透明圖層,顯示主要街道和地點名稱。