此页面由 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`	使用点（纬度/经度）设置要计算其路线的结束位置。
`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`	用于返回一系列点 (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`	用于创建一个新的 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`	向当前路径定义添加新点 (lat/lng)。
`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`	卫星图和路线图的混合地图，在卫星地图上显示主要街道和地名的透明图层。