WorldManager (JNaviCore SDK Documentation)

java.lang.Object
- com.mapbar.mapdal.WorldManager

```
public class WorldManager
extends java.lang.Object
```
世界管理器
用来管理当前的国家、城市、行政区划关系
另请参阅:

WmrObject

Notice:

注意：WorldManager的使用需要依赖base.dat文件，此文件分为两种：精简版和完整版。
精简版：仅满足行政区划功能，不提供行政区划边界获取等高级功能，一般直接打包在应用程序中(对于Android来说打包在APK中的assets/ navicore/cn目录下)，主要提供纯在线模式使用。
完整版：提供所有接口的所有功能，需要额外的数据文件支持，即，[应用程序根目录]/cn/base.dat。
使用精简版将导致部分接口不可用。

Example:
```
 // 城市列表的获取
 
 
```

嵌套类概要

嵌套类
限定符和类型类和说明

class WorldManager.DataState
数据状态信息枚举

class WorldManager.DistrictLevel
行政区划级别

嵌套类
限定符和类型	类和说明
`class`	`WorldManager.DataState` 数据状态信息枚举
`class`	`WorldManager.DistrictLevel` 行政区划级别

方法概要

所有方法静态方法实例方法具体方法已过时的方法
限定符和类型	方法和说明
`void`	`cleanup()` 清理`WorldManager`
`boolean`	`dataExist(int id)` 分省数据时，根据ID判断对应省份的数据是否已经下载了
`int`	`get0achinaNode()` 判断当前是否有全国节点
`int`	`getAdminCodeByWmrId(int wmrId)` 获取对应行政区编码
`java.lang.String`	`getCompleteRegionName(android.graphics.Point pt, int level)` 根据指定的经纬度坐标返回其所在的行政区划名称
`java.lang.String`	`getDataFileWithoutExt(int id)` 根据指定的ID，返回其对应的不带扩展名的数据文件路径使用数据文件时，尽量用本函数来构造数据文件名，而不要在代码中写死。
`int`	`getDataState(int id)` 根据城市ID(ID可以是省，是城市，或是区县)返回当前城市所使用的数据的状态信息`WorldManager.DataState`
`int`	`getIdByAdminCode(int adminCode)` 根据行政区划编码返回当前行政区划ID
`int`	`getIdByAdminCodeStr(java.lang.String adminCode)` 根据行政区划编码字符串获取行政区划Id
`int`	`getIdByPosition(android.graphics.Point pt)` 获取该位置所属的区县级ID
`static WorldManager`	`getInstance()` 获取`WorldManager`单例对象
`int`	`getPedIdByPosition(android.graphics.Point point)` 根据经纬度坐标获取指定城市的ID，此处获取的ID是带有PED文件的ID，一般来说是城市、直辖市以及特别行政区的ID
`DistrictInfo`	`getPedObjArray(int id)` 返回指定Id的行政区划的所有包含PED文件的子孙节点Id集合不判断输入的Id本身是否含有Ped文件
`java.lang.String`	`getRegionNameByPosition(android.graphics.Point p, int level)` 获取行政区划名称
`int`	`getRoot()` 获取根节点对象ID
`android.graphics.Rect`	`getWorldBound()` 获取 World Manager 中整个数据的包络盒
`int`	`has0achinaNode()` 已过时。
`void`	`init()` 初始化`WorldManager` 必须在程序初始化的时候初始化，且应该仅初始化一次
`boolean`	`isInited()` `WorldManager`是否已经初始化
`int[]`	`queryAvfObjectIds(android.graphics.Rect area, int maxNum)` 获取显示数据包络盒与area有重叠的行政区划的ID
`int[]`	`queryByKeywordOrPY(int id, java.lang.String kwandPY, int maxNum, int level)` 根据关键字或拼音查询相关的城市Id
`int[]`	`queryPoiObjectIds(android.graphics.Rect area, int maxNum)` 获取搜索数据包络盒与area有重叠的行政区划的ID
`PoiWmrObj[]`	`queryPoiWmrObj(android.graphics.Point pt, int range, int maxNum)` 获取用于POI周边搜索的 world manager 节点信息`PoiWmrObj` 获取包络盒到中心点距离小于搜索范围的那些有搜索数据的 world manager 节点信息，并按照从小到大的顺序储存在返回结果中，如果要求的节点数目大于 maxNum，则只获取最近的 maxNum条信息(距离相同的以 WmrObjId值小的优先)

从类继承的方法 java.lang.Object
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- 方法详细资料
  - getInstance
