本文档有更新版本,其中包含如何使用新版 Places API 和 Routes API 的示例。
通常,当用户驾车前往某个地图注点 (POI) 时,他们实际上需要导航到附近的位置,例如停车场或入口。想象一下,一位司机需要前往机场或购物中心。前往机场时,司机试图到达航站楼或下车点,而不是机场建筑群的中心。同样,对于驾车出行的用户来说,购物中心旁边的停车场可能是更好的选择。在这种情况下,在开发应用或服务来引导驾驶员时,请先找到驾驶员要前往的位置,然后为驾驶员提供该位置附近的可选目的地。这种方法只需利用 Google Maps Platform 提供的位置数据进行少量但巧妙的开发工作,即可让您为客户提供更好的服务,并表明您重视他们的时间。
引导驾驶员驾车前往某个位置时所涉及系统的简化视图
我们将展示如何依次或结合使用 Places API 和 Directions API,以确定目的地附近的合适停车位置。 此解决方案旨在消除不确定性,避免在驾车接近最终目的地时多次互动寻找停车位。我们来看两个示例,详细了解如何实现这些用例。
示例 1 - 没有停车场的旅游景点
我们选择一个不直接与路边相连的位置,以便必须单独检索路线,目的地是巴黎的巴黎圣母院,起点是巴黎东站 (48.87697775149635, 2.3592247806755564)。
司机从巴黎圣母院以北约 16 分钟路程的车站出发。巴黎圣母院是岛上的著名旅游景点,可通过桥梁进入,附近有一些单行道,没有大型停车场,因此这应该是一个有趣的挑战。
Places API 请求
此示例 Places API 请求使用“文本搜索”来查找巴黎圣母院。如需了解详情,请参阅开发者文档。这些示例中的“YOUR_KEY”是您在 Google Cloud 控制台中启用的 Google Maps Platform Places API 和 Directions API 的 API 密钥。如需更详细的说明,请参阅 Google Maps Platform 使用入门文档。
https://maps.googleapis.com/maps/api/place/textsearch/json?query=notre_dame&location=48.864716%2C2.349014®ion=fr&key=YOUR_KEY
上述请求的响应会给出以下纬度和经度坐标:
"results" : [ { "formatted_address" : "Notre Dame, Paris", "geometry" : { "location" : { "lat" : 48.8527288, }, ...
如您所见,这些坐标确实指向巴黎圣母院。
|
|
作为开发者或服务提供商,最好自动提示司机“正在寻找巴黎圣母院附近的停车位?”。用户体验会因设备和屏幕而异,但在这种情况下,可以考虑使用在短时间后消失的细微弹出式文本。如需查找巴黎圣母院附近的停车场,请执行 Places API 文本搜索,并设置类型“parking”和半径“300”参数。此示例会将结果偏向于巴黎圣母院 300 米范围内的停车区域。
https://maps.googleapis.com/maps/api/place/textsearch/json?query=parking
&location=48.8527288%2C2.3505635®ion=fr&type=parking&radius=300&key=YOUR_KEY
第一条结果是“Parking Saemes Maubert-Lagrange”,位于 48.850591, 2.3486436。 在下一部分中,我们将在 Directions API 请求中使用此位置。
Directions API 请求
如需查找从车站到巴黎圣母院附近停车场的路线,您需要发出 Directions API 请求。只需设置起点和终点参数即可。如需了解更多选项,请参阅开发者文档。
https://maps.googleapis.com/maps/api/directions/json?origin=48.8767903,2.3592251&destination=48.850591%2C2.3486436&key=YOUR_KEY
Direction API 响应通常包含多条路线建议。每条路线都由多个“路段”组成,这些路段包含多个“步骤”,用于显示行程距离和坐标。如需查找驾车可到达的最终坐标,请使用所选路线中最后一个路段的最后一步的“end_location”字段。
这个位置可能看起来不是首选,但如果您查看地图或 Google 街景,就会发现这个位置距离巴黎圣母院非常近,步行只需大约 6-7 分钟。
从停车区到巴黎圣母院的步行路线
示例 1 摘要
如您所见,只需进行几次 API 调用,即可为汽车找到停车区域,并向驾驶员显示建议。这可以为用户节省时间,因为他们无需在单行道上绕行,也无需在拥挤的旅游景点寻找停车位。总结一下,我们发出了以下 API 请求:
- 用于查找巴黎圣母院坐标的 Places API 请求
- Places API 请求,用于查找这些坐标 300 米范围内的停车区域
- 用于查找前往停车区域的路线的 Directions API 请求
示例 2 - 引导用户前往大型机场的航站楼
"types" : [ "airport", "point_of_interest", "establishment" ],
不过,任何去过大型机场的人都知道,如果您不小心到达了错误的地点,那么在航站楼之间换乘需要花费大量时间。在这种情况下,由于搜索结果的类型为“机场”,因此使用伦敦希思罗机场的位置 (51.47016927594547, -0.45432767852489075) 自动跟进查询以搜索“航站楼”会很有用。在此示例中,您还可以看到可选的搜索半径限制(3,000 米)。
https://maps.googleapis.com/maps/api/place/textsearch/json?query=terminal&location=51.47016927594547%2C-0.45432767852489075®ion=gb&key=YOUR_KEY&radius=3000
上述查询会返回航站楼以及这些航站楼中各个下车点的列表。从结果列表中,我们可以找到“London Heathrow Airport Terminal 5”及其地点 ID:
"place_id" : "ChIJtQRd6XVxdkgRTUGZtcsoGNc",
使用“place_id”参数,我们可以告知 Directions API 我们要到达的是某个地点,而不是任意坐标。
https://maps.googleapis.com/maps/api/directions/json?origin=51.557263604707224,-0.2794575145680608&destination=place_id:ChIJtQRd6XVxdkgRTUGZtcsoGNc&key=YOUR_KEY
同样,如上例所示,通过读取 JSON 响应中的所有步骤,您将找到行程的最后一部分以及终点位置的纬度和经度坐标 (51.47079979999999,-0.4896765)。
示例 2 的摘要
与上一个示例一样,为司机提供改进的路线指引所需的开发工作量非常小,而司机节省的时间却很容易衡量。我们发出了以下请求:
- 用于查找希思罗机场的 Places API 请求
- 一个 Places API 请求,用于查找靠近希思罗机场坐标的所有航站楼
- Directions API 请求,用于获取前往 5 号航站楼的路线
总结
如您所见,为驾车出行的客户提供优质服务所需的开发工作量相当小,您可以轻松展示您对客户需求的考虑。
在开发过程中,您可以使用许多可用的库和工具来帮助您为客户构建服务。请查看我们公开提供的 Google Maps Platform GitHub 代码库。
后续操作
主要作者
Mikko Toivanen | Google Maps Platform 解决方案工程师