中国移动通信 开发者社区

资料库


平台介绍 新手指引 业务合作
支付类能力
应用内计费
能力介绍 能力接口 示例代码 相关下载 常见问题
融合计费
能力介绍 电信计费资料报备 联通计费资料报备 相关下载
网页计费
能力介绍 开发指引 能力接口 相关下载 常见问题
用户信息类能力
统一认证
能力介绍 能力接口 相关下载 常见问题
有数能力
能力介绍 能力接口 相关下载 常见问题
通道类能力
流量能力
能力介绍
流量置换撮合服务
能力介绍
流量订购
能力介绍 相关下载
有推能力
能力介绍 AOI接口说明 AOE接口说明 相关下载 常见问题
云邮局
能力介绍 能力接口
飞信公众平台
能力介绍
飞信开放平台
能力介绍 能力接口
云服务类能力
VDC
能力介绍
灵犀云
能力介绍 能力接口 示例代码 常见问题
云安全
能力介绍
GIS服务
能力接口 相关下载 常见问题
定位服务
能力接口 相关下载 常见问题
远程测试
能力介绍
机型信息库
能力介绍
云存储
能力介绍 相关下载
数字内容类能力
IP合作
能力介绍
推广接入
概述 渠道开放合作 首发联盟 IAP游戏联运 开发者自推广 MM品牌店 飞信 飞信同窗 139邮箱 无线城市 移动微博 彩云
应用发布
应用发布流程 常见问题FAQ

GIS服务接口

申请能力

目录

[隐藏]

1、接口总览

表1-1 AndroidGIS能力服务API

API分类类别 API分类描述 API中文简称 API英文名 API功能详细描述 备注
- 地图上的一个点 地点类 GISPoint 点对象 {packageBase }.vo
- 地图控制接口 地图控制接口 IMapController 地图控制接口 {packageBase}. interfaces
- 地图视图类 地图视图类 MapView 地图视图类 { packageBase}.gridmap
主要对象功能接口 搜索服务接口 搜索服务接口 ISearchSevice 搜索服务接口 { packageBase}. interfaces
主要对象功能接口 路线规划服务接口 路线规划服务接口 IRouteSevice 路线规划服务接口 { packageBase}. interfaces
主要对象功能接口 测算服务接口 测算服务接口 ICaculateService 测算服务接口 { packageBase}. interfaces
主要对象功能接口 取得定位服务接口 取得定位服务接口 ILocationService 取得定位服务接口 { packageBase}. interfaces
主要对象功能接口 元数据服务接口 元数据服务接口 IMetaDataService 元数据服务接口 { packageBase}. interfaces
主要对象功能接口 地理编码服务接口 地理编码服务接口 IGeocodeService 地理编码服务接口 { packageBase}. interfaces
主要对象功能接口 逆地理编码服务接口 逆地理编码服务接口 IReverseGeocodeService 逆地理编码服务接口 { packageBase}. interfaces
主要对象功能接口 Service工厂 Service工厂 ServiceFactory Service工厂 { packageBase}. interfaces
设施检索类 - 检索结果类 SearchResult 检索结果 检索结果
设施检索类 - 热点信息值对象 GISPOI 热点信息值对象 热点信息值对象
设施检索类 - 设施检索参数对象 POISearchOpt 设施检索参数对象 设施检索参数对象
设施检索类 - 周边检索参数对象 RoundSearchOpt 周边检索参数对象 周边检索参数对象
算路类 - 算路或公交条件 RouteConditionDef 算路或公交条件 算路或公交条件
算路类 - 算路参数对象 RouteOpt 算路参数对象 算路参数对象
算路类 - 算路结果对象 RouteResult 算路结果对象 算路结果对象
算路类 - 公交换乘结果对象 BusRouteResult 公交换乘结果对象 公交换乘结果对象
算路类 - 公交换乘线路对象 ChangeLine 公交换乘线路对象 公交换乘线路对象
地理编码类 - 算路或公交条件 GisRequest 算路或公交条件 算路或公交条件
地理编码类 - 算路或公交条件 GeocodedAddress 算路参数对象 算路参数对象
元数据服务类 - 元数据格式 MetaData 元数据格式 元数据格式

2、 接口详细描述

Security接口说明

表1-2 Security接口属性

