NaviCoreUtil (JNaviCore SDK Documentation)

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

public final class NaviCoreUtil
extends java.lang.Object

引擎提供的工具类

嵌套类概要

嵌套类
限定符和类型	类和说明
`class`	`NaviCoreUtil.BaseDataState`
`class`	`NaviCoreUtil.DistanceUnit` 将距离转换为字符串时所使用的单位值枚举
`class`	`NaviCoreUtil.GisUnit` GIS地理信息系统中的单位制被一些工具函数使用

字段概要

字段
限定符和类型字段和说明

static int JUST_ANY_ANGLE
任意角度
一般来说表示当前角度未知，或者某些特殊的如摄像头角度为任意角度可拍摄

字段
限定符和类型	字段和说明
`static int`	`JUST_ANY_ANGLE` 任意角度一般来说表示当前角度未知，或者某些特殊的如摄像头角度为任意角度可拍摄

构造器概要

构造器
构造器和说明

NaviCoreUtil()

构造器
构造器和说明
`NaviCoreUtil()`

方法概要

所有方法静态方法具体方法
限定符和类型	方法和说明
`static int`	`angle(android.graphics.Point from, android.graphics.Point to)` 计算两个经纬度坐标点构成射线的角度，单位角度
`static java.lang.String`	`angle2DirectionString(int angle)` 将角度转换为表示方向的字符串，将360度均分为16个方向，比如东、东偏北、东北、北偏东、北等
`static byte[]`	`authBase64decode(java.lang.String base64Str)` 非标准的Base64解码函数，仅用于授权加密/解密。
`static byte[]`	`authDecryptFromFile(java.lang.String filePath)` 文件解密方法，提供引擎授权认证的解密功能。
`static java.lang.String`	`buildPathInPacket(java.lang.String path)` 在4.11.x及以后的引擎中，绘图相关的资源打包到packet.dat中，读取资源时需先调用此函数，根据资源相对路径补全在包中的完整路径资源相对路径及文件： --data/: 数据文件，包含world.pvf，世界缩略图用，客户端不需要调用 --icons/: 引擎所需的图标资源，id都小于1000 --models/: 3D模型文件，包含3D小车car_model.obj --map3_style_sheet.json: 3D地图配置文件 --map3ss_satellite.json: 卫星图配置文件 --poi_icons.png, poi_icons@h.png, poi_icons@m.png: POI图标文件 --street_view_logo.png: 街景图logo --stroke.png: PND使用的捷通手写资源文件
`static int`	`car2Map(int angle)` 将车的角度转换成地图中的角度，一般用在`NaviSession.Event.tracking` 消息中，将`NaviSessionData.carOri` 转换成地图中的角度，设置给相应的车对应的图标。
`static int`	`distance(android.graphics.Point p1, android.graphics.Point p2)` 计算两个经纬度坐标点的球面距离
`static DistanceStringInfo`	`distance2String(int distance, int distanceUnit, boolean withRound)` 将表示长度的整数转换成用于显示的字符串当前的语言和度量制不同时，得到的结果也会不同。
`static android.graphics.Point`	`encryptPoint(android.graphics.Point point)` 将84坐标转换为02坐标
`static java.lang.String`	`formatRelativePosition(android.graphics.Point origin, android.graphics.Point pt, int distanceUnit, boolean withRound)` 格式化两个点的相对位置，比如"东偏北300米","东北2.4km"
`static int`	`getBaseDataState()` 获取基础数据状态`NaviCoreUtil.BaseDataState`
`static DateTime[]`	`getSunriseSunsetTimeOfDay(DateTime datetime, android.graphics.Point pos)` 根据当前位置的经纬度和时间获取日出和日落时间注意：参数中的DateTime需要使用UTC时间，请自行转换。
`static void`	`invalidatePoint(android.graphics.Point p)` 将点设置为引擎中认定的无效值
`static boolean`	`isInvalidPoint(android.graphics.Point p)` 判断当前点是否为无效点
`static boolean`	`isNight(DateTime datetime, android.graphics.Point pos)` 根据当前经纬度和时间判断当前是否为夜晚注意：参数中的DateTime需要使用UTC时间，请自行转换。
`static android.graphics.Point`	`kcode2Point(java.lang.String kcode)` 将加密字符串转换为坐标
`static float`	`len2NdsLen(float len)` 经纬度坐标下的长度转换为NDS坐标下的长度
`static int`	`map2Car(int angle)` `NaviCoreUtil#car2Map(int)的反向转换`
`static float`	`ndsLen2Len(float ndsLen)` NDS坐标下的长度转换为经纬度坐标下的长度
`static java.lang.String`	`point2KCode(android.graphics.Point p)` 将制定的经纬度转换为加密字符串格式为：333-333-333，加密字串是由0~9个数字以及除了I和O以外的24个大写字母组成。
`static void`	`speak(java.lang.String text)` 将输入的字符串转换成语音播报, 如果连续调用，将会将未播报的字符串加入队列，依次播报。
`static void`	`stopSpeak()` 强制打断由`speak(String)`发起的语音播报请求，并清空请求队列

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