```
public static WorldManager getInstance()
```
    获取WorldManager单例对象
    
    返回:
    
    返回WorldManager对象实例
  - isInited
```
public boolean isInited()
```
    WorldManager是否已经初始化
    
    返回:
    
    true表示已初始化, false时未初始化
  - init
```
public void init()
```
    初始化WorldManager
    必须在程序初始化的时候初始化，且应该仅初始化一次
  - cleanup
```
public void cleanup()
```
    清理WorldManager
  - getRoot
```
public int getRoot()
```
    获取根节点对象ID
    
    返回:
    
    根节点ID
  - getIdByAdminCode
```
public int getIdByAdminCode(int adminCode)
```
    根据行政区划编码返回当前行政区划ID
    
    参数:
    
    adminCode - 行政区划编码
    
    返回:
    
    行政区划ID
  - queryAvfObjectIds
```
public int[] queryAvfObjectIds(android.graphics.Rect area,
                               int maxNum)
```
    获取显示数据包络盒与area有重叠的行政区划的ID
    
    参数:
    
    area - 指定区域
    
    maxNum - 最大结果数
    
    返回:
    
    返回符合要求且小于等于最大结果数的ID数组
  - queryPoiObjectIds
```
public int[] queryPoiObjectIds(android.graphics.Rect area,
                               int maxNum)
```
    获取搜索数据包络盒与area有重叠的行政区划的ID
    
    参数:
    
    area - 指定区域
    
    maxNum - 最大结果数
    
    返回:
    
    返回符合要求且小于等于最大结果数的ID数组
  - queryPoiWmrObj
```
public PoiWmrObj[] queryPoiWmrObj(android.graphics.Point pt,
                                  int range,
                                  int maxNum)
```
    获取用于POI周边搜索的 world manager 节点信息PoiWmrObj
    获取包络盒到中心点距离小于搜索范围的那些有搜索数据的 world manager 节点信息，
    并按照从小到大的顺序储存在返回结果中，如果要求的节点数目大于 maxNum，则只获取最近的
    maxNum条信息(距离相同的以 WmrObjId值小的优先)
    
    参数:
    
    pt - 周边搜索中心点
    
    range - 周边搜索的范围
    
    maxNum - 获取的最大范围
    
    返回:
    
    包络盒到pt距离小于range的那些有搜索数据的 world manager 节点PoiWmrObj对象
  - getCompleteRegionName
```
public java.lang.String getCompleteRegionName(android.graphics.Point pt,
                                              int level)
```
    根据指定的经纬度坐标返回其所在的行政区划名称
    
    参数:
    
    pt - 指定的经纬度坐标
    
    level - 要获取得到的行政区区划级别
    3：省一级，如：“安徽”，“北京市”
    2：地级市一级，如：“安徽滁州市”，“北京市”
    1：区县一级，如：“安徽滁州市凤阳县”，“北京市西城区”
    
    返回:
    
    得到的行政区划名称
  - getDataFileWithoutExt
```
public java.lang.String getDataFileWithoutExt(int id)
```
    根据指定的ID，返回其对应的不带扩展名的数据文件路径
    使用数据文件时，尽量用本函数来构造数据文件名，而不要在代码中写死。
    对于纯国内数据，id 为 0 时得到的结果是：L"china/china"，
    id 为 1 时得到：L"china/0beijing/0beijing"
    对于多国数据，如当前国家为印度，id 为 0 时得到的结果将会是：L"in/india/india"。
    
    参数:
    
    id - 指定的行政区划ID
    
    返回:
    
    不带扩展名的文件路径
  - getWorldBound
```
public android.graphics.Rect getWorldBound()
```
    获取 World Manager 中整个数据的包络盒
    
    返回:
    
    World Manager 中整个数据的包络盒，也就是根节点的包络盒
  - getIdByPosition
```
public int getIdByPosition(android.graphics.Point pt)
```
    获取该位置所属的区县级ID
    
    参数:
    
    pt - 指定位置的经纬度坐标
    
    返回:
    
    返回该位置所属的区县级ID，如果获取失败，返回WmrObject.INVALID_ID
  - dataExist
```
public boolean dataExist(int id)
```
    分省数据时，根据ID判断对应省份的数据是否已经下载了
    
    参数:
    
    id - 省ID
    
    返回:
    
    如果已经存在则返回true，否则返回false
  - has0achinaNode
