此页面由 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`	创建新的 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`	使用点 (lat/lng) 向地图添加标记。
`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`	混合型卫星地图和路线图，显示一个透明的主要街道图层，并在卫星地图上放置名称。