- 字段详细资料
  - JUST_ANY_ANGLE
```
public static final int JUST_ANY_ANGLE
```
    任意角度
    一般来说表示当前角度未知，或者某些特殊的如摄像头角度为任意角度可拍摄
    
    另请参阅:
    
    常量字段值
- 构造器详细资料
  - NaviCoreUtil
```
public NaviCoreUtil()
```
- 方法详细资料
  - distance2String
```
public static DistanceStringInfo distance2String(int distance,
                                                 int distanceUnit,
                                                 boolean withRound)
```
    将表示长度的整数转换成用于显示的字符串
    当前的语言和度量制不同时，得到的结果也会不同。
    
    当前为公制时，长度单位选用公里和米(或km、m):
    - 当distance大于等于100公里时，单位用公里，保留整数，如："2191公里"；
    - 当distance大于等于1公里时，单位用公里，保留一位小数（如小数部分为0，则只保留整数部分），如："32.4公里"；
    - 当distance小于1公里，大于等于150米时，单位用米，以50米步进。如："800米" "750米" "700米" ... "150米";
    - 当distance小于150米，大于15米时，以10米步进，如："140米" "130米"；
    - 当distance小于等于15米时，以1米为步进，如："14米" "13米".
    在此基础上四舍五入.
    
    当前为英制时，长度单位选用英里和英尺，逻辑同上。
    
    当前语言为中文且distanceUnit为NaviCoreUtil.DistanceUnit.normal 时，单位的名称使用汉字："公里"、"米"、"英里"、"英尺"，其他情况，单位的名称用英文字母
    其中"km"、"m"为引擎自定义字体中的字体
    要使用非引擎自定义字体，需要设置distanceUnit为NaviCoreUtil.DistanceUnit.english
    
    参数:
    
    distance - 表示长度的整型变量，单位：米
    
    distanceUnit - 控制输出的字符串所使用的单位的形式NaviCoreUtil.DistanceUnit 。比如："100"或"100米"或"100m"。
    
    withRound - 控制输出的字符串是否四舍五入。比如：375米是否显示为350米，目前英制不支持四舍五入。
    
    返回:
    
    用于显示的字符串和单位制DistanceStringInfo
    
    从以下版本开始:
    
    4.9.x
    
    另请参阅:
    
    DistanceStringInfo
  - angle
```
public static int angle(android.graphics.Point from,
                        android.graphics.Point to)
```
    计算两个经纬度坐标点构成射线的角度，单位角度
    
    参数:
    
    起点 -
    
    终点 -
    
    返回:
    
    两个经纬度坐标点构成射线的角度
  - distance
```
public static int distance(android.graphics.Point p1,
                           android.graphics.Point p2)
```
    计算两个经纬度坐标点的球面距离
    
    参数:
    
    p1 - 经纬度坐标1
    
    p2 - 经纬度坐标2
    
    返回:
    
    两个经纬度之间的球面距离
  - getBaseDataState
```
public static int getBaseDataState()
```
    获取基础数据状态NaviCoreUtil.BaseDataState
    
    返回:
    
    基础数据状态
    
    从以下版本开始:
    
    4.9.x
    
    另请参阅:
    
    NaviCoreUtil.BaseDataState
  - encryptPoint
