ArcGIS Runtime for Android开发教程V2.0(6)基础篇---空间要素可视化

       此节主要介绍要素的可视化,但我们不管以什么方式获取数据,将其正确的展现到地图中才更具意义,在ArcGIS Runtime for Android中空间要素一般我们都将添加到GraphicsLayer图层中进行展示,对于空间要素无非就那么几种:点、线、面和文字类型等等,本节将主要介绍Graphic、Geomtry和Symbole,展示效果如图:

ArcGIS Runtime for Android开发教程V2.0(6)基础篇---空间要素可视化_第1张图片

1   Graphic

       Graphic是承载空间几何要素的载体,Graphic对象可以添加到GraphicsLayer图层中进行展示,Graphic主要有四部分组成:Geomtry、symbol、Map<String,Object>和InfoTemplate。所以通过Graphic对象可以获取这四方面的数据,但当我查看Graphic的API文档时会惊讶的发现,通过这个对象我们可以获取相应的属性信息,而没有相应的方法来修改自身的属性。要想修改Graphic的属性,也不是没有办法,只不过,想通过它自身来修改是不可能了,我们可以通过其他方式来修改,使用GraphicsLayer的updateGraphic()方法可以间接的修改Graphic对象的属性,用法如下:

public boolean onSingleTap(MotionEvent e) {
			if (type.length() > 1 && type.equalsIgnoreCase("POINT")) {
              //创建Graphic对象,添加几何结构,样式。
				Graphic graphic = new Graphic(mapView.toMapPoint(new Point(e.getX(), e
						.getY())),new SimpleMarkerSymbol(Color.RED,25,STYLE.CIRCLE));
				graphicsLayer.addGraphic(graphic);	//添加到图层中			
				return true;
			}
			return false;
		}

1.1   Geometry

       Geometry表示一个空间要素对象,它定义了一个空间位置和几何形体关系。它是所有空间对象的基类,直接子类有Envelope, MultiPath, MultiPoint, Point, Segment。Geometry的继承关系图如下:

ArcGIS Runtime for Android开发教程V2.0(6)基础篇---空间要素可视化_第2张图片

1.2 Point   

         Point针对于空间要素的点对象,point即可代表二维的点也可以是三维点对象,我们可以通过它自身的方法获取x或y坐标。用法如下:

 

Point point = new Point();//创建点对象
Point.setX(114);//设置x坐标
Point.setY(32);//设置y坐标
Graphic gp = new Graphic(point, new SimpleMarkerSymbol(Color.RED,25,STYLE.CIRCLE));
graphicsLayer.addGraphic(gp);//添加到图层中显示


 

Point常用接口介绍:  

序号

接口

说明

1

copyTo(Geometry dst)

复制自身并将其附给另一个几何对象

2

setXY(double x,double y)

设置点对象的xy的坐标

3

equals(Object _other)

判断两个点是否相同,当类型,属性,坐标相同时返回true

4

getType()

返回几何对象的类型

5

getX()setX(double x)

获取或设置x坐标值

6

getY()setY(double y)

获取或设置y坐标值


1.3 MultiPoint

MultiPoint表示多点对象,MultiPoint通常存储一系列的基础点,这些点按照一定的顺序存储并且每个点都可以获取它的索引位置。我们可以通过每个点的索引位置对MultiPoint对象进行正、删或改操作,用法如下:

Point point1 = new Point(114,32);//创建点对象
Point point2 = new Point(112,28);//创建点对象
MultiPoint multipoint = new MultiPoint();
multipoint.add(point1);//添加点
multipoint.add(point2);//添加点
multipoint.removePoint(1);//移除第二点


 

MultiPoint常用接口介绍:

序号

接口

说明

1

add(double x, double y)add(Point point)

添加一个点到多点对象里

2

insertPoint(int beforePointIndex,Point pt)

在某个位置之前插入一个点对象

3

removePoint(int pointIndex)

移除某个位置上的点

4

setPoint(int index, Point pointSrc)

替换某个位置上的点

5

queryEnvelope(Envelope env)

计算多点覆盖的矩形范围,env参数为计算后的结果

6

getType()

返回几何对象的类型

1.4 MultiPath

       MultiPath它是polygons 和 polylines的基类,MultiPath与MultiPoint很类似,只不过MultiPoint存储的点的数据集,而MultiPath存储的是一条条轨迹线,MultiPath为我们提供了丰富操作接口。我们可以通过这些接口来操作MultiPath对象里的任何轨迹上点。用法如下:

