awk_map.h 文件参考

#include <stddef.h>
#include <stdint.h>
#include <stdlib.h>
#include <stdbool.h>
#include "awk_map_defines.h"
#include "awk_adapter.h"

浏览源代码.

结构体
struct	awk_map_render_callback_t
	地图渲染回调 更多...
struct	awk_map_download_callback_t
	地图下载回调 更多...
struct	awk_map_tile_download_info_t
	瓦片下载信息 更多...
struct	awk_map_tile_download_callback_t
	瓦片下载回调 更多...
struct	awk_map_offline_gdb_adcode_t
	离线数据下载类型中adcode下载相关 更多...
struct	awk_map_offline_gdb_location_t
	离线数据下载类型经纬度下载相关 更多...
struct	awk_map_offline_gdb_info_t
	下载信息 更多...
struct	awk_map_offline_gdb_query_result_t
	查询下载的结果 更多...

类型定义
typedef int(*	track_parser) (const char *track_data, size_t length, awk_map_track_info_t *result_track)
	自定义轨迹解析器

枚举
enum	awk_map_tile_type_t { AWK_MAP_TILE_TYPE_TILE = 0 , AWK_MAP_TILE_TYPE_POI = 1 }
enum	awk_map_offline_type { OFFLINE_GDB_UNKNOWN , OFFLINE_GDB_ADCODE , OFFLINE_GDB_LOCATION_RANGE , OFFLINE_GDB_TILE_DONWLOAD }
	离线数据下载类型 更多...

函数
int32_t	awk_map_create_view (awk_map_view_param_t param)
	创建地图mapview，方法的调用需要在主流程线程中
int32_t	awk_map_destroy_view (uint32_t map_id)
	销毁地图mapview，方法的调用需要在主流程线程中
int32_t	awk_map_do_render (void)
	地图绘制，方法的调用需要在主流程线程中
int32_t	awk_map_pause_render (uint32_t map_id)
	将map_id对应的地图暂停绘制，方法的调用需要在主流程线程中
int32_t	awk_map_resume_render (uint32_t map_id)
	将map_id对应的地图恢复绘制，方法的调用需要在主流程线程中
int32_t	awk_map_add_texture (const awk_map_texture_data_t *texture_data)
	添加纹理数据，方法的调用需要在主流程线程中
int32_t	awk_map_update_texture (uint32_t texture_id, const awk_map_texture_data_t *texture_data)
	更新纹理数据，方法的调用需要在主流程线程中
int32_t	awk_map_remove_texture (uint32_t texture_id)
	移除纹理数据，方法的调用需要在主流程线程中
int32_t	awk_map_init_point_overlay (awk_map_point_overlay_t *point_overlay)
	初始化点覆盖物的结构体，方法的调用需要在主流程线程中
int32_t	awk_map_init_line_overlay (awk_map_polyline_overlay_t *line_overlay)
	初始化线覆盖物的结构体，方法的调用需要在主流程线程中
int32_t	awk_map_init_polygon_overlay (awk_map_polygon_overlay_t *polygon_overlay)
	初始化面覆盖物的结构体，方法的调用需要在主流程线程中
int32_t	awk_map_add_overlay (uint32_t map_id, awk_map_base_overlay_t *overlay)
	添加覆盖物，方法的调用需要在主流程线程中
int32_t	awk_map_update_overlay (uint32_t map_id, awk_map_base_overlay_t *overlay)
	更新覆盖物，方法的调用需要在主流程线程中
int32_t	awk_map_remove_overlay (uint32_t map_id, uint32_t overlay_id)
	移除覆盖物，方法的调用需要在主流程线程中
const awk_map_base_overlay_t *	awk_map_find_overlay (uint32_t map_id, uint32_t overlay_id)
	根据overlay_id查找覆盖物信息，方法的调用需要在主流程线程中
uint32_t	awk_map_get_overlay_count (uint32_t map_id)
	获取map_id对应的地图所有覆盖物的数量，方法的调用需要在主流程线程中
awk_map_track_info_t *	awk_map_track_navi_parse_gpx (const char *gpx_data, size_t length)
	解析gpx
void	awk_map_track_navi_parse_track_info_free (awk_map_track_info_t *track_info)
	析构track info
int32_t	awk_map_init_track_navi_overlay (awk_map_track_navi_overlay_t *overlay)
	初始化轨迹导航覆盖物
