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