此页面由 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`	使用点 (lat/lng) 设置计算路线的结束位置。
`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`	返回单个点的海拔高度数据 (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 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`	添加必须在地图上显示的点 (lat/lng) 位置。
`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`	使用点 (lat/lng) 设置地图中心。
`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`

属性

属性	类型	说明
`Color`	`Color`
`Format`	`Format`
`MarkerSize`	`MarkerSize`
`Type`	`Type`

`Type`

属性

属性	类型	说明
`ROADMAP`	`Enum`	标准路线图，通常显示在 Google 地图网站上。
`SATELLITE`	`Enum`	卫星地图。
`TERRAIN`	`Enum`	展示地形和植被的自然地形地图。
`HYBRID`	`Enum`	卫星和路线图的混合地图，在卫星地图上显示主要街道和地点名称的透明图层。