int32_t	awk_map_track_navi_add_overlay (uint32_t map_id, awk_map_track_navi_overlay_t *overlay)
	添加轨迹导航覆盖物
int32_t	awk_map_track_navi_remove_overlay (uint32_t map_id, uint32_t overlay_id)
	移除轨迹导航覆盖物
void	awk_map_track_navi_update_real_point (uint32_t map_id, awk_map_coord2d_t point, float bear, awk_map_track_navi_overlay_t *overlay)
	更新真实点
double	awk_map_track_navi_get_distance (uint32_t map_id, awk_map_coord2d_t point, awk_map_track_point_type point_type, awk_map_track_navi_overlay_t *overlay)
	获取距离,获取最近的一个类型点距离
const awk_map_base_overlay_t *	awk_map_get_overlay (uint32_t map_id, uint32_t index)
	根据索引获取map_id对应地图的覆盖物，方法的调用需要在主流程线程中
int32_t	awk_map_set_view_port (uint32_t map_id, awk_map_view_port_t view_port)
	设置地图视口，方法的调用需要在主流程线程中
int32_t	awk_map_set_render_callback (awk_map_render_callback_t callback)
	设置地图渲染回调接口实例
int32_t	awk_map_set_center (uint32_t map_id, awk_map_coord2d_t coord2d)
	设置地图中心，方法的调用需要在主流程线程中
int32_t	awk_map_set_level (uint32_t map_id, float level)
	设置地图级别，方法的调用需要在主流程线程中
int32_t	awk_map_set_roll_angle (uint32_t map_id, float roll_angle)
	设置地图的旋转角度，方法的调用需要在主流程线程中
int32_t	awk_map_get_posture (uint32_t map_id, awk_map_posture_t *posture)
	获取地图的状态，方法的调用需要在主流程线程中
int32_t	awk_map_request_tiles (awk_rect_area_t req_rect, awk_map_coord2d_t map_center, float map_level, int32_t priority)
	在线请求并进行缓存瓦片，SDK内部会判断是否已经存在磁盘缓存和离线数据，如果存在缓存则不会走在线请求
int32_t	awk_map_cancel_request_tiles (int32_t req_id)
	取消在线请求缓存瓦片
int32_t	awk_map_lonlat_to_xy (uint32_t map_id, awk_map_coord2d_t lonlat, int32_t *x, int32_t *y)
	经纬度坐标转屏幕坐标，方法的调用需要在主流程线程中
int32_t	awk_map_xy_to_lonlat (uint32_t map_id, int32_t x, int32_t y, awk_map_coord2d_t *lonlat)
	屏幕坐标转经纬度坐标，方法的调用需要在主流程线程中
double	awk_map_calc_points_distance (double lon1, double lat1, double lon2, double lat2)
	计算两点之间距离
void	awk_map_wgs84_to_mgs (double lng_wgs, double lat_wgs, double *lng_mgs, double *lat_mgs)
	WGS84坐标转AMap坐标
int32_t	awk_map_touch_begin (uint32_t map_id, int32_t x, int32_t y)
	开始挪图手势，方法的调用需要在主流程线程中
int32_t	awk_map_touch_update (uint32_t map_id, int32_t x, int32_t y)
	持续挪图过程，方法的调用需要在主流程线程中
int32_t	awk_map_touch_end (uint32_t map_id, int32_t x, int32_t y)
	停止挪图手势，方法的调用需要在主流程线程中
awk_map_point_overlay_t **	awk_map_click_points (uint32_t map_id, int32_t x, int32_t y, int32_t *overlay_count)
	获取单击屏幕时命中的点覆盖物，如果命中多个点覆盖物，返回的结果中会按照priority从大到小进行排序
int32_t	awk_map_release_overlays (awk_map_base_overlay_t **overlays, int32_t overlay_count)
	释放覆盖物数组指针
int32_t	awk_map_start_download_offline_data (const char *adcode, uint32_t level, awk_map_download_callback_t *download_callback)
	下载离线地图，方法的调用需要在主流程线程中, 目前下载不支持并发任务，多个下载需顺序执行
int32_t	awk_map_stop_download_offline_data ()
	停止离线地图下载，方法的调用需要在主流程线程中
