ArcgisTool

KO | EN

gitlite — search

#javascript #python #ai #llm #rust #deep-learning #macos #nodejs #windows #vue #awesome-list #security #openai #open-source

(★ 96)

封装Arcgis Runtime for Android 100.6.0地图基本操作。包括：测量工具控件及测量接口，放大缩小控件及放大缩小接口，地图旋转控件及地图旋转接口。

ArcgisTool 최신버젼 다운로드

최종 버전 다운로드 (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# ArcGisTool
封装Arcgis Runtime for Android 100.6.0地图基本操作。 
包括：测量工具控件及测量接口，放大缩小控件及放大缩小接口，地图旋转控件及地图旋转接口、绘制圆形、绘制矩形。 
![](https://sddman.oss-cn-shenzhen.aliyuncs.com/github/ArcgisTool/GIF.gif)
![](https://sddman.oss-cn-shenzhen.aliyuncs.com/github/ArcgisTool/GIF2.gif)
## 引用：
[![](https://jitpack.io/v/roomanl/ArcgisTool.svg)](https://jitpack.io/#roomanl/ArcgisTool)
```gradle
implementation 'com.github.roomanl:ArcgisTool:2.0'
或者
implementation project(':arcgistool')
```
## 更新日志：
#### 2021/12/20 V2.0
1、修改绘制点击事件为onSingleTapConfirmed，解决单击绘制与双击放大冲突。 
2、修改arcgis maven地址，解决1.9版无法引入的问题。 
#### 2020/05/26 V1.9
1、修复测量结果偏大的BUG。 
BUG产生原因：用错API了，原来使用平面测量的API去了。现在已经改成大地测量API
#### 2020/04/26 V1.8
新增图形绘制控件(圆形、矩形) 
圆形：在地图上点两个点，以这两个点的距离为半径绘制一个圆 
矩形：在地图上点两个点，以这两个点为对角线绘制一个矩形 
#### 2020/04/25 V1.7
1、补全所有地图事件回调 
2、修复不能在多个地图界面使用工具控件的BUG。 
BUG产生原因：原来的ArcgisToolManager.create(Context, MapView)返回的是静态的。所以多个界面的ArcgisToolManager都是同一个对象，所以出现这样的BUG。 
现修改为： ArcgisToolManager arcgisToolManager=new ArcgisToolManager(Context,mMapView);之后的样式设置、回调设置都用arcgisToolManager来调用。具体请看下面的使用文档
#### 2019/10/17 V1.6
ArcgisToolManager类新增旋转控件的样式属性设置
#### 2019/10/14 V1.5
ArcgisToolManager类新增放大缩小控件的样式属性设置
#### 2019/10/12 V1.4
新增ArcgisToolManager类，用此类来统一管理MeasureToolView，JAVA设置属性修改为用ArcgisToolManager类链式调用设置
#### 2018/09/19 V1.3
1、修复WGS84坐标下测量不正确的问题 
2、优化测量工具控件的使用 
3、封装设置底图、初始范围等接口 
4、封装在底图上叠加、移除图层的接口 
5、新增了很多接口，没时间写具体使用说明，有时间再写了 
## 测量工具：
### MeasureToolView使用
控件的功能包括，测距、测面积、撤销、恢复、清除、完成六个功能。

测距：在地图上绘制线段进行长度测量

测面积：在地图上绘制一个面，进行面积测量

撤销：撤销到上一步绘制，只能撤销未完成的测量

恢复：恢复到下一步绘制，只能恢复未完成的测量

清除：清空测量内容并结束测量，再次点击地图时不会进行测量

完成：结束本次测量，本次测量将不能撤销和恢复，已绘制的图形不会被清除，如需进行下一段测量请再次点击测距或测面积按钮 
#### 最简单的基本用法：
界面代码
```xml
 <cn.sddman.arcgistool.view.MeasureToolView
 android:id="@+id/measure_tool"
 android:layout_width="wrap_content"
 android:layout_height="wrap_content">
 </cn.sddman.arcgistool.view.MeasureToolView>
```
java代码
```java
 MeasureToolView measureToolView=(MeasureToolView)findViewById(R.id.measure_tool);
 ArcgisToolManager arcgisToolManager=new ArcgisToolManager(this,mMapView);
 arcgisToolManager.builderMeasure(measureToolView);
```
注意：请不要给mMapView设置点击事件，不然会覆盖掉MeasureToolView的地图点击事件，如需要在地图点击之后做一些自己的操作，请看下面设置回调的说明。

以上代码将会显示默认的控件样式，下图是默认样式
![](https://sddman.oss-cn-shenzhen.aliyuncs.com/github/ArcgisTool/1.jpg)

MeasureToolView支持样式设置，可以设置成自己需要的样式，下图是自定义样式
![](https://sddman.oss-cn-shenzhen.aliyuncs.com/github/ArcgisTool/2.jpg)
### MeasureToolView属性样式设置
#### 在界面设置属性
```xml
 <cn.sddman.arcgistool.view.MeasureToolView
 android:id="@+id/measure_tool"
 android:layout_width="wrap_content"
 android:layout_height="wrap_content"
 app:button_width="60do"//设置每一个按钮宽度;默认35
 app:button_height="40dp"//设置每一个按钮高度;默认35
 app:is_horizontal="true"//是否水平显示，true水平,false垂直;默认true
 app:view_background="@drawable/sddman_shadow_bg"//设置整个控件背景，默认白色圆角矩形
 app:show_text="true"//是否显示文字；默认false
 app:font_color="@color/colorAccent"//设置文字颜色；默认gray
 app:font_size="12dp"//设置文字大小；默认12dp
 app:measure_prev_text="撤销"//设置撤销按钮文字；默认“撤销”
 app:measure_next_text="恢复"//设置恢复按钮文字；默认“恢复”
 app:measure_length_text="测距"//设置测距按钮文字；默认“测距”
 app:measure_area_text="测面积"//设置测面积按钮文字；默认“测面积”
 app:measure_clear_text="清除"//设置清除按钮文字；默认“清除”
 app:measure_end_text="完成"//设置完成按钮文字；默认“完成”
 app:measure_prev_image="@drawable/sddman_measure_prev"//设置撤销按钮图标
 app:measure_next_image="@drawable/sddman_measure_next"//设置恢复按钮图标
 app:measure_length_image="@drawable/sddman_measure_length"//设置测距按钮图标
 app:measure_area_image="@drawable/sddman_measure_area"//设置测面积按钮图标
 app:measure_clear_image="@drawable/sddman_measure_clear"//设置清除按钮图标
 app:measure_end_image="@drawable/sddman_measure_end"//设置完成按钮图标
 >
 </cn.sddman.arcgistool.view.MeasureToolView>
```
#### java代码设置属性
```java
MeasureToolView measureToolView=(MeasureToolView)findViewById(R.id.measure_tool);
arcgisToolManager.builderMeasure(measureToolView)
 .setButtonWidth(60)//设置每一个按钮宽度;默认35
 .setButtonHeight(40)//设置每一个按钮高度;默认35
 .setMeasureBackground(R.color.colorAccent)//设置整个控件背景，默认白色圆角矩形
 .setSohwText(true)//是否显示文字；默认false
 .setFontSize(12)//设置文字大小；默认12dp
 .setFontColor(R.color.color444)//设置字体颜色，默认#808080
 .setMeasurePrevStr("撤销")//设置撤销按钮文字；默认“撤销”
 .setMeasureNextStr("恢复")//设置恢复按钮文字；默认“恢复”
 .setMeasureLengthStr("测距")//设置测距按钮文字；默认“测距”
 .setMeasureAreaStr("测面积")//设置测面积按钮文字；默认“测面积”
 .setMeasureClearStr("清除")//设置清除按钮文字；默认“清除”
 .setMeasureEndStr("完成")//设置完成按钮文字；默认“完成”
 .setMeasurePrevImage(R.drawable.sddman_measure_prev)//设置撤销按钮图标
 .setMeasureNextImage(R.drawable.sddman_measure_next)//设置恢复按钮图标
 .setMeasureLengthImage(R.drawable.sddman_measure_length)//设置测距按钮图标
 .setMeasureAreaImage(R.drawable.sddman_measure_area)//设置测面积按钮图标
 .setMeasureClearImage(R.drawable.sddman_measure_clear)//设置清除按钮图标
 .setMeasureEndImage(R.drawable.sddman_measure_end)//设置完成按钮图标
 .setSpatialReference(SpatialReference.create(3857))//设置坐标参考系,默认从mMapView获取SpatialReference
 .setLengthType(Variable.Measure.KM)//设置测量长度单位,默认Variable.Measure.M(米))；其它：Variable.Measure.KM(千米)；Variable.Measure.M(米)；Variable.Measure.KIM(公里)
 .setAreaType(Variable.Measure.KM2);//设置测量面积单位,默认Variable.Measure.M2(平方米)；其它：Variable.Measure.KM2(平方千米)；Variable.Measure.M2(平方米)；Variable.Measure.HM2(公顷)；Variable.Measure.A2(亩)；
```
#### 设置地图点击回调
```java
//注意：setMapClickCallBack()要在builderMeasure()之前调用
arcgisToolManager.setMapClickCallBack(new MapViewOnTouchListener(){
 @Override
 public boolean onSingleTapUp(MotionEvent e) {
 Toast.makeText(MainActivity.this,"onSingleTapUp",Toast.LENGTH_SHORT).show();
 return super.onSingleTapUp(e);
 }
 @Override
 public boolean onDoubleTap(MotionEvent e) {
 Toast.makeText(MainActivity.this,"onDoubleTap",Toast.LENGTH_SHORT).show();
 return super.onDoubleTap(e);
 }
 @Override
 public boolean onScroll(MotionEvent e1, MotionEvent e2, float distanceX, float distanceY) {
 Toast.makeText(MainActivity.this,"onScroll",Toast.LENGTH_SHORT).show();
 return super.onScroll(e1, e2, distanceX, distanceY);
 }
 @Override
 public boolean onRotate(MotionEvent event, double rotationAngle) {
 Toast.makeText(MainActivity.this,"onRotate",Toast.LENGTH_SHORT).show();
 return super.onRotate(event, rotationAngle);
 }
 @Override
 public boolean onScale(ScaleGestureDetector detector) {
 Toast.makeText(MainActivity.this,"onScale",Toast.LENGTH_SHORT).show();
 return super.onScale(detector);
 }
 })
 .builderMeasure(measureToolView)
```
#### 设置测量工具按钮点击回调
```java
 arcgisToolManager.builderMeasure(measureToolView)
 .setMeasureClickListener(new MeasureClickListener() {
 @Override
 public void prevClick(boolean hasPrev) {
 //撤销回调，hasPrev是否还能撤销
 Toast.makeText(MainActivity.this,"MeasureToolView prevClick",Toast.LENGTH_SHORT).show();
 }

@Override
                    public void nextClick(boolean hasNext) {
                        //恢复回调，hasPrev是否还能恢复
                        Toast.makeText(MainActivity.this,"MeasureToolView nextClick",Toast.LENGTH_SHORT).show();
                    }

@Override
                    public void lengthClick() {
                        //长度测量点击
                        Toast.makeText(MainActivity.this,"MeasureToolView lengthClick",Toast.LENGTH_SHORT).show();
                    }

@Override
                    public void areaClick() {
                        //面积测量点击
                        Toast.makeText(MainActivity.this,"MeasureToolView areaClick",Toast.LENGTH_SHORT).show();
                    }

@Override
                    public void clearClick(DrawEntity draw) {
                        //清除点击，返回DrawEntity所有绘制的文字、点、线、面的集合
                        Toast.makeText(MainActivity.this,"MeasureToolView clearClick",Toast.LENGTH_SHORT).show();
                    }

@Override
                    public void endClick(DrawEntity draw) {
                         //完成点击，返回DrawEntity所有绘制的文字、点、线、面的集合
                        Toast.makeText(MainActivity.this,"MeasureToolView endClick",Toast.LENGTH_SHORT).show();
                    }
                });
```

### 测量开放接口，ArcGisMeasure
MeasureToolView控件均由调用ArcGisMeasure开放接口实现
```java
 ArcGisMeasure arcgisMeasure=new ArcGisMeasure(context,mMapView);
 //默认从mMapView获取SpatialReference
 arcgisMeasure.setSpatialReference(SpatialReference.create(3857));
 //Variable.Measure.KM(千米)；Variable.Measure.M(米)；Variable.Measure.KIM(公里)
 //默认Variable.Measure.M(米))；
 arcgisMeasure.setLengthType(Variable.Measure.KM);
 //Variable.Measure.KM2(平方千米)；Variable.Measure.M2(平方米)；Variable.Measure.HM2(公顷)；Variable.Measure.A2(亩)；
 //默认Variable.Measure.M2(平方米)；
 arcgisMeasure.setAreaType(Variable.Measure.KM2);
 //撤销
 boolean hasPrev=arcgisMeasure.prevDraw();
 //恢复
 boolean hasNext=arcgisMeasure.nextDraw();
 //开始测长度，传入屏幕坐标x,y或者传入android.graphics.Point
 arcgisMeasure.startMeasuredLength(e.getX(), e.getY());
 //或者
 arcgisMeasure.startMeasuredLength(android.graphics.Point);
 //开始测面积，传入屏幕坐标x,y或者传入android.graphics.Point
 arcgisMeasure.startMeasuredArea(e.getX(), e.getY());
 //或者
 arcgisMeasure.startMeasuredArea(android.graphics.Point);
 //清除测量，返回DrawEntity所有绘制的文字、点、线、面的集合
 DrawEntity draw=arcgisMeasure.clearMeasure();
 //结束测量，返回DrawEntity所有绘制的文字、点、线、面的集合
 DrawEntity draw=arcgisMeasure.endMeasure();
```
## 图形绘制控件：
图形绘制控件包括：矩形、圆形、清除3个功能。 
圆形：在地图上点两个点，以这两个点的距离为半径绘制一个圆 
矩形：在地图上点两个点，以这两个点为对角线绘制一个矩形 
清除：清除所有绘制的图形 
界面代码
```xml
 <cn.sddman.arcgistool.view.DrawGraphView
 android:id="@+id/arcgis_draw_tool"
 android:layout_width="wrap_content"
 android:layout_height="wrap_content"
 android:layout_alignParentRight="true"
 android:layout_marginTop="80dp"
 android:layout_marginRight="10dp">
 </cn.sddman.arcgistool.view.DrawGraphView>
```
java代码
```java
 DrawGraphView drawGraphView=findViewById(R.id.arcgis_draw_tool);
 arcgisToolManager.builderDrawGraphView(drawGraphView)
```
属性设置
```java
 arcgisToolManager.builderDrawGraphView(drawGraphView)
 .setButtonWidth(60)
 .setButtonHeight(40)
 .setBackground(R.color.colorAccent)
 .setSohwText(true)
 .setFontSize(12)
 .setFontColor(R.color.color444);
```
## 放大缩小控件：
界面代码
```xml
 <cn.sddman.arcgistool.view.ArcGisZoomView
 android:id="@+id/arcgis_zoom_btn"
 android:layout_width="wrap_content"
 android:layout_height="wrap_content"
 app:show_text="true"//是否显示文字；默认false
 app:zoom_in_text="放大"//放大按钮文字
 app:zoom_out_text="缩小"//缩小按钮文字
 app:zoom_font_color="@color/colorAccent"//设置文字颜色；默认gray
 app:zoom_font_size="12"//设置文字大小；默认12dp
 app:zoom_out_image="@drawable/zoomout"//设置缩小按钮图标
 app:zoom_in_image="@drawable/zoomin"//设置放大按钮图标
 app:isHorizontal="false"//是否水平显示，true水平,false垂直;默认false
 app:view_background="@drawable/round_corner"//设置整个控件背景，默认白色圆角矩形
 app:button_width="35dp"//设置每一个按钮宽度;默认35
 app:button_height="35dp"//设置每一个按钮高度;默认35
 >
 </cn.sddman.arcgistool.view.ArcGisZoomView>
```
java代码
```java
 ArcGisZoomView zoomBtn=(ArcGisZoomView)findViewById(R.id.arcgis_zoom_btn);
 arcgisToolManager.builderZoomView(zoomBtn);
```
java设置属性
```java
arcgisToolManager.builderZoomView(zoomBtn)
 .setZoomHeight(35)//设置每一个按钮高度;默认35
 .setZoomWidth(60)/设置每一个按钮宽度;默认35
 .setZoomBackground(R.drawable.round_corner)//设置整个控件背景，默认白色圆角矩形
 .isHorizontal(true)//是否水平显示，true水平,false垂直;默认false
 .setZoomOutImage(R.drawable.sddman_zoomout)//设置缩小按钮图标
 .setZoomInImage(R.drawable.sddman_zoomin)//设置放大按钮图标
 .setShowText(true)//是否显示文字；默认false
 .setZoomOutText("缩小")//缩小按钮文字
 .setZoomInText("放大")//放大按钮文字
 .setFontSize(12)//设置文字大小；默认12dp
 .setFontColor(R.color.colorMain)//设置文字颜色；默认gray
 .setZoomClickListener(new ZoomClickListener() {//按钮点击回调
 @Override
 public void zoomInClick(View view) {
 Toast.makeText(MainActivity.this,"zoom in",Toast.LENGTH_SHORT).show();
 }
 
 @Override
 public void zoomOutClick(View view) {
 Toast.makeText(MainActivity.this,"zoom out",Toast.LENGTH_SHORT).show();
 }
 });
```
## 地图旋转控件：
界面代码
```xml
 <cn.sddman.arcgistool.view.MapRotateView
 android:id="@+id/map_rotate_view"
 android:layout_width="wrap_content"
 android:layout_height="wrap_content"
 app:show_text="true"//是否显示文字；默认false
 app:zoom_font_color="@color/colorAccent"//设置文字颜色；默认gray
 app:zoom_font_size="12"//设置文字大小；默认12dp
 app:button_width="35dp"//设置每一个按钮宽度;默认35
 app:button_height="35dp"//设置每一个按钮高度;默认35
 app:view_background="@drawable/round_corner"//设置整个控件背景，默认白色圆角矩形
 app:map_rotate_text="旋转"//旋转按钮文字
 app:map_rotate_image="@drawable/sddman_measure_prev"//设置旋转按钮图标
 >
 </cn.sddman.arcgistool.view.MapRotateView>
```
java代码
```java
 MapRotateView mapRotateView=(MapRotateView)findViewById(R.id.map_rotate_view);
arcgisToolManager.builderRotateView(mapRotateView);
```
java设置属性
```java
arcgisToolManager.builderRotateView(mapRotateView)
 .setHeight(40)//设置每一个按钮宽度;默认35
 .setWidth(60)//设置每一个按钮宽度;默认35
 .setBackground(R.drawable.round_corner)//设置整个控件背景，默认白色圆角矩形
 .setRotateNum(-45)//设置每次旋转角度，负数逆时针旋转，正数顺时针旋转
 .setRotateImage(R.drawable.sddman_measure_prev)//设置旋转按钮图标
 .setRotateText("旋转")//旋转按钮文字
 .setShowText(true)//是否显示文字；默认false
 .setFontSize(16)//设置文字大小；默认12dp
 .setFontColor(R.color.colorMain)//设置文字颜色；默认gray
 .setMapRotateClickListener(new MapRotateClickListener() {//按钮点击回调
 @Override
 public void mapRotateClick(View view) {
 Toast.makeText(MainActivity.this,"Map Rotate",Toast.LENGTH_SHORT).show();
 }
 });
```
### ArcgisJSTool-for-Vue
([预览](http://rootvip.cn/map/#/index)，特殊原因JS版代码暂不开源，这里只提供展示)

ArcgisTool

ArcgisTool 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

ArcgisTool

ArcgisTool 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

Download README