Google API 简介:第 2 部分🌎

2025-06-09

Google API 简介:第 2 部分🌎

在这篇文章中,我们将继续使用 Google API,特别关注 Google Maps API。

Google Maps API 提供了各种端点,可用于执行不同类型的操作。一些最常见的端点包括:

  • 地理编码 API(可用于将地址转换为坐标);
  • Directions API(可用于计算地点之间的方向);
  • Places API(允许您搜索兴趣点);
  • 距离矩阵 API(可用于计算位置之间的距离)。

Google Maps API 是一款功能强大的工具,它通过为 Android、iOS 和 JavaScript 等不同平台提供 SDK,允许开发者为其应用程序添加地图和基于位置的功能。凭借丰富的端点和请求,它提供了极大的灵活性,可用于创建各种不同类型的应用程序。

Google Maps API 采用 RESTful 架构,这意味着可以使用标准 HTTP 请求进行访问。该 API 支持 GET 和 POST 请求,其中 GET 请求用于检索信息,POST 请求用于提交新数据。所有 API 请求都必须使用 API 密钥或访问令牌进行身份验证,这些密钥或令牌可通过 Google Cloud Console 获取。

向 API 发出请求时,您可以指定各种参数来自定义请求。例如,您可以使用“address”或“latlng”参数指定位置,并使用“sensor”参数指示请求是否来自具有 GPS 功能的设备。您还可以使用“language”参数指定返回响应时应使用的语言。

Google Maps API 提供多种不同类型的响应,包括 JSON 和 XML 格式。此外,该 API 有使用限制,在一定限度内可以免费使用,但超出限度则需要付费。

下面,我想展示一些如何使用 API Tester 应用使用 Google Maps API 的示例。

Google 地点 API

Google Places API 是 Google Maps API 中的一项服务,允许开发者搜索地点,例如商家、地标和兴趣点。要访问 Google Places API,您需要拥有有效的 Google Maps API 密钥(请参阅此文,了解如何生成您的个人 API 密钥

获得 API 密钥后,您可以使用 API Tester 应用向 Google Places API 发出请求。您需要将 API 密钥添加到每个请求中,方法是将其添加到请求标头中,或将其作为请求网址中的查询参数。

请记住,您还需要启用要使用的特定 Google Maps API,您可以通过转到 Google Cloud Console,然后导航到“API 和服务”部分,选择“库”,找到 Google Maps API 并启用它来启用它。

寻找地点

要使用 Google Maps API 和 API Tester 应用搜索地点,您可以使用 Places API。您需要将请求方法设置为 GET,并设置 Places API 的端点网址,然后在请求参数中指定要搜索的位置、关键字和地点类型。

例如,要在 2000 半径内搜索纽约的披萨店,您可以使用以下端点:

https://maps.googleapis.com/maps/api/place/nearbysearch/json?location=40.748817,-73.985428&radius=2000&keyword=pizza&key=YOUR_API_KEY
Enter fullscreen mode Exit fullscreen mode

在 API Tester 应用中它将看起来像这样:

图片描述

在查询参数部分,添加您的 API 密钥以及您需要的任何其他参数。请务必将示例参数替换为您自己的值。设置好请求后,您可以对其进行测试并从 API 中检索所需的信息。

图片描述

一旦所有信息参数和 API 密钥正确无误,就会生成 200 响应代码,您可以在图片中看到它。我获取了 2000 米范围内所有披萨餐厅的信息,包括它们的位置、营业时间以及营业/关门时间。这就是我从 Google Places API 中获取的信息。

图片描述

搜索特定地点的详细信息

Google Places API 请求的另一个示例是获取特定地点的信息。此请求的端点如下:

https://maps.googleapis.com/maps/api/place/details/json?place_id=ChIJrXXKn5NZwokR78gOipCnY60&key=YOUR_API_KEY
Enter fullscreen mode Exit fullscreen mode

要获取响应,您需要添加 place_id 参数和您的 API 密钥。要查找特定地点的 ID,您可以使用上面描述的请求。在响应中,您可以找到唯一的地点标识符:

图片描述

复制它并将其放置在请求的查询参数部分。

图片描述

基本上就是这样;现在,当所有参数都设置好后,点击播放按钮并探索响应:

图片描述

可以看出,通过对 Google Places API 进行 API 调用,我们收到了有关某个特定地点的大量不同信息,包括地址组成部分、地点概览、电话号码、地点名称、开放时间等。

图片描述

Google 地理编码 API

使用 Google API 的另一个很好的例子是地理编码。此函数将地址或地点 ID 转换为经纬度坐标,反之亦然。要执行地理编码功能,请使用以下端点:

https://maps.googleapis.com/maps/api/geocode/json?address=1920%20Bank%20Rue%2012%20Ottawa%20Ontario&language=en&region=en&key=YOUR_API_KEY
Enter fullscreen mode Exit fullscreen mode

这里最重要的是,您需要在查询参数部分正确粘贴要转换的地址。您需要:
a) 使用官方邮政地址(格式);
b) 将地址元素之间的所有空格更改为“%20”。

否则,您将无法获得必要的回应。

顺便说一下,在 API Tester 查询参数中,描述包含特定参数的规则和数据。这非常方便,因为您无需查阅文档来填写查询参数的值。

还有一件重要的事情需要考虑:您需要在请求 URL 中声明输出格式(JSON 或 XML),并在请求标头中重复此格式。
 
在 API Tester 中,此地理编码请求将如下所示:

图片描述

不要忘记将您的 API 密钥放在查询参数部分!

图片描述

设置所有参数后,即可运行请求。重要提示:本例中,我仅使用了地址和密钥等必需参数(语言和区域为可选参数),但您也可以使用其他参数,例如边界、组件、place_id 和坐标。

对于这个地址1920 Bank Rue #12, Ottawa, Ontario,我们得到以下响应:

图片描述

如您所见,只需输入一个特定地址,我们就能获得有关地址组成部分的信息,包括地点名称、经纬度、place_id 等。

图片描述

结论

Google Maps API 及其附加服务为所有开发者提供了极其有用的数据,不仅能帮助他们探索世界各地的不同地点信息,还能帮助开发者基于此 API 创建自己的应用或软件。本文仅展示了三个使用 Google Maps API 的示例,但其实还有很多其他端点可供使用。

总而言之,希望这篇文章能对你有所帮助!欢迎在评论区分享你使用 Google Maps API 的经验!

顺便说一句,你可以请我喝杯咖啡来支持我的工作!我会在这里留下一些链接给你:)

在 ko-fi.com 给我买杯咖啡

您也可以在Coinbase上支持我

鏂囩珷鏉ユ簮锛�https://dev.to/mariamarsh/introduction-to-google-apis-pt-2-5hk5
PREV
面向开发人员的 5 大加密货币 API ©️ 1. Binance API 2. CoinGecko API 3. Kraken API 4. Coinbase API 5. CoinMarketCap API
NEXT
Google API 简介:第一部分