int32_t	awk_map_start_download_region_range (awk_map_coord2d_t center, awk_map_range_t range, uint8_t expect_level, awk_map_download_callback_t *download_callback)
	通过经纬度和范围下载地图数据
int32_t	awk_map_stop_download_region_range (void)
	停止经纬度范围下载
int32_t	awk_map_download_polyline_region (const char *key, awk_map_coord2d_t *points, uint32_t point_size, uint8_t *expand_levels, uint8_t expand_levels_size, awk_map_tile_download_callback_t *download_callback)
	按照传入的经纬度点下载地图数据
awk_http_request_t *	awk_map_download_get_request (const char *tile_file_key)
	根据瓦片文件key获取请求
int32_t	awk_map_sync_tile_file (char **tile_file_keys, uint32_t tile_file_size)
	程序异常退出时，或差异时的同步
int32_t	awk_map_list_download_region_range (awk_map_coord2d_t location, awk_map_range_t range, uint8_t expect_level, awk_map_offline_gdb_query_result_t *result)
	查询已下载的区域信息
int32_t	awk_map_delete_download_region_range (awk_map_coord2d_t location, awk_map_range_t range, uint8_t expect_level)
	删除下载的区域信息
int32_t	awk_map_list_download_offline_regions (const char *adcode, uint32_t level, awk_map_offline_gdb_query_result_t *result)
	列出已下载的离线地图信息，方法的调用需要在主流程线程中 读取结果中的regions在不需要时需要手动释放，否则会有内存泄露
int32_t	awk_map_delete_download_offline_region (const char *adcode, uint32_t level)
	删除下载的离线地图数据，方法的调用需要在主流程线程中
int32_t	awk_map_sync_download_offline_region (void)
	同步下载区域信息，只在外部指定离线数据时使用, 方法的调用需要在主流程线程中

类型定义说明

track_parser

typedef int(* track_parser) (const char *track_data, size_t length, awk_map_track_info_t *result_track)

自定义轨迹解析器

在文件 awk_map.h 第 287 行定义.

枚举类型说明

awk_map_offline_type

enum awk_map_offline_type

离线数据下载类型

枚举值
OFFLINE_GDB_UNKNOWN
OFFLINE_GDB_ADCODE
OFFLINE_GDB_LOCATION_RANGE
OFFLINE_GDB_TILE_DONWLOAD

在文件 awk_map.h 第 655 行定义.

awk_map_tile_type_t

enum awk_map_tile_type_t

枚举值
AWK_MAP_TILE_TYPE_TILE
AWK_MAP_TILE_TYPE_POI

在文件 awk_map.h 第 592 行定义.

函数说明

awk_map_add_overlay()

int32_t awk_map_add_overlay	(	uint32_t	map_id,
		awk_map_base_overlay_t *	overlay
	)

添加覆盖物，方法的调用需要在主流程线程中

参数

{uint32_t}	map_id 地图实例id
{awk_map_view_base_overlay_t}	overlay 参数

返回

{成功返回0, 失败返回error: -1表示没有初始化, -2表示已经存在guid对应的覆盖物，-3表示传入的overlay参数为NULL或者geometry_type类型错误 -4初始化的线程和当前调用不一致}

awk_map_add_texture()

int32_t awk_map_add_texture

(

const awk_map_texture_data_t *

texture_data

)

添加纹理数据，方法的调用需要在主流程线程中

参数

{awk_map_texture_data_t}

texture_data 纹理参数

返回

{成功返回值大于0表示纹理id，失败返回error: -1表示没有初始化 -3初始化的线程和当前调用不一致}

awk_map_calc_points_distance()

double awk_map_calc_points_distance	(	double	lon1,
		double	lat1,
		double	lon2,
		double	lat2
	)

计算两点之间距离

参数

{double}	lon1 经度1
{double}	lat1 纬度1
{double}	lon2 经度2
{double}	lat2 纬度2

awk_map_cancel_request_tiles()

int32_t awk_map_cancel_request_tiles

(

int32_t

req_id

)

取消在线请求缓存瓦片

参数

{int32_t}

req_id 请求id

返回

{成功返回0, 失败返回error: -1表示没有初始化 -3初始化的线程和当前调用不一致}

awk_map_click_points()

awk_map_point_overlay_t ** awk_map_click_points	(	uint32_t	map_id,
		int32_t	x,
		int32_t	y,
		int32_t *	overlay_count
	)

