GOOGLEMAPSAPIV3 地图类型

Google Maps JavaScript API V3地图类型1.地图类型2.基本地图类型3.45°图像a.启用45°图像b.旋转45°图像4.修改地图类型注册表5.样式化地图a.地图项b.样式器6.自定义地图类型a.地图坐标i.世界坐标ii.像素坐标iii.图块坐标b.MapType接口i.基本地图类型ii.叠加层地图类型iii.图片地图类型7.自定义投影a.实现投影界面b.投影中的坐标转换c.投影中的图块选择地图类型本文档讨论了您可以使用Google Maps JavaScript API显示的地图类型。

该API使用了MapType 对象来保留这些地图的相关信息。

MapType是一种接口，它定义了地图图块的显示形式和使用方法，以及坐标系从屏幕坐标转换到世界坐标（地图上）的方式。

每个MapType都必须包含一些用于处理图块的检索和释放的方法，以及定义图块视觉行为的属性。

Maps API中的地图类型的内部工作方式是一个较为复杂的主题。

大部分开发人员可以仅使用下述的基本地图类型。

不过，您也可以使用自定义地图类型来定义自己的地图图块，还可以使用样式化地图来修改现有地图类型的显示形式。

提供自定义地图类型时，您需要了解如何修改地图的地图类型注册表。

基本地图类型Google Maps API中提供了多种地图类型。

除了用户熟悉的“绘制”道路地图图块，Google Maps API 还可支持其他地图类型。

Google Maps API提供了以下地图类型：∙MapTypeId.ROADMAP，用于显示默认的道路地图视图∙MapTypeId.SATELLITE，用于显示Google地球卫星图像∙MapTypeId.HYBRID，用于同时显示普通视图和卫星视图∙MapTypeId.TERRAIN，用于根据地形信息显示实际地图。

要通过Map修改正在使用的地图类型，您可以设置其mapTypeId属性，方法是：在构造函数内设置其Map options对象，或者调用地图的setMapTypeId()方法。

请注意，您实际上并没有直接设置地图的地图类型，而是将其mapTypeId设置为引用使用标识符的MapType。

Maps JavaScript API V3使用了地图类型注册表（详见下文）来管理这些引用。

45°图像Google Maps API针对特定位置支持特殊的45°图像。

这一高分辨率图像可提供朝向各基本方向（东南西北）的透视视图。

对于支持的地图类型，这些图像还提供了更高的缩放级别。

下图显示了加利福尼亚州圣塔克鲁兹市木板路的45°透视视图：现有的google.maps.MapTypeId.SATELLITE和google.maps.MapTypeId.HYBRID地图类型支持高缩放级别的45°透视图像（在可用的情况下），前提是您已明确启用了此功能。

如果您放大的位置拥有此类图像，那么，这些地图类型将会自动通过以下方式更改其视图：∙地图上现有的任何平移控件将会变更为在现有的导航控件周围添加一个罗盘转轮。

您可以拖动该罗盘转轮来更改任意45°图像的方向，然后将方向对准包含图像的最近的支持方向即可。

∙一个旋转控件将会显示在现有的平移和缩放控件之间，它可用于将图像围绕着支持的方向旋转。

旋转控件仅支持顺时针方向旋转。

∙以当前位置为中心的45°透视图像将会替代卫星图像或混合图像。

默认情况下，此类视图会朝向北方。

如果您缩小地图，则地图会重新显示默认的卫星图像或混合图像。

∙MapType控件将会启用子菜单切换控件，用于显示45°图像。

缩小显示45°图像的地图类型将会还原所有更改，并重新构建原始地图类型。

Google正在不断地为更多城市添加45°图像。

有关最新信息，请查看Google Maps API覆盖率电子表格。

启用45°图像要启用支持的地图类型的45°透视图像，请在Map对象上调用setTilt(45)。

默认情况下，45°图像朝向北方。

您可以调用setTilt(0)以停止显示45°图像。

Map的getTilt()方法将会始终反映地图上所显示的当前倾斜度；如果您在地图上设置了倾斜度后又将其删除（例如通过缩小地图的方式），则地图的getTilt()方法将会返回0。

以下示例显示了俄勒冈州波特兰市中心的45°视图。

查看示例(aerial-simple.html)旋转45°图像实际上，45°图像是由朝向四个基本方向（东南西北）的一系列图片构成的。

当地图显示45°图像时，您可以将图像对准某个基本方向，方法是在Map对象上调用setHeading()，并向该对象传递一个数值，表示偏离北方的角度。

以下示例中显示了一张航拍地图，在您点击按钮后它会每3秒钟自动旋转一次：查看示例(aerial-rotation.html)修改地图类型注册表地图的mapTypeId是一种字符串标识符，用于将MapType与唯一值关联起来。

每个Map对象都会保留一个MapTypeRegistry，其中包含该地图可用的一系列MapType。

该注册表用于选择地图的某种控件（例如MapType控件）中可用的地图类型。

您无法直接读取地图类型注册表，而是应该通过以下方法对注册表进行修改：添加自定义地图类型并将它们与您所选择的字符串标识符进行关联。