```
public static android.graphics.Point encryptPoint(android.graphics.Point point)
```
    将84坐标转换为02坐标
    
    参数:
    
    point - 84经纬度坐标
    
    返回:
    
    02经纬度坐标
    
    从以下版本开始:
    
    4.9.x
    
    Notice:
    
    注意：需要引擎支持。
  - invalidatePoint
```
public static void invalidatePoint(android.graphics.Point p)
```
    将点设置为引擎中认定的无效值
    
    参数:
    
    p - 需要设置的点
  - isInvalidPoint
```
public static boolean isInvalidPoint(android.graphics.Point p)
```
    判断当前点是否为无效点
    
    参数:
    
    p - 需要判定的点
    
    返回:
    
    如果为无效点则返回true，否则返回false
  - point2KCode
```
public static java.lang.String point2KCode(android.graphics.Point p)
```
    将制定的经纬度转换为加密字符串
    格式为：333-333-333，加密字串是由0~9个数字以及除了I和O以外的24个大写字母组成。
    
    参数:
    
    p - 需要转换的经纬度
    
    返回:
    
    如果转换成功，返回加密字符串，转换失败则返回null
    
    另请参阅:
    
    kcode2Point(String)
    
    Notice:
    
    注意：此方法加密的经度跨度为：73~136，纬度跨度为：3~53，所以仅适用于中国境内。
  - kcode2Point
```
public static android.graphics.Point kcode2Point(java.lang.String kcode)
```
    将加密字符串转换为坐标
    
    参数:
    
    kcode - 加密字符串
    
    返回:
    
    如果能正常转换则返回经纬度坐标点，否则返回null
  - isNight