获取单击屏幕时命中的点覆盖物，如果命中多个点覆盖物，返回的结果中会按照priority从大到小进行排序

参数

{uint32_t}	map_id 地图实例id
{int32_t}	x 屏幕坐标-x坐标值
{int32_t}	y 屏幕坐标-y坐标值
{int32_t}	*overlay_count 返回命中的点覆盖物数量

返回

{成功返回命中的点覆盖物数组指针，失败返回NULL。返回的覆盖物数组指针需要调用awk_map_release_overlays()方法进行释放}

awk_map_create_view()

int32_t awk_map_create_view

(

awk_map_view_param_t

param

)

创建地图mapview，方法的调用需要在主流程线程中

参数

{awk_map_view_param}

param 地图mapview参数

返回

{返回值如果大于0，表示生成的地图实例id，-1表示没有初始化，-2表示license校验失败 -3初始化的线程和当前调用不一致}

awk_map_delete_download_offline_region()

int32_t awk_map_delete_download_offline_region	(	const char *	adcode,
		uint32_t	level
	)

删除下载的离线地图数据，方法的调用需要在主流程线程中

参数

adcode	adcode
level	地图级别

返回

{成功返回0, 失败返回error: -1表示没有初始化, -2表示传入参数校验失败 -3初始化的线程和当前调用不一致}

awk_map_delete_download_region_range()

int32_t awk_map_delete_download_region_range	(	awk_map_coord2d_t	location,
		awk_map_range_t	range,
		uint8_t	expect_level
	)

删除下载的区域信息

参数

expect_level	需要的级别
location	经纬度信息
range	范围

返回

int32_t

awk_map_destroy_view()

int32_t awk_map_destroy_view

(

uint32_t

map_id

)

销毁地图mapview，方法的调用需要在主流程线程中

参数

{uint32_t}

map_id 地图实例id

返回

{成功返回0, 失败返回error: -1表示没有初始化 -3初始化的线程和当前调用不一致}

awk_map_do_render()

int32_t awk_map_do_render

(

void

)

地图绘制，方法的调用需要在主流程线程中

返回

{成功返回0, 失败返回error: -1表示没有初始化 -3初始化的线程和当前调用不一致}

awk_map_download_get_request()

awk_http_request_t * awk_map_download_get_request

(

const char *

tile_file_key

)

根据瓦片文件key获取请求

参数

tile_file_key

返回

awk_http_request_t* 返回请求，指针类型，需要手动释放

awk_map_download_polyline_region()

int32_t awk_map_download_polyline_region	(	const char *	key,
		awk_map_coord2d_t *	points,
		uint32_t	point_size,
		uint8_t *	expand_levels,
		uint8_t	expand_levels_size,
		awk_map_tile_download_callback_t *	download_callback
	)

按照传入的经纬度点下载地图数据

参数

key	用户传入的key，通过回调带出
points	经纬度点集合
point_size	经纬度点数量
expand_levels	扩展级别集合
expand_levels_size	扩展级别数量
download_callback	回调

返回

int32_t {成功返回0,失败返回error}

awk_map_find_overlay()

const awk_map_base_overlay_t * awk_map_find_overlay	(	uint32_t	map_id,
		uint32_t	overlay_id
	)

根据overlay_id查找覆盖物信息，方法的调用需要在主流程线程中

参数

{uint32_t}	map_id 地图实例id
{uint32_t}	overlay_id 覆盖物id

返回

{成功返回覆盖物结构体指针，失败返回NULL}

awk_map_get_overlay()

const awk_map_base_overlay_t * awk_map_get_overlay	(	uint32_t	map_id,
		uint32_t	index
	)

根据索引获取map_id对应地图的覆盖物，方法的调用需要在主流程线程中

参数

{uint32_t}	map_id 地图实例id
{uint32_t}	index 覆盖物索引

返回

{成功返回覆盖物结构体指针，失败返回NULL}

awk_map_get_overlay_count()

uint32_t awk_map_get_overlay_count

(

uint32_t

map_id

)

获取map_id对应的地图所有覆盖物的数量，方法的调用需要在主流程线程中

参数

{uint32_t}

map_id 地图实例id

返回

{覆盖物的数量}

awk_map_get_posture()

