awk_map.h

浏览该文件的文档.

/*
 * @brief watch地图接口
 */
#ifndef _AWK_MAP_H
#define _AWK_MAP_H
 
#include <stddef.h>
#include <stdint.h>
#include <stdlib.h>
#include <stdbool.h>
#include "awk_map_defines.h"
#include "awk_adapter.h"
 
#ifdef __cplusplus
extern "C" {
#endif
 
/*********************
 *    地图操作
*********************/
    
typedef struct _awk_map_render_callback_t awk_map_render_callback_t;
struct _awk_map_render_callback_t {
    
    bool (*on_point_begin_draw)(uint32_t map_id, int32_t guid);
    
    void (*on_point_end_draw)(uint32_t map_id, int32_t guid, int32_t status);
    
    bool (*on_line_begin_draw)(uint32_t map_id, int32_t guid);
    
    void (*on_line_end_draw)(uint32_t map_id, int32_t guid, int32_t status);
    
    bool (*on_polygon_begin_draw)(uint32_t map_id, int32_t guid);
    
    void (*on_polygon_end_draw)(uint32_t map_id, int32_t guid, int32_t status);
    
    bool (*on_tile_begin_draw)(uint32_t map_id, uint32_t tile_x, uint32_t tile_y, uint32_t zoom);
    
    void (*on_tile_end_draw)(uint32_t map_id, uint32_t tile_x, uint32_t tile_y, uint32_t zoom, int32_t status);
    
    bool (*on_tile_begin_download)(int32_t type, uint32_t tile_x, uint32_t tile_y, uint32_t zoom);
    
    bool (*on_poi_begin_download)(int32_t type, uint32_t tile_x, uint32_t tile_y, uint32_t zoom);
    
    bool (*on_poi_begin_draw)(uint32_t map_id, uint32_t tile_x, uint32_t tile_y, uint32_t zoom);
    
    void (*on_poi_end_draw)(uint32_t map_id, uint32_t tile_x, uint32_t tile_y, uint32_t zoom, int32_t status);
    
    void (*on_tile_end_download)(int32_t type, uint32_t tile_x, uint32_t tile_y, uint32_t zoom, awk_map_tile_response_status_t status);
    
    void (*on_poi_end_download)(int32_t type, uint32_t tile_x, uint32_t tile_y, uint32_t zoom, awk_map_tile_response_status_t status);
};
 
int32_t awk_map_create_view(awk_map_view_param_t param);
 
int32_t awk_map_destroy_view(uint32_t map_id);
 
int32_t awk_map_do_render(void);
 
int32_t awk_map_pause_render(uint32_t map_id);
    
int32_t awk_map_resume_render(uint32_t 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);
 
uint32_t awk_map_get_overlay_count(uint32_t map_id);
 
/************** tacker navigation *******************/
typedef int (*track_parser)(const char *track_data, size_t length, awk_map_track_info_t *result_track);
 
awk_map_track_info_t* awk_map_track_navi_parse_gpx(const char *gpx_data, size_t length);
 
void awk_map_track_navi_parse_track_info_free(awk_map_track_info_t *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);
 
/************** tacker navigation *******************/
 
 
const awk_map_base_overlay_t *awk_map_get_overlay(uint32_t map_id, uint32_t index);
 
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);
 
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);
 
/*********************
 *    地图手势
*********************/
 
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);
 
int32_t awk_map_release_overlays(awk_map_base_overlay_t **overlays, int32_t overlay_count);
 
/*********************
 *    离线地图下载
*********************/
 
typedef struct _awk_map_download_callback_t awk_map_download_callback_t;
struct _awk_map_download_callback_t {
    void (*on_started)(awk_map_download_callback_t *callback);
    void (*on_progress)(awk_map_download_callback_t *callback, float progress);
    void (*on_finish) (awk_map_download_callback_t *callback);
    void (*on_stop) (awk_map_download_callback_t *callback);
    void (*on_error) (awk_map_download_callback_t *callback, int32_t error_code, const char* msg);
};
 
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);
 
typedef enum {
    AWK_MAP_TILE_TYPE_TILE = 0, // 瓦片数据
    AWK_MAP_TILE_TYPE_POI = 1,  // POI数据
} awk_map_tile_type_t;
typedef struct _awk_map_tile_download_info_t {
    awk_map_tile_type_t tile_type;
    char tile_file_key[64];
} awk_map_tile_download_info_t;
 
typedef struct _awk_map_tile_download_callback_t {
    void (*on_success) (const char *key, awk_map_tile_download_info_t *tile_download_infos, uint32_t tile_download_size);
 
    void (*on_fail) (const char *key, int32_t error_code, const char* msg);
} awk_map_tile_download_callback_t;
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);
int32_t awk_map_sync_tile_file(char **tile_file_keys, uint32_t tile_file_size);
 
typedef enum _awk_map_offline_type {
    OFFLINE_GDB_UNKNOWN,
    OFFLINE_GDB_ADCODE,
    OFFLINE_GDB_LOCATION_RANGE,
    OFFLINE_GDB_TILE_DONWLOAD
} awk_map_offline_type;
 
typedef struct _awk_map_offline_gdb_adcode_t {
    char adcode[8];     
} awk_map_offline_gdb_adcode_t;
 
typedef struct _awk_map_offline_gdb_location_t {
    awk_map_coord2d_t location;             
    awk_map_range_t range;                  
    uint8_t expect_level;                   
} awk_map_offline_gdb_location_t;
 
typedef struct _awk_map_offline_gdb_info_t {
    uint8_t level;                                  
    awk_map_offline_type type;                      
    char file_name[128];                            
    awk_map_offline_gdb_adcode_t adcode_info;       
    awk_map_offline_gdb_location_t location_info;   
} awk_map_offline_gdb_info_t;
 
typedef struct _awk_map_offline_gdb_query_result_t {
    size_t size;                            
    awk_map_offline_gdb_info_t *infos;      
} awk_map_offline_gdb_query_result_t;
 
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);
 
int32_t awk_map_delete_download_offline_region(const char *adcode, uint32_t level);
 
int32_t awk_map_sync_download_offline_region(void);
 
#ifdef __cplusplus
}
#endif
    
#endif