No 可见性 Property 说明
1 public String url 服务地址
2 public String pid 用户伪码
3 public String token 授权Token
4 public String FA-PId  

GISPoint接口说明

表1-3 GISPoin接口构造方法

No 可见性 Constructor 抛出异常 说明
1 public GISPoint( ) 创建地点对象。
2 public GISPoint(floatlon,floatlat) 创建地点对象。用经纬度形式表示

表1-4 GISPoin接口属性

No 可见性 Property 说明
1 public float lat 纬度用标准形式表示。
2 public float float 经度用标准形式表示。
3 public String name 标示当前经纬度对应的名称

表1-5 GISPoin接口方法

No 可见性 返回值 Method 抛出异常 说明
1 public void setLonLat(floatlon,floatlat) 用标准形式指定纬度经度、设定地点。
2 public float [] getLonLat() 返回经纬度值

IMapController接口说明

表1-6 IMapController接口方法

No 可见性 返回值 Method 抛出异常 说明
1 public void locate2(GISPoint arg) Exception 在当前层定位到 目标经纬度,展开地图
2 public void locate2(GISPoint arg,int level) Exception Lat 目标维度,lon目标经度,level目标层,方法逻辑为:定位到目标层的目标经纬度展开地图
3 public int getCurLevel () Exception 取得地图当前层
4 public void zoom2level(int level) Exception 以当前地图中心点为中心,将地图缩放到level层
5 public GISPoint getScreenCenterlatlon() Exception 取得地图中心点的经纬度
6 public void move(int x,int y) Exception 将地图水平平移x像素,垂直平移y像素
7 public void drawLine(GISPoint[]  line) Exception 在地图上画线,line 为 经纬度坐标数组
8 public void drawPic(GISPoint poi,Image image) Exception 在地图经纬度为x,y的点上画图片image
10 public void clearLines() Exception 清楚地图上的所有线
11 public viod clearImages() Exception 清除地图上所有的图片
12 public int[] latLong2pixelPt(float latitude, float longitude) Exception 地点经纬度对应当前屏幕的坐标
13 public GISPoint pixels2latLong(int xPixel, int yPixel) Exception 取得屏幕坐标对应的经纬度
14 public void addView(View view, GISPoint poi, Align centerOrbottom) Exception 向地图中加入View
15 public void clearViews() Exception 清除视图对象
16 public void preMove(final int x, final int y) Exception 移动而不刷新地图

MapView接口说明

表1-7 MapView接口构造方法

No 可见性 Constructor 抛出异常 说明
1 public MapView(Security arg ) Exception 创建地图对象。

表1-8 MapViewr接口方法

No 可见性 返回值 Method 抛出异常 说明
1 public IMapController getMapController() Exception 取得控制对象对象

ISearchSevice接口说明

表1-9 ISearchSevice接口构造方法

No 可见性 Constructor 抛出异常 说明
1 public ServiceFactory (Security arg ) Exception -

表1-10 ISearchSevice接口方法

No 可见性 返回值 Method 抛出异常 说明
1 public ISearchSevice getSearchService() Exception 取检索服务接口
2 public IRouteSevice getRouteService() Exception 取得算路服务接口
3 public ICaculateService getCaculateService() Exception 取得测算服务接口
4 public IMetaDataService getMetaDataService() Exception 取得元数据接口
5 public IGeocodeService getGeocodeService() Exception 取得地理服务接口
6 public IReverseGeocodeService getRGeocodeService() Exception 取得逆地理服务接口
7 public ILocationService getLocationService() Exception 取得cell-id定位服务接口

SearchResult接口说明

表1-11 SearchResult接口构造方法

No 可见性 Constructor 抛出异常 说明
1 public SearchResult() - 检索结果对象。

表1-12 SearchResult接口属性

No 可见性 属性 类型 说明
1 public status int 执行状态,0表示成功,-1表示失败
2 public size int 返回结果长度
3 public Results List 结果list,list中的Object为GISPOI对象

GISPOI接口说明

表1-13 GISPOI接口构造方法

No 可见性 Constructor 抛出异常 说明
1 public GISPOI() - 创建地图对象。

表1-14 GISPOI接口属性 (1)