int32_t awk_map_get_posture	(	uint32_t	map_id,
		awk_map_posture_t *	posture
	)

获取地图的状态，方法的调用需要在主流程线程中

参数

{uint32_t}	map_id 地图实例id
{awk_map_posture_t}	*posture 返回地图状态

返回

{成功返回0, 失败返回error: -1表示没有初始化 -3初始化的线程和当前调用不一致}

awk_map_init_line_overlay()

int32_t awk_map_init_line_overlay

(

awk_map_polyline_overlay_t *

line_overlay

)

初始化线覆盖物的结构体，方法的调用需要在主流程线程中

参数

{awk_map_polyline_overlay_t}

*point_overlay 线覆盖物结构体指针

返回

{成功返回0, 失败返回error: -1表示没有初始化, -2表示传入参数为NULL -3初始化的线程和当前调用不一致}

awk_map_init_point_overlay()

int32_t awk_map_init_point_overlay

(

awk_map_point_overlay_t *

point_overlay

)

初始化点覆盖物的结构体，方法的调用需要在主流程线程中

参数

{awk_map_point_overlay_t}

*point_overlay 点覆盖物结构体指针

返回

{成功返回0, 失败返回error: -1表示没有初始化, -2表示传入参数为NULL -3初始化的线程和当前调用不一致}

awk_map_init_polygon_overlay()

int32_t awk_map_init_polygon_overlay

(

awk_map_polygon_overlay_t *

polygon_overlay

)

初始化面覆盖物的结构体，方法的调用需要在主流程线程中

参数

{awk_map_polygon_overlay_t}

*point_overlay 面覆盖物结构体指针

返回

{成功返回0, 失败返回error: -1表示没有初始化, -2表示传入参数为NULL -3初始化的线程和当前调用不一致}

awk_map_init_track_navi_overlay()

int32_t awk_map_init_track_navi_overlay

(

awk_map_track_navi_overlay_t *

overlay

)

初始化轨迹导航覆盖物

参数

overlay

轨迹导航覆盖物

返回

int32_t {成功返回0, 失败返回error: -1表示没有初始化, -2表示传入参数为NULL -3初始化的线程和当前调用不一致 -4未开放轨迹导航功能}

awk_map_list_download_offline_regions()

int32_t awk_map_list_download_offline_regions	(	const char *	adcode,
		uint32_t	level,
		awk_map_offline_gdb_query_result_t *	result
	)

列出已下载的离线地图信息，方法的调用需要在主流程线程中 读取结果中的regions在不需要时需要手动释放，否则会有内存泄露

参数

adcode	按adcode过滤，NULl代表不过滤
level	按地图级别过滤，0代表不过滤
result	成功时填充结果信息，读取结果中的regions在不需要时需要手动释放，否则会有内存泄露

返回

{成功返回0, 失败返回error: -1表示没有初始化, -2表示传入参数校验失败 -3初始化的线程和当前调用不一致}

awk_map_list_download_region_range()

int32_t awk_map_list_download_region_range	(	awk_map_coord2d_t	location,
		awk_map_range_t	range,
		uint8_t	expect_level,
		awk_map_offline_gdb_query_result_t *	result
	)

查询已下载的区域信息

参数

expect_level	需要的级别
location	经纬度信息
range	范围
result	成功返回已下载的信息

返回

int32_t {成功返回0,失败返回error}

awk_map_lonlat_to_xy()

int32_t awk_map_lonlat_to_xy	(	uint32_t	map_id,
		awk_map_coord2d_t	lonlat,
		int32_t *	x,
		int32_t *	y
	)

经纬度坐标转屏幕坐标，方法的调用需要在主流程线程中

参数

{uint32_t}	map_id 地图实例id
{awk_map_coord2d_t}	lonlat 经纬度坐标
{int32_t}	*x 返回屏幕坐标-x坐标值
{int32_t}	*y 返回屏幕坐标-y坐标值

返回

{成功返回0, 失败返回error: -1表示没有初始化 -3初始化的线程和当前调用不一致}

awk_map_pause_render()

int32_t awk_map_pause_render

(

uint32_t

map_id

)

将map_id对应的地图暂停绘制，方法的调用需要在主流程线程中

参数

{uint32_t}

map_id 地图实例id

返回