```
public static boolean isNight(DateTime datetime,
                              android.graphics.Point pos)
```
    根据当前经纬度和时间判断当前是否为夜晚
    注意：参数中的DateTime需要使用UTC时间，请自行转换。
    
    参数:
    
    datetime - 当前时间，UTC时间
    
    pos - 当前所在GPS位置
    
    返回:
    
    如果是黑天返回true，否则返回false
  - getSunriseSunsetTimeOfDay
    
    public static DateTime[] getSunriseSunsetTimeOfDay(DateTime datetime, android.graphics.Point pos)
    
    根据当前位置的经纬度和时间获取日出和日落时间
    注意：参数中的DateTime需要使用UTC时间，请自行转换。
    
    参数:
    
    datetime - 当前时间，UTC时间
    
    pos - 当前所在GPS位置
    
    返回:
    
    size固定为2的DateTime数组：index=0:日出时间, index=1:日落时间
  car2Map
  
  public static int car2Map(int angle)
  
  将车的角度转换成地图中的角度，一般用在NaviSession.Event.tracking 消息中，将NaviSessionData.carOri 转换成地图中的角度，设置给相应的车对应的图标。
  
  参数:
  
  angle - 车的角度
  
  返回:
  
  转换后车标在地图上的角度
  
  map2Car
  
  public static int map2Car(int angle)
  
  NaviCoreUtil#car2Map(int)的反向转换
  
  参数:
  
  angle - 车标在地图上的角度
  
  返回:
  
  车的角度
  
  buildPathInPacket
  
  public static java.lang.String buildPathInPacket(java.lang.String path)
  
  在4.11.x及以后的引擎中，绘图相关的资源打包到packet.dat中，读取资源时需先调用此函数，根据资源相对路径补全在包中的完整路径
  资源相对路径及文件：
  --data/: 数据文件，包含world.pvf，世界缩略图用，客户端不需要调用
  --icons/: 引擎所需的图标资源，id都小于1000
  --models/: 3D模型文件，包含3D小车car_model.obj
  --map3_style_sheet.json: 3D地图配置文件
  --map3ss_satellite.json: 卫星图配置文件
  --poi_icons.png, poi_icons@h.png, poi_icons@m.png: POI图标文件
  --street_view_logo.png: 街景图logo
  --stroke.png: PND使用的捷通手写资源文件
  
  参数:
  
  path - 资源相对路径，比如icons/104.png，map3_style_sheet.json等
  
  返回:
  
  返回补全后的路径，用此路径可以直接访问引擎提供的资源。传入路径为null、"."或".."时返回根目录
  
  从以下版本开始:
  
  4.11.x
  
  speak
  
  public static void speak(java.lang.String text)
  
  将输入的字符串转换成语音播报, 如果连续调用，将会将未播报的字符串加入队列，依次播报。
  
  参数:
  
  text - 需要播报的字符串
  
  stopSpeak
  
  public static void stopSpeak()
  
  强制打断由speak(String)发起的语音播报请求，并清空请求队列
  
  angle2DirectionString
  
  public static java.lang.String angle2DirectionString(int angle)
  
  将角度转换为表示方向的字符串，将360度均分为16个方向，比如东、东偏北、东北、北偏东、北等
  
  参数:
  
  angle - 角度，单位：度。以正东方向为0，逆时针方向为正方向。
  
  返回:
  
  表示方向的字符串，如 "东", "西南", "北偏东"
  
  formatRelativePosition
  
  public static java.lang.String formatRelativePosition(android.graphics.Point origin, android.graphics.Point pt, int distanceUnit, boolean withRound)
  
  格式化两个点的相对位置，比如"东偏北300米","东北2.4km"
  
  参数:
  
  origin - 相对原点
  
  pt - 目标点
  
  distanceUnit - 控制输出的字符串所使用的单位的形式NaviCoreUtil.DistanceUnit 。比如："100"或"100米"或"100m"。
  
  withRound - 控制输出的字符串是否四舍五入。比如：375米是否显示为350米，目前英制不支持四舍五入。
  
  返回:
  
  点pt相对于点origin的位置，比如"东偏北300米"
  
  len2NdsLen
  
  public static float len2NdsLen(float len)
  
  经纬度坐标下的长度转换为NDS坐标下的长度
  
  参数:
  
  len - 经纬度坐标下的长度
  
  返回:
  
  NDS坐标下的长度
  
  ndsLen2Len
  
  public static float ndsLen2Len(float ndsLen)
  
  NDS坐标下的长度转换为经纬度坐标下的长度
  
  参数:
  
  ndsLen - nds长度
  
  返回:
  
  经纬度坐标下的长度
  
  authBase64decode
  
  public static byte[] authBase64decode(java.lang.String base64Str)
  
  非标准的Base64解码函数，仅用于授权加密/解密。
  注意：此函数仅在 JNaviCoreConfig.USE_AUTH_DECRYPT 为true时可用，否则抛出异常，请确认此设置之后调用此方法。
  
  参数:
  
  base64Str - 输入的Base64 编码字符串，一般来自授权服务器于服务器
  
  返回:
  
  返回解析后的二进制数据，JNaviCoreConfig.DEBUG 为true且 JNaviCoreConfig.USE_AUTH_DECRYPT 为false时，返回null
  
  抛出:
  
  java.lang.RuntimeException
  
  authDecryptFromFile
  
  public static byte[] authDecryptFromFile(java.lang.String filePath)
  
  文件解密方法，提供引擎授权认证的解密功能。
  注意：此函数仅在 JNaviCoreConfig.USE_AUTH_DECRYPT 为true时可用，否则抛出异常，请确认此设置之后调用此方法。
  
  参数:
  
  filePath - 用于解密的问价名称全路径，绝对路径
  
  返回:
  
  返回解密后的二进制数据，JNaviCoreConfig.DEBUG 为true且 JNaviCoreConfig.USE_AUTH_DECRYPT 为false时，返回null
  
  抛出:
  
  java.lang.RuntimeException

类 NaviCoreUtil

嵌套类概要

字段概要

构造器概要

方法概要

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

字段详细资料

JUST_ANY_ANGLE

构造器详细资料

NaviCoreUtil

方法详细资料

distance2String

angle

distance

getBaseDataState

encryptPoint

invalidatePoint

isInvalidPoint

point2KCode

kcode2Point

isNight

getSunriseSunsetTimeOfDay

car2Map

map2Car

buildPathInPacket

speak

stopSpeak

angle2DirectionString

formatRelativePosition

len2NdsLen

ndsLen2Len

authBase64decode

authDecryptFromFile