您无法修改或更改基本地图类型（但您可以通过更改与该地图相关联的mapTypeControlOptions的显示形式来将这些类型从地图中删除）。

以下代码将地图设置为仅显示其mapTypeControlOptions中的两种地图类型，并修改了注册表，将此标识符的关联添加到MapType接口的实际实现中。

注意：我们有意未在之前的代码中记录自定义地图类型本身的创建。

关于构建地图类型的信息，请参见下面的样式化地图或自定义地图类型。

样式化地图借助StyledMapType，您可以自定义Google标准基本地图的显示形式，并更改诸如道路、公园和建筑物区域等元素的视觉显示，以体现不同于默认地图类型中所使用的样式。

这些组件称为地图项，您可以通过StyledMapType选择这些地图项，并将可视样式应用于地图项的显示（包括隐藏全部地图项）。

借助这些更改，可以在地图上强调特定组件或周围页面的补充内容。

StyledMapType()构造函数采用MapTypeStyles数组作为参数，每个数组均由选择器和样式器组成。

选择器指定应选择以应用样式的地图组件，而样式器指定这些元素的可视修改。

地图项地图由一组地图项构成，如道路或公园，这些地图项使用MapTypeStyleFeatureType指定。

地图项类型构成类别树，根为all。

关于地图内可供选择的地图项的完整列表，请参见Maps JavaScript API V3参考。

如果将地图项指定为all，则会选中所有的地图元素。

某些地图项类型类别还包含子类别，子类别是通过点表示法（如landscape.natural或road.local）来指定的。

如果指定父级地图项（例如road），则应用于此选择项的样式也将应用于所有道路（包括子类别）。

此外，地图上的某些地图项通常会包含不同的元素。

例如，道路不仅包括地图上绘制的线（几何图形），还包括附加到地图上的用于表示其名称的文本（标签）。

您可以通过指定MapTypeStyleElementType类型的类别来选择地图项内的元素。

系统支持以下元素类型：∙all（默认）用于选择该地图项的所有元素。

∙geometry只选择该地图项的地理元素。

∙labels只选择与该地图项关联的文本标签。

如果未指定任何元素类型，则样式将应用于所有元素（不考虑元素类型）。

以下代码段选择所有本地道路的标签：样式器样式器为MapTypeStyler类型的格式选项，应用于在每个MapTypeStyle规则中指定的地图项和元素。

目前，系统支持以下MapTypeStyler选项：∙hue（RGB十六进制字符串）用于表示基本颜色。

（*请参见下方的使用说明）。

∙lightness（介于-100和100之间的浮点值）用于表示元素的亮度变化百分比。

负值增加暗度（-100为黑），而正值增加亮度（+100为白）。

∙saturation（介于-100和100之间的浮点值）用于表示要应用到元素的基本颜色色度的变化百分比。

∙gamma（介于0.01和10.0之间的浮点值，其中1.0表示不应用任何校正）用于表示要应用到元素的灰度校正量。

灰度系数以非线性方式修改色相亮度，而不会影响白色值或黑色值。

灰度系数通常用于修改多个元素的对比度。

例如，您可以通过修改灰度系数来提高或降低元素的边缘与内部间的对比度。

低灰度系数值（小于1）可提高对比度，而高值（大于1）则可降低对比度。

∙inverse_lightness（如果为true）用于仅颠倒现有的亮度。

∙visibility（on、off或simplified）用于表示元素是否在地图上出现及其出现方式（如果出现的话）。

simplified可见度表示地图应按照它认为最合适的方式来简化这些元素的显示形式（例如，经过简化的道路结构可能会显示较少的道路）。

样式器规则必须作为不同的操作单独应用，并且按照它们在MapTypeStyler数组中显示的顺序进行应用。

请勿将多个操作合并为一项样式器操作，而应当在样式器数组中将每个操作定义为单独的元素。

顺序非常重要，因为某些操作的顺序是不可交换的。

通常而言，通过样式器操作进行修改的地图项和/或元素均已拥有样式，在此情况下，这些操作会应用于上述现有样式（如果有的话）。

请注意，我们在样式器操作中使用色相、饱和度、亮度(HSL)模型来表示颜色。

这些用于定义色彩的操作在图形设计领域很常见。

色相表示基本的颜色，饱和度表示该颜色的色度，而亮度则表示组合色中黑色或白色所占的相对比重。

HSL的所有三个值都可以映射到RGB值，反之亦然。

灰度校正可以修改色彩空间的饱和度，主要用于提高或降低对比度。

此外，HSL模型还可用于定义坐标空间内的颜色，其中hue用于表示色轮内的定向，而饱和度和亮度则用于表示不同轴上的幅度。

与大多数RGB色彩空间类似，色相也是在RGB色彩空间内进行衡量的，唯一不同的是后者缺少黑色和白色的深浅渐变。

RGB色轮注意：当hue采用HTML十六进制色彩值时，它只会将该值用于确定基本颜色（在色轮上的定向），而不是饱和度或亮度（这些值会以变化百分比的形式单独表示）。

例如，纯绿色可在hue属性内定义为“#00ff00”或“#000100”，这两种色相是相同的（这两个值都指向HSL颜色模型中的纯绿色）。