{成功返回0, 失败返回error: -1表示没有初始化, -2表示没有找到map_id对应的地图实例 -3初始化的线程和当前调用不一致}

awk_map_release_overlays()

int32_t awk_map_release_overlays	(	awk_map_base_overlay_t **	overlays,
		int32_t	overlay_count
	)

释放覆盖物数组指针

参数

{awk_map_base_overlay_t}	**overlays 覆盖物数组指针
{int32_t}	overlay_count 覆盖物数量

返回

{成功返回0, 失败返回error: -1表示没有初始化, -2表示overlays为NULL或者overlay_count为0 -3初始化的线程和当前调用不一致}

awk_map_remove_overlay()

int32_t awk_map_remove_overlay	(	uint32_t	map_id,
		uint32_t	overlay_id
	)

移除覆盖物，方法的调用需要在主流程线程中

参数

{uint32_t}	map_id 地图实例id
{uint32_t}	overlay_id 覆盖物id

返回

{成功返回0, 失败返回error: -1表示没有初始化, -2表示没有找到guid对应的覆盖物 -3初始化的线程和当前调用不一致}

awk_map_remove_texture()

int32_t awk_map_remove_texture

(

uint32_t

texture_id

)

移除纹理数据，方法的调用需要在主流程线程中

参数

{uint32_t}

texture_id 纹理id

返回

{成功返回0, 失败返回error: -1表示没有初始化 -3初始化的线程和当前调用不一致}

awk_map_request_tiles()

int32_t awk_map_request_tiles	(	awk_rect_area_t	req_rect,
		awk_map_coord2d_t	map_center,
		float	map_level,
		int32_t	priority
	)

在线请求并进行缓存瓦片，SDK内部会判断是否已经存在磁盘缓存和离线数据，如果存在缓存则不会走在线请求

参数

{awk_rect_area_t}	req_rect 需要缓存的屏幕区域
{awk_map_coord2d_t}	*map_center 需要缓存的地图中心点
{float}	map_level 需要缓存的地图级别
{int32_t}	请求的优先级，值请参考awk_http_priority

返回

{返回大于0的值为请求id, 失败返回error: -1表示没有初始化 -3初始化的线程和当前调用不一致 -4表示参数非法}

awk_map_resume_render()

int32_t awk_map_resume_render

(

uint32_t

map_id

)

将map_id对应的地图恢复绘制，方法的调用需要在主流程线程中

参数

{uint32_t}

map_id 地图实例id

返回

{成功返回0, 失败返回error: -1表示没有初始化, -2表示没有找到map_id对应的地图实例 -3初始化的线程和当前调用不一致}

awk_map_set_center()

int32_t awk_map_set_center	(	uint32_t	map_id,
		awk_map_coord2d_t	coord2d
	)

设置地图中心，方法的调用需要在主流程线程中

参数

{uint32_t}	map_id 地图实例id
{coord2D}	coord2d 地图中心点经纬度坐标

返回

{成功返回0, 失败返回error: -1表示没有初始化 -3初始化的线程和当前调用不一致}

awk_map_set_level()

int32_t awk_map_set_level	(	uint32_t	map_id,
		float	level
	)

设置地图级别，方法的调用需要在主流程线程中

参数

{uint32_t}	map_id 地图实例id
{float}	level 地图级别

返回

{成功返回0, 失败返回error: -1表示没有初始化 -3初始化的线程和当前调用不一致 -4表示level级别不合法}

awk_map_set_render_callback()

int32_t awk_map_set_render_callback

(

awk_map_render_callback_t

callback

)

设置地图渲染回调接口实例

参数

{awk_map_render_callback_t}

callback 渲染回调接口实例

返回

{成功返回0, 失败返回error: -1表示没有初始化 -3初始化的线程和当前调用不一致}

awk_map_set_roll_angle()

int32_t awk_map_set_roll_angle	(	uint32_t	map_id,
		float	roll_angle
	)

设置地图的旋转角度，方法的调用需要在主流程线程中

参数

{uint32_t}	map_id 地图实例id
{float}	roll_angle 旋转角度

返回

{成功返回0, 失败返回error: -1表示没有初始化 -3初始化的线程和当前调用不一致 -4表示当前的tile_style不支持该能力}

awk_map_set_view_port()

int32_t awk_map_set_view_port	(	uint32_t	map_id,
		awk_map_view_port_t	view_port
	)

