搜狗地图 JavaScript API 基础知识

欢迎使用Sogou 地图API

欢迎使用Sogou Maps JavaScript API。

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

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

面向读者

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

您在使用中遇到任何问题，都可以通过技术咨询QQ群：146973945 、121164754(已满) 、163062741(已满) 或 API技术论坛 反馈给我们。
在微博时代，我们建议您使用微群进行交流沟通。新浪微群：470096 。

获取API

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

 <script src="http://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="http://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。

  • 侦听事件,构建代码

    当创建完地图之后。就可以开始开发丰富多彩的地图应用了。应用Sogou地图事件是做许多有意思的事情的开始。在 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参考部份。这里有全面的功能类及函数的说明。