在苹果手机上，我们只要打开定位服务，拍照后便能在相簿中找到地图，地图上显示着在各地拍摄的相片。网站上这种显示方式也并不少见，例如 Flickr、即将关闭的 Panoramio 等。作为地图爱好者，每每看到地图就激动不已，就想若能在自己博客上也这么显示，那该多好！
相片的地理位置信息，是通过手机等设备的 GPS 模块记录的，并在其图片文件的 EXIF 数据，保留了这些位置信息。
使用七牛做博客图床以来，其图片处理 API 为各种显示需求提供了便利，这其中有个可以获取图片 EXIF 信息的 API[1]，可以很方便的获取到图片的 EXIF 信息，之前也用过它为博客上的相片显示拍照参数。而 EXIF 包含的 GPS 位置信息，则可以实现以上所提到的效果。
实现流程
EXIF 为位置信息保留了经纬坐标、海拔等，将它转成实际地址信息，或者显示到地图上，还需要配合一个地图 API，在此就以高德地图为例。
实现流程大致如下：
st=>start: 开始
e=>end: 结束
op1=>operation: 请求数据
op2=>operation: 转换坐标
op3=>operation: 显示地址
st(right)->op1(right)->op2(right)->op3(right)->e
- 请求数据：利用七牛 API 请求获取图片的 GPS 信息
- 转换坐标：因相片的坐标数据是以 WGS84 坐标系统为准的，得转换坐标
- 显示地址：通过高德地图 API 实现
获取坐标
我们还是以一张图片为例，来分析下如何实现。
上图是在汕头市澄海区莲下镇渡亭村莲阳河畔拍的花，其图片地址如下：
http://source.fooleap.org/show-photo-location-on-map-with-qiniu-and-amap-api.jpg
那么，七牛图片 EXIF 信息的接口如下：
http://source.fooleap.org/show-photo-location-on-map-with-qiniu-and-amap-api.jpg?exif
直接用浏览器打开，可以很方便地找到所有 GPS 开头的属性。其中，海拔等数据可以忽略掉，位置信息最为重要的是经纬坐标，即以下四个值：
{
"GPSLatitude": {
"val": "23, 29, 10.91",
"type": 5
},
"GPSLatitudeRef": {
"val": "N",
"type": 2
},
"GPSLongitude": {
"val": "116, 46, 36.49",
"type": 5
},
"GPSLongitudeRef": {
"val": "E",
"type": 2
}
}
那么这个坐标为 23°29’10.91”N, 116°46’36.49”E，也就是北纬 24 度 29 分 10.91 秒，东经 116 度 46 分 36.49 秒。
在各种互联网地图上，坐标是以度为单位的，东经北纬为正值，西经南纬为负值。这里需要将度分秒的经纬度转换以度为单位的[2]，因度分秒之间为 60 进制，故转换公式为：
度分秒 = 度 + 分 / 60 + 秒 / (60 * 60)
计算后得出上面的坐标约为 116.776803, 23.486364，这是一个 WGS84 坐标。
坐标转换此前已经说过不少了，因在网页上使用，直接采用 coordtransform 模块[3] 即可，以上坐标转换为 GCJ02 是 116.781381, 23.483788。
可以使用高德的坐标拾取系统[4]，按坐标搜索一下，验证结果是否正确。
以上过程使用 JS 实现代码如下，需引入 coordtransform 模块。
var xhr = new XMLHttpRequest();
xhr.open('GET', 'http://source.fooleap.org/show-photo-location-on-map-with-qiniu-and-amap-api.jpg?exif', true);
xhr.onreadystatechange = function() {
if (xhr.readyState == 4 && xhr.status == 200)
{
var data = JSON.parse(xhr.responseText);
if ( !!data.GPSLongitude ) {
var olat = data.GPSLatitude.val.split(', ');
var olng = data.GPSLongitude.val.split(', ');
var lat=0, lng=0, coord;
for( var i = 0; i < olat.length; i++ ){
lat += olat[i] / Math.pow(60, i);
lng += olng[i] / Math.pow(60, i);
}
lat = data.GPSLatitudeRef.val == 'S' ? -lat: lat;
lng = data.GPSLongitudeRef.val == 'W' ? -lng: lng;
coord = coordtransform.wgs84togcj02(lng, lat).join(',');
}
}
}
xhr.send();
获取地址信息
有了坐标就有了地理位置，有了地理位置就知道是什么地方。高德地图逆地理编码 API[5] 正在招手：“给我一个坐标，我将还你一个详细地址。”
根据文档，最基本的只需 location 参数传个坐标即可返回地址信息。此 API 还可批量获取，可以根据自己需求传入可选的参数。
以上面获取的坐标为例：
http://restapi.amap.com/v3/geocode/regeo?location=116.781381,23.48378&key=<用户的key>
请求后返回的 JSON 如下，具体返回的参数的详细说明参考文档。
{
"status": "1",
"info": "OK",
"infocode": "10000",
"regeocode": {
"formatted_address": "广东省汕头市澄海区莲下镇渡亭村",
"addressComponent": {
"country": "中国",
"province": "广东省",
"city": "汕头市",
"citycode": "0754",
"district": "澄海区",
"adcode": "440515",
"township": "莲下镇",
"towncode": "440515102000",
"neighborhood": {
"name": [],
"type": []
},
"building": {
"name": [],
"type": []
},
"streetNumber": {
"street": "文明路",
"number": "159号",
"location": "116.78592,23.48872",
"direction": "东北",
"distance": "718.365"
},
"businessAreas": [
[]
]
}
}
}
准确度一般般，到乡（镇、街道）这一级基本没问题。我们也不需要太准确的信息，毕竟定位信息有时候还是挺隐私的。
显示相片地图
将相片显示在地图上，这似乎才是初衷，在这里，我将它分成两部分，一部分是静态地图，一部分是动态地图。
静态地图
将图片显示到静态地图上面，需要用到的高德地图 API 是静态地图 API[6]。
根据高德的文档，自定义标注（marker）图片只能支持 PNG 格式，需要多来一张图片吗？不需要，这里可以直接用七牛图片处理 API[7]，将原图调下大小并指定输出格式。
http://source.fooleap.org/show-photo-location-on-map-with-qiniu-and-amap-api.jpg?imageView2/1/w/100/h/100/format/png
上面的链接是输出等比缩放并居中裁剪的 100x100 PNG 格式图片，然而应用到高德接口还是出错了。我尝试在最后再加上 .png，结果成功，这意味着高德是以后缀名判断文件格式的，也是醉了。
http://restapi.amap.com/v3/staticmap?zoom=12&size=640*427&scale=2&markers=-1,http://source.fooleap.org/show-photo-location-on-map-with-qiniu-and-amap-api.jpg?imageView2/1/w/100/h/100/format/png.png,0:116.781381,23.48378&key=<用户的key>
以上拼凑出的链接显示如下。
高德静态地图 API 一样支持批量，具体可查看文档。
动态地图
想要在网页中实现跟苹果相册地图差不多样式且可控的地图，这就得用到高德地图 JS API，主要是用到点标记[8]，这里就不多废话了，直接上图。
具体实例跟上面所提到的，我全放在 Gist，可查看[9]，也可直接预览[10]。
参考资料
本文历史
- 2017 年 05 月 03 日 完成初稿
- 2017 年 07 月 05 日 完善