设置地图视口，方法的调用需要在主流程线程中

参数

{uint32_t}	map_id 地图实例id
{view_port}	view_port 视口参数

返回

{成功返回0, 失败返回error: -1表示没有初始化 -3初始化的线程和当前调用不一致}

awk_map_start_download_offline_data()

int32_t awk_map_start_download_offline_data	(	const char *	adcode,
		uint32_t	level,
		awk_map_download_callback_t *	download_callback
	)

下载离线地图，方法的调用需要在主流程线程中, 目前下载不支持并发任务，多个下载需顺序执行

参数

{char}	*adcode 城市的adcode,城市/区 adcode（只有北京、上海、广州、深圳、杭州、天津、重庆、成都、哈尔滨、拉萨、南宁、昆明、长春、沈阳、大庆、温州、青岛 有区级）必填 无缺省值
{uint32_t}	level 地图级别 地图层级（目前支持7-16级）必填 无缺省值
{awk_download_callback_t}	*download_callback 下载回调

返回

{成功返回0, 失败返回error: -1表示没有初始化 -3初始化的线程和当前调用不一致}

awk_map_start_download_region_range()

int32_t awk_map_start_download_region_range	(	awk_map_coord2d_t	center,
		awk_map_range_t	range,
		uint8_t	expect_level,
		awk_map_download_callback_t *	download_callback
	)

通过经纬度和范围下载地图数据

参数

center	中心点经纬度
range	范围公里
expect_level	需要下载的级别
download_callback	下载回调

返回

{成功返回0,失败返回error}

awk_map_stop_download_offline_data()

int32_t awk_map_stop_download_offline_data

(

)

停止离线地图下载，方法的调用需要在主流程线程中

返回

{成功返回0, 失败返回error: -1表示没有初始化 -3初始化的线程和当前调用不一致}

awk_map_stop_download_region_range()

int32_t awk_map_stop_download_region_range

(

void

)

停止经纬度范围下载

返回

{成功返回0,失败返回error}

awk_map_sync_download_offline_region()

int32_t awk_map_sync_download_offline_region

(

void

)

同步下载区域信息，只在外部指定离线数据时使用, 方法的调用需要在主流程线程中

参见

awk_context_t 当offline_map_dir设置后使用

返回

{成功返回0, 失败返回error: -1表示没有初始化, -2表示其他异常 -3初始化的线程和当前调用不一致}

awk_map_sync_tile_file()

int32_t awk_map_sync_tile_file	(	char **	tile_file_keys,
		uint32_t	tile_file_size
	)

程序异常退出时，或差异时的同步

参数

tile_file_keys
tile_file_size

返回

int32_t

awk_map_touch_begin()

int32_t awk_map_touch_begin	(	uint32_t	map_id,
		int32_t	x,
		int32_t	y
	)

开始挪图手势，方法的调用需要在主流程线程中

参数

{uint32_t}	map_id 地图实例id
{int32_t}	x 挪图时触摸的点x坐标
{int32_t}	y 挪图时触摸的点y坐标

返回

{成功返回0, 失败返回error: -1表示没有初始化, -2表示没有找到map_id对应的地图实例 -3初始化的线程和当前调用不一致}

awk_map_touch_end()

int32_t awk_map_touch_end	(	uint32_t	map_id,
		int32_t	x,
		int32_t	y
	)

停止挪图手势，方法的调用需要在主流程线程中

参数

{uint32_t}	map_id 地图实例id
{int32_t}	x 挪图时触摸的点x坐标
{int32_t}	y 挪图时触摸的点y坐标

返回

{成功返回0, 失败返回error: -1表示没有初始化, -2表示没有找到map_id对应的地图实例 -3初始化的线程和当前调用不一致}

awk_map_touch_update()

int32_t awk_map_touch_update	(	uint32_t	map_id,
		int32_t	x,
		int32_t	y
	)

持续挪图过程，方法的调用需要在主流程线程中

参数

{uint32_t}	map_id 地图实例id
{int32_t}	x 挪图时触摸的点x坐标
{int32_t}	y 挪图时触摸的点y坐标

返回

{成功返回0, 失败返回error: -1表示没有初始化, -2表示没有找到map_id对应的地图实例 -3初始化的线程和当前调用不一致}

awk_map_track_navi_add_overlay()

