搜狗地图 JavaScript API 基础知识

欢迎使用搜狗地图API

欢迎使用Sogou Maps JavaScript API。

目前,搜狗地图数据覆盖全国:含有数千万POI(Point Of Interest),覆盖全国近400个大、中城市、热点旅游城市 [查看城市列表]及3000个区县;道路包括高速公路、国道、省道、城市、乡村等5级路网。支持城市内、城际间的自驾路线查询服务;130多个城市的公交换乘服务。日访问量已逾百万,成为国内首屈一指的地图服务平台。

Sogou Maps JavaScript API 是由javascript语言编写的地图应用程序接口。使用Sogou Maps JavaScript API 可以轻松的在网站中构建丰富的地图应用。 在本文档中有大量的实例,开发过程中可以直接拷贝,引用其中的代码。

面向读者

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

您在使用中遇到任何问题,都可以通过技术咨询QQ群:146973945 、121164754(已满) 、163062741(已满) 反馈给我们。

获取API

地图API是由JavaScript语言编写的,您在使用之前需要通过<script>标签将API引用到页面中:

 <script src="//api.go2map.com/maps/js/api_v2.5.1.js" type="text/javascript"></script>

 

兼容性

  • IE 6.0+ (Windows) 以及ie内核的其他浏览器,如:搜狗高速浏览器、遨游浏览器、360浏览器、世界之窗浏览器等。
  • Firefox 2.0+ (Windows|Mac|Linux)
  • Safari 3.1+ (Mac|Windows)
  • chrome谷歌浏览器 (Windows)
  • opera 10+ (Windows)

地图开发

Sogou Maps API适用于熟悉 Javascript 编程以及面向对象编程概念的读者。您还应该从用户的角度熟悉 Sogou Maps。您可以从网络上找到很多 Javascript 辅导手册。
本文档是概念性文档,旨在帮助您快速开始使用 Sogou Maps API 探索和开发很酷的应用程序。我们还发布了 Sogou Maps API 参考

    地图应用的开发流程

  • 首先在页面中引入搜狗地图 Javascript API 的类库:
    <script type="text/javascript" src="//api.go2map.com/maps/js/api_v2.5.1.js"></script>
  • 创建地图的DOM容器
    <div id="map_canvas"></div>

    地图容器是指地图所要放的位置。这个在开发应用时可以根据需灵活定义,自行设置宽高等等。

  • 初始化地图

    确定地图放在哪里之后,就需要创建地图了。创建地图很简单,只要在引入地图的API之后。创建一个Sogou.maps.Map实例,并将之前的DOM容器作为参数传进去就可以了,如:

    var map = new sogou.maps.Map(document.getElementById("map_canvas"),{});
  • 具体请参考 搜狗地图hello world

  • 侦听事件,构建代码

    当创建完地图之后。就可以开始开发丰富多彩的地图应用了。应用搜狗地图事件是做许多有意思的事情的开始。在 API 参考 中有更详细的介绍。 您可以通过 Sogou.maps.event.addListener 方法侦听到事件的发生。同时编写您的代码:

    				//click就点击地图后的事件。
    				sogou.maps.event.addListener(_m,"click",function(a){
    					alert("我被点了一下!")
    				});
    

    接着你还可以在地图上添加标记、线、面对象等等。

    		var myLatlng = new sogou.maps.LatLng(39.981320,116.320247); 
    		var marker = new sogou.maps.Marker({
    			position: myLatlng, 
    			map: map,
    			title:"Hello World!"
    		});	   
    

    还有许多有意思的事,需要您慢慢发现,如果想快捷开发。可查看更多示例

文档使用指导

在使用本文档时请您先仔细阅读 辅导手册。这里讲解开发地图应用时用到的必要知识。同时也会引导您去参看本文档的其它内容。

如果您已经有过开发经验。只是想迅速查看相关功能函数的说明。那您可以直接查看 API参考部份。这里有全面的功能类及函数的说明。