No 可见性 属性 类型 说明
1 public poiName String POI名称
2 public poiLon string 经度坐标
3 public poiLat string 纬度坐标
4 public Province String 所属省
5 public city String 所属市
6 public district String 所属行政区
7 public otype String 大分类
8 public stype String 中分类
9 public atype String 小分类
10 public webSite String 网址
11 public email String 电子邮件
12 public fax String 传真
13 public poiType String Poi类型
14 public tel String 电话
15 public cityCode String 区号

表1-15 GISPOI接口属性 (2)

No 可见性 属性 类型 说明
1 public prov String 所属省名称
2 public city String 所属市名称
3 public maxCount int 返回结果数量的上限
4 public keyword String 关键字

RoundSearchOpt接口说明

表1-16 RoundSearchOpt接口构造方法

No 可见性 Constructor 抛出异常 说明
1 public RoundSearchOpt() - -

表1-17 RoundSearchOpt接口属性

No 可见性 属性 类型 说明
1 public keyword String 关键字名称
2 public city String 所属市名称
3 public otype String 大分类
4 public stype String 中分类
5 public atype String 小分类
6 public maxCount int 返回结果数量的上限
7 public center GISPoint 中心点坐标
8 public radius int 检索半径

ISearchService接口说明

表1-18 ISearchService接口方法

No 可见性 返回値 Method 抛出异常 说明
1 public SearchResult searchPOI(POISearchOpt arg) Exception Poi检索接口
2 public SearchResult searchRound(RoundSearchOpt arg) Exception 周边检索接口

RouteOpt接口说明

表1-19 RouteOpt接口构造方法

No 可见性 Constructor 抛出异常 说明
1 public RouteOpt() - -

表1-20 RouteOpt接口属性

No 可见性 属性 类型 说明
1 public StartPointPosition GISPoint 出发地经纬度
2 public endPointPosition GISPoint 目的地经纬度
3 public routeCondition String 条件

RouteResult接口说明

表1-21 RouteResult接口构造方法

No 可见性 Constructor 抛出异常 说明
1 public RouteResult() - -

表1-22 RouteResult接口属性

No 可见性 属性 类型 说明
1 public TotalTime String 总计用时
2 public TotalDistance String 总计路程
3 public RouteInstruction List 道路描述
4 public navipoints List 经纬度数组信息
5 public status int 执行状态,0成功,-1失败

ChangeLine接口说明

表1-23 ChangeLine接口构造方法

No 可见性 Constructor 抛出异常 说明
1 public ChangeLine() - -

表1-24 ChangeLine接口属性

No 可见性 属性 类型 说明
1 public Stations List 站点列表
2 public points List 线路经纬度点列表
3 public lineProps < Prop >List 公交线路属性。

BusRouteResult接口说明

表1-25 BusRouteResult接口构造方法

No 可见性 Constructor 抛出异常 说明
1 public BusRouteResult() - -

表1-26 BusRouteResult接口属性

No 可见性 属性 类型 说明
1 public introduction String 换乘方案描述
2 public changeLines List 换乘线路列表
3 public bindingPointA GISPoint 线路外矩形左上角点经纬度
4 public bindingPointB GISPoint 线路外矩形右下角点经纬度
5 public planProps List 换乘线路属性列表

IRouteService接口说明

表1-27 IRouteService接口构造方法

No 可见性 返回値 Method 抛出异常 说明
1 public RouteResult getRouteResult(RuteOpt arg) Exception 路径计算接口
2 public < BusRouteResult >List getBusRouteResult(RuteOpt arg) Exception 公交检索接口

GisGeoRequest接口说明

表1-28 GisGeoRequest接口构造方法

No 可见性 Constructor 抛出异常 说明
1 public GisGeoRequest() - -

表1-29 GisGeoRequest接口属性

No 可见性 属性 类型 说明
1 public clientId String 终端Id
2 public password String 终端密码
3 public province String 所在省名称
4 public city String 所在市名称
5 public streetName String 街道名称

GeocodedAddress接口说明

表1-30 GeocodedAddress接口构造方法

No 可见性 Constructor 抛出异常 说明
1 public GeocodedAddress() - -

表1-31 GeocodedAddress接口属性

No 可见性 属性 类型 说明
1 public point GISPoint 在结果中表示经纬度
2 public streetName String 街道名称
3 public province String 所在省名称
4 public city String 所在市名称
5 public dist String 所在区

IGeocodeService接口说明

表1-32 IGeocodeService接口构造方法