int32_t awk_map_track_navi_add_overlay	(	uint32_t	map_id,
		awk_map_track_navi_overlay_t *	overlay
	)

添加轨迹导航覆盖物

参数

map_id	地图view id
overlay	覆盖物

返回

int32_t {成功返回0, 失败返回error: -1表示没有初始化, -2表示没有找到guid对应的覆盖物，-3表示传入的overlay参数为NULL或者geometry_type类型错误 -4初始化的线程和当前调用不一致 -5未开放轨迹导航功能}

awk_map_track_navi_get_distance()

double awk_map_track_navi_get_distance	(	uint32_t	map_id,
		awk_map_coord2d_t	point,
		awk_map_track_point_type	point_type,
		awk_map_track_navi_overlay_t *	overlay
	)

获取距离,获取最近的一个类型点距离

参数

map_id	地图view id
point	位置点
point_type	点的类型
overlay	覆盖物

返回

double

awk_map_track_navi_parse_gpx()

awk_map_track_info_t * awk_map_track_navi_parse_gpx	(	const char *	gpx_data,
		size_t	length
	)

解析gpx

参数

gpx_data	数据内容
length	长度

返回

const awk_map_track_info_t

awk_map_track_navi_parse_track_info_free()

void awk_map_track_navi_parse_track_info_free

(

awk_map_track_info_t *

track_info

)

析构track info

参数

track_info

轨迹信息

awk_map_track_navi_remove_overlay()

int32_t awk_map_track_navi_remove_overlay	(	uint32_t	map_id,
		uint32_t	overlay_id
	)

移除轨迹导航覆盖物

参数

map_id	地图view id
overlay_id	覆盖物id

返回

int32_t {成功返回0, 失败返回error: -1表示没有初始化, -2表示没有找到guid对应的覆盖物 -3初始化的线程和当前调用不一致 -4未开放轨迹导航功能}

awk_map_track_navi_update_real_point()

void awk_map_track_navi_update_real_point	(	uint32_t	map_id,
		awk_map_coord2d_t	point,
		float	bear,
		awk_map_track_navi_overlay_t *	overlay
	)

更新真实点

参数

map_id	地图view id
point	位置点
bear	角度
overlay	覆盖物

awk_map_update_overlay()

int32_t awk_map_update_overlay	(	uint32_t	map_id,
		awk_map_base_overlay_t *	overlay
	)

更新覆盖物，方法的调用需要在主流程线程中

参数

{uint32_t}	map_id 地图实例id
{awk_map_view_base_overlay_t}	overlay 参数

返回

{成功返回0, 失败返回error: -1表示没有初始化, -2表示没有找到guid对应的覆盖物，-3表示传入的overlay参数为NULL或者geometry_type类型错误 -4初始化的线程和当前调用不一致}

awk_map_update_texture()

int32_t awk_map_update_texture	(	uint32_t	texture_id,
		const awk_map_texture_data_t *	texture_data
	)

更新纹理数据，方法的调用需要在主流程线程中

参数

{uint32_t}	texture_id 纹理id
{awk_map_texture_data_t}	texture_data 纹理参数

返回

{成功返回0, 失败返回error: -1表示没有初始化, -2表示没有找到texture_id对应的纹理 -3初始化的线程和当前调用不一致}

awk_map_wgs84_to_mgs()

void awk_map_wgs84_to_mgs	(	double	lng_wgs,
		double	lat_wgs,
		double *	lng_mgs,
		double *	lat_mgs
	)

WGS84坐标转AMap坐标

参数

lng_wgs	WGS84经度
lat_wgs	WGS84纬度
lng_mgs	AMap经度
lat_mgs	AMap纬度

awk_map_xy_to_lonlat()

int32_t awk_map_xy_to_lonlat	(	uint32_t	map_id,
		int32_t	x,
		int32_t	y,
		awk_map_coord2d_t *	lonlat
	)

屏幕坐标转经纬度坐标，方法的调用需要在主流程线程中

参数

{uint32_t}	map_id 地图实例id
{int32_t}	x 屏幕坐标-x坐标值
{int32_t}	y 屏幕坐标-y坐标值
{awk_map_coord2d_t}	*lonlat 经纬度坐标

返回

{成功返回0, 失败返回error: -1表示没有初始化 -3初始化的线程和当前调用不一致}