```
public int has0achinaNode()
```
    已过时。
    
    判断当前是否有全国节点，接口已废弃，使用get0achinaNode()
    
    返回:
    
    如果存在，返回全国节点Id，如果不存在，返回无效Id
  - get0achinaNode
```
public int get0achinaNode()
```
    判断当前是否有全国节点
    
    返回:
    
    如果存在，返回全国节点Id，如果不存在，返回无效Id
  - queryByKeywordOrPY
```
public int[] queryByKeywordOrPY(int id,
                                java.lang.String kwandPY,
                                int maxNum,
                                int level)
```
    根据关键字或拼音查询相关的城市Id
    
    参数:
    
    id - 搜索范围Id，最大为全国，即根节点Id
    
    kwandPY - 所要查询城市的关键字或拼音
    
    maxNum - 最大查找结果数
    
    level - 返回的id中所包含的行政区划级别。如：
    1、level = WorldManager.DistrictLevel.province: 只获取level= WorldManager.DistrictLevel.province的行政区划id，如:"安徽省", "北京市"等所有省、直辖市、特别行政区
    2、level = WorldManager.DistrictLevel.city: 只获取level= WorldManager.DistrictLevel.city的id，如:"滁州市", "西城区"，"指山市"等
    3、level = WorldManager.DistrictLevel.village: 只获取level= WorldManager.DistrictLevel.village的id，如 "凤阳县"
    4、level = WorldManager.DistrictLevel.pedAdmin：只获取包含ped文件的行政区划id，即：特别行政区和所有level= WorldManager.DistrictLevel.pedAdmin的行政区划
    5、level = WorldManager.DistrictLevel.all：返回所有的搜索到的id
    6、level可以按位或操作，如: level = WorldManager.DistrictLevel.village | WorldManager.DistrictLevel.pedAdmin | WorldManager.DistrictLevel.city :获取的是所有的除去"中国"、所有省以外的所有行政区划
    
    返回:
    
    返回所有匹配的结果Id集合
  - getRegionNameByPosition
```
public java.lang.String getRegionNameByPosition(android.graphics.Point p,
                                                int level)
```
    获取行政区划名称
    
    参数:
    
    p - 制定位置经纬度坐标
    
    level - 所要获取的区县级别WorldManager.DistrictLevel
    
    返回:
    
    返回行政区划名称字符串，如果未获取到或者不支持此方法，那么将返回null
  - getIdByAdminCodeStr
```
public int getIdByAdminCodeStr(java.lang.String adminCode)
```
    根据行政区划编码字符串获取行政区划Id
    
    参数:
    
    adminCode - 行政区划编码字符串
    
    返回:
    
    行政区划Id
  - getPedObjArray
```
public DistrictInfo getPedObjArray(int id)
```
    返回指定Id的行政区划的所有包含PED文件的子孙节点Id集合
    不判断输入的Id本身是否含有Ped文件
    
    参数:
    
    id - 所要查询的行政区划的Id
    
    返回:
    
    结果集
  - getPedIdByPosition
```
public int getPedIdByPosition(android.graphics.Point point)
```
    根据经纬度坐标获取指定城市的ID，此处获取的ID是带有PED文件的ID，一般来说是城市、直辖市以及特别行政区的ID
    
    参数:
    
    point - 经纬度坐标
    
    返回:
    
    城市ID
    
    从以下版本开始:
    
    4.9.x
  - getDataState
```
public int getDataState(int id)
```
    根据城市ID(ID可以是省，是城市，或是区县)返回当前城市所使用的数据的状态信息WorldManager.DataState
    
    参数:
    
    id - 城市ID
    
    返回:
    
    如果WorldManager没有被正确初始化了，将返回 WorldManager.DataState.uninitialized，否则返回 WorldManager.DataState中其他状态
  - getAdminCodeByWmrId
```
public int getAdminCodeByWmrId(int wmrId)
```
    获取对应行政区编码
    
    返回:
    
    行政区划编码

类 WorldManager

嵌套类概要

方法概要

从类继承的方法 java.lang.Object

方法详细资料

getInstance

isInited

init

cleanup

getRoot

getIdByAdminCode

queryAvfObjectIds

queryPoiObjectIds

queryPoiWmrObj

getCompleteRegionName

getDataFileWithoutExt

getWorldBound

getIdByPosition

dataExist

has0achinaNode

get0achinaNode

queryByKeywordOrPY

getRegionNameByPosition

getIdByAdminCodeStr

getPedObjArray

getPedIdByPosition

getDataState

getAdminCodeByWmrId