No 可见性 返回値 Method 抛出异常 说明
1 public GeocodedAddress gecodeAddress(GisGeoRequest arg) Exception 根据给定的行政区域信息及街道名称进行街道检索

IReverseGeocodeService接口说明

表1-33 IReverseGeocodeService接口构造方法

No 可见性 返回値 Method 抛出异常 说明
1 public ReverseGeocodeResult getReCode (GISPoint point) Exception 根据当前经纬度取得地理信息

IcaculateService接口说明

表1-34 IcaculateService接口构造方法

No 可见性 返回値 Method 抛出异常 说明
1 public double getDistance (GISPoint a,GISPoint b,String UOM) Exception 计算地球上两点的球面距离。UOM距离单位:千米、米、分米、英里、码、英尺
2 public double getDistance(List,String uom) Exception 计算地球上多个点连接成的曲线线段长度。
3 public double getRoundArea (double radius,GISPoint center, String uom) Exception 计算几何圆形的面积。Radius 标示半径,center为圆中心点Unit面积单位:平方千米、平方米、平方分米、平方英里、平方码、平方英尺、公顷、亩
4 public double getArea(List list,String uom) Exception 计算几何图形的面积。List是经纬度数组,表示要计算图形的范围。Unit面积单位:平方千米、平方米、平方分米、平方英里、平方码、平方英尺、公顷、亩
5 public double getEllipseArea (List list,String uom) Exception 计算几何椭圆形的面积。List是经纬度数组,表示要计算图形的范围。Unit面积单位:平方千米、平方米、平方分米、平方英里、平方码、平方英尺、公顷、亩

MetaData接口说明

表1-35 MetaData接口构造方法

No 可见性 Constructor 抛出异常 说明
1 public MetaData()   检索结果对象。

表1-36 MetaData接口属性

No 可见性 属性 类型 说明
1 public category String category值
2 public name String 文字值
3 public type String 分类
4 public subType String 子分类

IMetaDataService接口说明

表1-37 IMetaDataService接口方法

No 可见性 返回値 Method 抛出异常 说明
1 public < MetaData >List getOType () Exception 返回大分类。
2 public < MetaData >List getSType(MetaData otype) Exception 返回指定大分类的中分类。
3 public < MetaData >List getAType(MetaData otype,MetaData  stype) Exception 小分类数据。
4 public < String >List getProvince () Exception 返回所有省。
5 public < String >List getCity(String province) Exception 返回省内的所有城市
6 public < String >List getDistrict(String province, String city) Exception 返回市内的行政区

LocationResult接口说明

表1-38 LocationResult接口构造方法

No 可见性 Constructor 抛出异常 说明
1 public LocationResult () - 检索结果对象。

表1-39 LocationResult接口属性

No 可见性 属性 类型 说明
1 public desc String 错误描述
2 public code String 区号
3 public province String 省信息
4 public city String 是信息
5 public area String 区信息
6 public point GISPoint 经纬度信息

ISearchService接口说明

表1-40 ISearchService接口方法

No 可见性 返回値 Method 抛出异常 说明
1 public GISPoint getDefPoint (GISPoint point) Exception 得到单点偏转经纬度坐标点
2 public GISPoint[] getDefPoints(GISPoint[] points) Exception 得到多点偏转经纬度坐标点

IDeflectioService接口说明

表1-41 IDeflectioService接口方法

No 可见性 返回値 Method 抛出异常 说明
1 public GISPoint getDefPoint (GISPoint point) Exception 得到单点偏转经纬度坐标点
2 public GISPoint[] getDefPoints(GISPoint[] points) Exception 得到多点偏转经纬度坐标点

3、错误代码统一定义

表1-42 错误代码

结果码 描述 原码
0 Success 成功 0
8000 安全模块内部错误 8000
8001 安全参数格式非法 8001
8002 非法应用或应用不可用 8002
8005 计数器过期失效 8005
8010 应用类型标识非法 8010
8011 生成用户伪码失败 8011
8012 生成或保存安全数据失败 8012
8013 敏感数据加密存取失败 8013
8016 新增应用信息失败 8016
8101 非法终端调用或终端不可用 8003
8102 APPKEY校验Ter授权Token无效 8004
8103 TESTKEY校验Ter授权Token无效 8004
8104 校验MAC指纹无效 8007
8105 解码IMSI值错误 8008
8106 校验会话ID无效 8009
客服