简介

JavaScript API功能介绍

JavaScript API是一套由JavaScript语言编写的应用程序接口,它能够帮助您在网站中构建功能丰富、交互性强的地图应用,包含了构建地图基本功能的各种接口,提供了诸如本地搜索、路线规划等数据服务。

基本地图功能:展示(支持2D图、3D图、卫星图)、平移、缩放、拖拽等。

地图控件展示功能:可以在地图上添加/删除鹰眼、工具条、比例尺、自定义版权、地图类型及定位控件,并可以设置各类控件的显示位置。

覆盖物功能:支持在地图上添加/删除点、线、面、热区、行政区划、用户自定义覆盖物等;开源库提供富标注、标注管理器、聚合marker、自定义覆盖物等功能。

工具类功能:提供经纬度坐标与屏幕坐标互转功能;开源库里提供测距、几何运算及GPS坐标/国测局坐标转平台坐标等功能。

定位功能:支持IP定位及浏览器(支持html5特性浏览器)定位功能。

右键菜单功能:支持在地图上添加右键菜单。

鼠标交互功能:支持动态修改鼠标样式、鼠标拖拽/缩放地图及鼠标绘制等功能。

图层功能:支持重设地图底图、地图上叠加实时交通图层或自定义图层功能。

本地搜索功能:包括根据城市、矩形范围、圆形范围等条件进行POI搜索;且支持用户自有数据的检索。

逆/地理编码:支持地理坐标与地址描述信息之间的转换服务。

面向的读者

API是提供给那些具有一定JavaScript编程经验和了解面向对象概念的读者使用。此外,读者还应该对地图产品有一定的了解。

您在使用中遇到任何问题,都可以通过API论坛反馈给我们。

版本说明及申请API token

为了统一平台服务的配额管理,JavaScript API在新版本引入token机制。JavaScript API v1.4及以前版本无须申请密钥(token),自v1.5版本开始需要先申请密钥(token),才可使用,如需获取更高配额,请点击申请认证企业用户。

地址:

http://daditu.com.cn/api?v=1.4 //参数v表示您加载API的版本,使用JavaScript APIv1.4及以前版本可使用此方式引用。
http://daditu.com.cn/api?v=1.5&token=您的密钥  //使用JavaScript APIv2.0请先申请密钥token,按此方式引用。
                    

当权限验证(token)失败时,会报如下错误:

../js-token-failure.jpg

验证失败的可能原因包括:

尚未在API控制台申请token,即'...token=';

密钥设置错误,如E4805d16520de693a3fe707cdc962045为正确的token,但是设置时输入的token为E4805d16520de693a3fe707cdc962045xx;

密钥未通过白名单,如下图的token域名下会报错。

js_token_refer.png

API控制台关闭JavaScript API时会报错;

token_no_click.jpg

当API升级后,如果已有接口在使用、命名等方面发生了变化,我们会为其增加一个新的版本号,这不会对您现有的应用造成任何影响。如果升级只是修复一些bug或者在不影响现有功能的前提下增加接口、改善性能,则版本号不会发生变化。您可以在更新日志页面查看版本的变化。


错误的使用“服务端token”用于 JavaScript API,JS API只支持浏览器类型的token

因新系统升级,新建“服务端token”不再支持浏览器端使用;在浏览器端使用,请选择“浏览器端token”,例如JavaScript API只支持浏览器类型token。

对于以前申请的服务端token,不变更即不受影响,仍支持浏览器端使用;如更新老的服务端token,再次保存,则按新创建token处理,不再支持浏览器端使用。