Maps Service

Google 地图

借助此服务，脚本可以生成静态地图、查找路线、将地址转换为地理编码坐标，以及采样海拔。

类

名称	简介
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	混合型卫星地图和路线图，显示一个透明的主要街道图层，并在卫星地图上放置名称。