常光临小博的博友不难发现，去年晒的几次跑步均有带上跑步路线地图，那么都是怎么实现的呢？这事暂且分两步来说，一是获取数据，二是显示地图。这篇主要讲获取数据部分。

讲正事之前，我先废话几句。跑步好处多多，对身体的好处不说，跑步爱好者就是喜欢各种装逼，有些人去参加马拉松就是为了去拍照的。我极少自拍，但几乎每次跑步途中都会拍几张图，跑步后贴到社交平台时间线，后面整理也有一些会贴到博客里面来。

折腾过程

作为地理爱好者的我，对跑步路线地图十分喜欢，于是就有了把跑步路线贴到博文中的想法。如何显示跑步路径这个问题令我头疼许久，要显示地图，就得获取到组成跑步折线相应的坐标数据，下面是我逐步实践的一个过程。

刚开始，我觉得只要自己根据跑步路线，地图上描点再用地图 API 画出来，大致差不多就行，于是就用 Google Earth 描点，并导出 KML 文件进行处理。

st=>start: 开始
e=>end: 结束
op1=>operation: Google Earth 画线 
op2=>operation: 转换坐标
op3=>operation: 地图 API 画线

st(right)->op1(right)->op2(right)->op3(right)->e

虽操作还算简单，但略显繁琐，且折线并非跑步的实际路线，显得有点 LOW，装逼还得认真点。

随后，我将目光转向 Nike+，因为 Nike+ 官网本身就有令人羡慕的跑步路线地图，肯定就有相应的坐标数据。不求能实现得跟他一模一样，哪怕窃取一小部分也可。

st=>start: 开始
e=>end: 结束
op1=>operation: Nike+ API 获取数据
op2=>operation: 转换坐标
op3=>operation: 地图 API 画线

st(right)->op1(right)->op2(right)->op3(right)->e

操作起来不算复杂，只需要去官网复制一个 ID 即可获取到相应的数据。这样做有个问题，每次转换坐标后得到的坐标数组太大了，经研究发现 Nike+ 大概每 10 米描一个点，跑个半马点的数量就是 2100 个。

把坐标数据放进一个静态页面里，真不是理智的方法，亏我好几次贴地图都是使用这种方法。

每次贴地图都需要操作好几个步骤，写篇博文略显麻烦，我觉得应该处理成传一个参数（活动 ID）即可返回跑步地图，后来我就将几个手动步骤写成脚本，直接显示地图。

st=>start: 开始
e=>end: 结束
op1=>operation: Nike+ API 获取数据
op2=>operation: 直接转换坐标
op3=>operation: 并使用地图 API 画线

st(right)->op1(right)->op2(right)->op3(right)->e

目前脚本用起来还算比较方便舒心，就是一旦 Nike+ API 有了变化，脚本就不能用，到时候再想办法解决。

实现流程

从前文不难看出，想要实现画跑步路线地图，大致流程如下：

st=>start: 开始
e=>end: 结束
op1=>operation: 获取数据
op2=>operation: 转换坐标
op3=>operation: 显示地图

st(right)->op1(right)->op2(right)->op3(right)->e

以上步骤缺一不可，获取数据是前提，转换坐标是必需，显示地图则是重点。

  1. Nike+ 官网本身就有跑步轨迹的显示，使用官网所用的 API 获取是准确的方法
  2. 转换坐标是我国多出的一步，Nike+ 所采用的是 WGS84 坐标系统，应将坐标点转换为地图 API 所采用的，路线才能在地图上正确显示，坐标转换在《百度地图坐标转换》已经有所提及
  3. 地图具体能折腾成什么样，还是取决于地图 JS API 以及前端技能的熟练程度

Nike+ API

去年早些时候，去 Nike+ 开发者门户网站[1]学习，但发现自己并无法获取到相关的 API Keys。不过在网站里有个 TEST CONSOLE，登录后可获得一个临时授权。使用 GPS Data[2] 这个 API 便可以轻松获取相关的坐标数据。

后来，Nike+ 网站改版，官网的 API 也升级为 V3 版，在此之后的 activityId，前面所说的 API V1 没法再用，获取不到 GPS 数据，也找不着 API V3 的相关文档。那我也只能硬着头皮在官网按 F12 去研究，寻找获取坐标数据的 API。

最终，发现 Nike+ 获取单次活动的 API 是这样的：

https://api.nike.com/sport/v3/me/activity/{activityId}

其中 activityId 是单次活动的 ID，在 Nike+ 官网查看源码、或点开某次活动后在地址栏，都可以找到。

这个接口返回的数据挺详细，详细到感觉文件有点大，其中有 metric 所有类型名的数组 metric_types。需要详细数据时，可通过 metrics 这个参数来指定，默认指定 all 则代表获取所有数据。具体的实例如下（只取经纬坐标的详细数据）：

https://api.nike.com/sport/v3/me/activity/e39a37be-d4e8-4ef7-82cc-0b255c0f2834?metrics=longitude,latitude

以上链接复制至浏览器打开，妥妥的提示未授权，返回去看官网那个请求头，发现字段 Authorization。

使用 PHP cURL 加上这个授权码去请求，成功返回想要的数据。

<?php 
$options = array(
    CURLOPT_URL => 'https://api.nike.com/sport/v3/me/activity/e39a37be-d4e8-4ef7-82cc-0b255c0f2834?metrics=longitude,latitude',
    CURLOPT_HEADER => false,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => array('Authorization: Bearer ******')
);
$curl = curl_init(); 
curl_setopt_array($curl, $options);
$data = curl_exec($curl); 
curl_close($curl); 
?>

本以为这个授权码会很快过期，可没想到几个月还一直能用，干脆就不考虑如何获取授权码的问题。后来亦发现官网在 LocalStorage 也存了不同的授权码，只不过其生命只有一个小时。

参考资料

本文历史

  • 2017 年 04 月 20 日 完成初稿