Point startPoint = new Point(114,28);
MultiPath path = new MultiPath();
path.startPath(startPoint);//设置路径的初始位置
path.lineto(new Point(113,32));//给路径添加点


MultiPath常用接口介绍:

序号

接口

说明

1

add(MultiPath src,boolean bReversePaths)

src对象中的所有paths添加到自身中去,bReversePathstrue时将src中的paths反向再添加

2

addPath(MultiPath src, int srcPathIndex, boolean bForward)

srcsrcPathIndex位置的path取出添加到自身中去,bForwardfalsepath中的点将被反向

3

addSegment(Segment segment,boolean bStartNewPath)

segment添加到自身中,bStartNewPathtrue时重新创建一个path并将segment添加。

4

insertPath(int pathIndex, MultiPath src,                      int srcPathIndex, boolean bForward)

addPath功能很类似,多了一个添加的位置参数

5

insertPoint(int pathIndex, int beforePointIndex,Point pt)

pathbeforePointIndex节点之前添加一点

6

getPathCount()

统计本身paths的数量

7

startPath(double x,double y)startPath(Point point)

创建一个path并设置其起点坐标

8

lineTo(double x, double y)lineTo(Point endPoint)

在最后一个点上添加一个线的片段

1.5 Envelope

        Envelope代表一个矩形要素,我们可以通过Envelope对象获取矩形窗口的中心点、矩形的上下四个点、宽和高等等。用法如下:

Envelope env = new Envelope(112,28,113,32);//创建矩形对象
map.setExtent(env);//设置地图显示范围
Point point= env.getCenter();//获取矩形框的中心点


 

Envelope常用接口介绍:

序号

接口

说明

1

setCoords(double xmin,double ymin,                      double xmax,double ymax)

设置Envelope对象的最小x,最小y,最大x,最大y

2

getCenterX()getCenterY()

获取Envelope对象的中心点的xy

3

centerAt(Point c, double w,double h)

设置Envelope对象的中心点和宽高

4

getLowerLeft()getUpperRight()getLowerRight()getUpperLeft()

返回Envelope的对象的四个点的坐标点

5

contains(Point p)

返回true表示p点在这个Envelope对象之内

6

getXMin()getYMin()getXMax()getYMax()setXMin(double x)setXMax(double x)setYMin(double y)setYMax(double y)

设置或获取Envelope对象的最大或最小x/y

1.6 Polygon

         Polygon是MultiPath子类,Polygon表示的是多边形或多多边形,Polygon里的所有path都是闭合的环,Polygon对象我们在日后的开发中经常会涉及到该对象,如标绘多边形或做空间查询时,Polygon对象中至少存在三个点并且不能同时在一条直线上。具体用法如下:

Polygon poly = new Polygon();//创建多边形对象
poly.startPath(new Point(0,0));//添加初始点
poly.lineto(new Point(10,0));
poly.lineto(new Point(10,10));
poly.lineto(new Point(0,0));//多边形是闭合的因此最后我们还要添加初始点的位置


 

Polygon常用接口介绍:

序号

接口

说明

1

calculateRingArea2D(int ringIndex)

计算ringIndex对应的2D面积

2

getType()

返回本身的对象的类型

3

queryEnvelope(Envelope env)

计算line线段所占据的矩形范围,env参数为计算后的结果

1.7 Polyline

 Polyline也是MultiPath子类,Polyline表示一条或多条线路径,Polyline跟Polygon用法基本相同,只不过Polyline的最后一个点不必跟初始点坐标相同。

Polyline常用接口介绍:

序号

接口

说明

1

addSegment(Segment segment,                       boolean bStartNewPath)

Polyline对象添加一节线段,当bStartNewPathtrue时,创建一个新的path并将segment添加到上面去。

2

getType()

返回本身的对象的类型

3

equals(Object other)

判断对象是否相等,如果几何类型、属性、坐标都相同返回true

1.8 Line

      Line与Polyline存在一定的关系,可以说Line是Polyline的组成部分,Line表示两点之间生成的线段。用法如下:

Line line = new Line()
line.setStart(new Point(113,32));//起始点
line.setEnd(new Point(114,28));//终止点
Polyline poly = new Polyline();
poly.addSegment(line,true);//添加线段到Polyline对象中


 

Line常用接口介绍:

序号

接口

说明

1

calculateLength2D()

计算line对象的2D长度

2

getType()

返回本身的对象的类型

3

equals(Object other)

判断对象是否相等,如果几何类型、属性、坐标都相同返回true

 

 

你可能感兴趣的:(ArcGIS Runtime for Android开发教程V2.0(6)基础篇---空间要素可视化)