转:ArcGIS API For JavaScript官方文档(二十)之图形和要素图层——①Graphics概述

时间:2022-11-10 23:27:04

原文地址:ArcGIS API For JavaScript官方文档(二十)之图形和要素图层——①Graphics概述

ArcGIS JavaScript API允许在地图上绘制graphic(图形)。graphic可以由用户作为标记或输入绘制,也可以由应用程序根据任务绘制。例如,应用程序可能会将查询结果作为graphics添加到地图。

您可以为您的ArcGIS JavaScript API地图创建和添加一个或多个graphic图层。一个GraphcsLayer包含一个Graphic对象的数组,该数组初始是空的,但是在地图加载之后任何时候都可以添加graphic。

将graphic想象为4件事物的容器:geometry、symbol、attrubutes和info template.

  • geometry决定graphic的位置。可以是point、multipoint、polyline、polygon。
  • symbol决定graphic的外观,geometry是point、multipoint的symbol可以是marker symbol,polyline的symbol可以是line symbol、polygon的symbol可以是fill symbol。
  • attributes是描述graphic的名称-值对。如果您创建graphic,您需要分配attributes。如果graphic是在一个图层上响应执行任务而创建的,则graphic自动包含该图层的字段属性。一些任务允许您限制返回到结果graphic的attributes,Query.outFields是限制任务返回attributes的一个示例。
  • info template定义当graphic被点击时,各种attribute将如何出现。

四个属性geometry、symbol、attributes和info template都是可选的。许多task结果被作为FeatureSet中的graphic对象被返回。这些graphic返回时只有geometry和attributes。如果您想将graphic添加到地图中,必须为它们定义和设置符号。

如果您正在编写允许用户在地图上绘制graphic的代码,则Draw工具条使此变得非常容易。Draw工具条是一个类,可以帮助您捕获用户在屏幕上绘制的geometry,然后您可以定义一个symbol并将它应用到新graphic对象中的geometry中。Drawing tools sample演示了这个工作过程。

更多内容见原文地址