KML教程_1基本部分

KML教程KML是一种文件格式，用于在地球浏览器（例如Google地球、Google地图和谷歌手机地图）中显示地理数据。KML使用含有嵌套的元素和属性的基于标记的结构，并符合XML标准。所有标记都区分大小写，而且完全如KML参考中列出的那样显示。该参考指出了哪些标记是可选的。在指定元素内，标记必须按照参考中显示的顺序显示。如果您尚不熟悉KML，请查看本文档和附带的示例文件（SamplesInEarth和SamplesInMaps），开始了解KML文件的基本结构和最常用的标记。第一部分介绍了可以用Google地球用户界面创建的地图项。这些地图项有：地标、说明、地面叠加层、路径和多边形。第二部分介绍了需要用文本编辑器编写KML的地图项。用“.kml”或“.kmz”扩展名保存文本文件时，地球浏览器会知道如何显示它。提示：要在Google地球中查看某地图项的KML“代码”，只需在Google地球的三维查看器中右键点击该地图项并选择“复制”。然后将剪贴板内容粘贴到任一文本编辑器中。Google地球中显示的可视地图项将转换为与其相当的KML文本。您一定要试试该功能。此处描述的所有示例都在KMLSamples文件中。请先下载该文件，然后在Google地球中查看这些示例。目录1.基本KML文档1.地标2.地标中的描述性HTML3.地面叠加层4.路径5.多边形2.高级KML文档1.几何图形样式2.突出显示图标的样式3.屏幕叠加层4.网络链接3.KMLMIME类型KML几何对象类型对象描述Point(点)用经度、纬度和（可选）海拔高度定义的地理位置。LineString(线段)定义一组连起来的线段LinearRing(环)定义闭合的线条字符串，通常是多边形的外边界。也可以将LinearRing用作多边形的内边界，来在多边形中创建孔。Polygon(多边形)用1个或多个外边界和0个或多个内边界定义的多边形。而边界又是由LinearRing定义的。MultiGeometry(几何对象集)与同一地图项关联的0个或多个基本几何图形（如点、线段、环、多边形等）的容器。Model(三维模型)COLLADA文件中描述的三维对象（在Link标签中引用）。COLLADA文件具有“.dae”文件扩展名。模型在其自身的坐标空间内创建，然后在Google地球中查找、定位和缩放。Placemark（地标）地标是具有相关几何图形（如点、线段、环、多边形等）的地图项。GroundOverlay(地面叠加层)用于绘制在地形上叠加或悬浮于特定高度的图片叠加层KML文档格式第1行：XML标头。这是每个KML文件的第1行。该行前面不能有空格或其他字符。第2行：KML名称空间声明。这是每个KML2.2文件的第2行。1基本KML文档最简单的KML文档类型就是可直接在Google地球中编写的文档，也就是说您无需在文本编辑器中编辑或创建任何KML。Placemark(地标)、GroundOverlay（地面叠加层）、Path（路径）和Polygon（多边形）都可以直接在Google地球中编写。地标（Placemark）地标是Google地球中最常用的地图项之一。点地标使用黄色图钉作为缺省图标，在地球表面标记出位置。最简单的地标只包含一个Point元素，它指定地标的位置。您可以指定地标的名称和自定义图标，还可以为地标添加其他几何元素（如点、线段、环、多边形等）。在Google地球中打开KMLSamples文件，并展开“Placemarks”子文件夹。该文件夹包含三种不同类型的地标：“简单”、“浮动”和“凸出”。简单地标的KML代码如下：?xmlversion=1.0encoding=UTF-8?kmlxmlns=简单点地标(Simpleplacemark)/namedescription华东师范大学图书馆（闵行校区）/descriptionPointcoordinates121.447606,31.030899,0/coordinates/Point/Placemark/kml该文件的结构分解如下：XML标头。这是每个KML文件的第1行。该行前面不能有空格或其他字符。KML名称空间声明。这是每个KML2.2文件的第2行。包含以下元素的地标对象：o用于标识地标的“名称”o附着到地标的“气泡框”中显示的“说明”o指定地标在地球表面位置的“点”-“经度”、“纬度”及“高度”（可选）想知道该地标在哪里？它就在华东师范大学图书馆（闵行校区）！如果要改变地标的样式，如改变地标的图标文件和图标倾斜角度，可参考以下代码：?xmlversion=1.0encoding=UTF-8?kmlxmlns==iconEcnuIconStyleheading10/heading!—倾斜角度--Iconhrefecnu.jpg/href!—图标文件--/Icon/IconStyle/StylePlacemarkname简单点地标(Simpleplacemark)/namestyleUrl#iconEcnu/styleUrldescription华东师范大学图书馆（闵行校区）/descriptionPointcoordinates121.447606,31.030899,0/coordinates/Point/Placemark/Document/kml如果用自定义的三维模型作地标，请参看以下代码：?xmlversion=1.0encoding=UTF-8?kmlxmlns==khModel543altitudeModerelativeToGround/altitudeModeLocationlongitude121.447606/longitudelatitude31.030899/latitudealtitude0/altitude/LocationOrientationheading45.0/headingtilt10.0/tiltroll0.0/roll/OrientationScalex10.0/xy10.0/yz10.0/z/ScaleLinkhref\collada\tree.dae/hrefrefreshModeonce/refreshMode/Link/Model/Placemark/kml用户通常认为的Google地球中的“地标”，实际上是KML中的Placemark元素，包含一个Point子元素。点地标是您在Google地球的三维查看器中绘制图标和标签的唯一途径。默认情况下，该图标是您熟悉的黄色图钉。在KML中，Placemark可包含一个或多个几何元素，例如LineString、Polygon或Model。但只有具有点的Placemark可以有图标和标签。点用于放置图标，但点本身并无图形表示。Placemark语法Placemarkid=ID!--inheritedfromFeatureelement--name.../name!--string--visibility1/visibility!--boolean--open0/open!--boolean--atom:author...atom:author!--xmlns:atom--atom:link.../atom:link!--xmlns:atom--address.../address!--string--xal:AddressDetails.../xal:AddressDetails!--xmlns:xal--phoneNumber.../phoneNumber!--string--SnippetmaxLines=2.../Snippet!--string--description.../description!--string--AbstractView.../AbstractView!--CameraorLookAt--TimePrimitive.../TimePrimitivestyleUrl.../styleUrl!--anyURI--StyleSelector.../StyleSelectorRegion.../RegionMetadata.../Metadata!--deprecatedinKML2.2--ExtendedData.../ExtendedData!--newinKML2.2--!--specifictoPlacemarkelement--Geometry.../Geometry/Placemark说明地标是具有相关几何图形的地图项。在Google地球中，地标显示为“位置”面板中的列表项。点地标具有关联的图标，该图标会在三维查看器中的地球上做点的标记。（在Google地球三维查看器中，点地标是您可以点击或滚动的唯一对象。其他几何图形对象在三维查看器中没有图标。要使用户在三维查看器中有对象可以点击，需要创建MultiGeometry对象，后者包含点和其他几何图形对象。）地标特有的元素0个或1个Geometry元素示例PlacemarknameGoogleEarth-NewPlacemark/namedescriptionSomeDescriptivetext./descriptionLookAtlongitude-90.86879847669974/longitudelatitude48.25330383601299/latituderange440.8/rangetilt8.3/tiltheading2.7/heading/LookAtPointcoordinates-90.86948943473118,48.25450093195546,0/coordinates/Point/Placemark扩展Feature包含方DocumentFolder另请参见Icon地面叠加层(GroundOverlay)通过地面叠加层，可在Google地球的地形上“叠加”图像。Icon元素包含了指向叠加图像“.jpg”文件的链接。以下是KMLSamples文件中的地面叠加层示例，展示了2001年喷发的埃特纳火山：?xmlversion=1.0encoding=UTF-8?kmlxmlns=://code.google.com/apis/kml/docu