Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/aztack/g2b
A Google Map API to Baidu Map API Adapter
https://github.com/aztack/g2b
baidu-map google-maps
Last synced: 1 day ago
JSON representation
A Google Map API to Baidu Map API Adapter
- Host: GitHub
- URL: https://github.com/aztack/g2b
- Owner: aztack
- Created: 2011-06-28T02:42:00.000Z (over 13 years ago)
- Default Branch: master
- Last Pushed: 2013-05-25T09:57:19.000Z (over 11 years ago)
- Last Synced: 2023-03-12T03:38:31.134Z (over 1 year ago)
- Topics: baidu-map, google-maps
- Language: JavaScript
- Homepage:
- Size: 3.09 MB
- Stars: 24
- Watchers: 4
- Forks: 35
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
Google Map to Baidu Map 迁移工具说明
====================================
0) 变更记录
===========
version 0.1
- 修正GLatLngBounds无参数初始化加了坐标偏移的问题
- 增加GIcon拷贝构造时更新image,iconSize,iconAnchor,infoWindowAnchor属性到实现
- 修正GMarker构造时options的icon属性没有正确设置的问题
2011-06-29
- 构造GMarker时传入的option支持zIndexProcess,但只在构造时调用一次，并设置marker的zIndex
- 增加GMapType,但是用户不能主动创建该类实例
- 修复GDirection.loadFromWaypoints连续调用不清除上一次结果的问题
2011-08-02
- 2011年07月29日 API 1.2 Map增加mouseover和mouseout事件,做相应的修改
- 修复map,marker事件部分的bug
1) G2B介绍
==========
G2B是一个'个人的','实验性质'的工程
G2B是什么?
----------
G2B是一个适配层脚本。它使用百度地图API实现了“部分”谷歌地图API的接口
通过加载G2B脚本,用户可以通过无需或少量修改已有map应用,做到从google map api
迁移到baidu map api
G2B不是什么?
------------
G2B不是完整的谷歌地图API的实现。由于谷歌地图API的接口类、函数非常多。
在编写G2B时无法一一实现。所以采用了“案例驱动”的编写模式：逐个实现
[Google API V2 Examples](http://code.google.com/apis/maps/documentation/javascript/v2/examples/index.html)
中的实例功能。目前已经支持“去哪儿”网地图应用的迁移。
G2B实现难点
-----------
适配层编写的困难指出就是要处理上下两层(google map api和baidu map api)之间的差异。
具体体现在坐标系统、事件处理、框架结构方面。
2) G2B的实现
============
为什么没有选择继承?
-------------------
最初的确尝试过通过继承BMap中对应类，并重写部分函数的实现方法。
但是这种方法有个明显的问题：名字冲突。比如
GLatLng中有两个方法用于获得对应的经纬度坐标值lng()和lat()。
但是在对应的BMap.Point中lng和lat是两个属性。
所以放弃了这种实现方法
实现方法
--------
最终G2B选择了聚合的实现方式：将具体实现保存在一个名为_impl的属性中。
然后在实现的谷歌接口函数中调用_impl中对应的方法。
Klass帮助类 - 元编程
--------------------
百度地图API和谷歌地图API中存在很多函数名和功能完全一致或相似的情况。
为了避免大量重复代码，并能做到同意修改。在G2B前面部分实现了一个名为Klass
的帮助类。比如如果某个类的函数名和语义完全一样。那么调用Klass的same方法自动生成
一个同名函数绑定到对_impl的调用上。如toString方法:
```javascript
Klass("GLatLng",function(lat,lng),[BMap.Point])
.same("toString")
.end();
```
其中GLatLng为要实现的谷歌接口。后面接构造函数；第三个参数标明该接口对应百度地图
API中的BMap.Point。然后二者有一个名字和功能相同的函数“toString”；end表示定义结束。
当二者有功能相同但是名字不同的函数时，可以使用alias来声明别名:
```javascript
Klass("GMarker",function(...){...},[])
.alias("openInfoWindowHtml","openInfoWindow")
.end();
```
上面代码中，openInfoWindow是BMap.Marker的方法，它和GMarker的openInfoWindowHtml功能相同.
当百度地图API没有对应实现时（比如GMap.enableRotation），那么使用noimpl标明没有对应实现.
事件
----
谷歌地图和百度地图采用了完全不同的事件注册机制。前者使用GEvent注册事件处理函数。
后者采用与W3C标准一致的addEventListener/removeEventListener方法注册、注销事件处理函数
在G2B中实现了一个与GEvent功能一样的对象。
事件派发
--------
由于实现的差异，二者的事件处理函数的参数完全不同。为了适配这个差异，G2B在调用事件处理函数
之前进行了“翻译”。详见EVENT_SINGNATUR和translateEventArgs。
目前只实现了必要的几个核心类的事件处理。
translateEventArgs抽象了这些类的事件的共同处。是一个泛化的处理函数。如果今后需要增加
更多的事件翻译，可以通过直接判断对象和事件的类型调用相应的翻译代码进行翻译。
常量定义
--------
使用Const函数定义常量:Const("Const_Name",value);
坐标偏移
--------
目前坐标偏移采用线性偏移。
进行偏移的原则是：
* 所有进入GXXX函数的坐标都认为是谷歌坐标。进入函数后用TO_BLNG和TO_BLAT转换为百度坐标。
* 所有传出GXXX函数的坐标都认为是谷歌坐标。返回之前用TO_GLNG和TO_GLAT转换为谷歌坐标
* 在G2B的实现函数内部，对_impl之间的调用不需要转换，都是百度坐标
用于预处理器生成不同的代码（可选）
---------------------------------
默认情况下TO\_BLNG/TO\_BLAT/TO\_GLNG/TO\_GLAT都是函数。
如果传入的参数全部已经预先转换为百度坐标（也就是说不需要进行线性偏移）
那么可以将上述几个函数改写为直接返回传入的参数不进行偏移。
为了避免这个无意义的函数调用的开销。可以打开给g2b.h中的
```c
#define __GOOGLE__
```
然后按照g2b.o.js头部的命令用c++预处理器将上述偏移函数去掉。
3) 局限性
=========
功能的局限性
------------
由于采用的是“案例驱动”的编写方式，所以只实现了谷歌实例的大部分功能和“去哪儿”网
迁移需要的功能。如果需要其他功能还需要继续完善G2B。
坐标偏移
--------
由于各种原因无法做到谷歌和百度坐标之间的精确双向转换。
目前只能做到线性偏移转换，偏移导致的误差最大在70米
G2B只是一个迁移解决方案。还是希望用户可以主动去了解、使用百度地图API:
[百度地图API](http://dev.baidu.com/wiki/static/index.htm)