所有 Google Maps Roads API 应用都需要使用 API 密钥进行身份验证。通过在请求中加入密钥,您可以在 Google API Console 中监控您的应用的 API 使用情况,能够获取大量的每日免费配额,并确保 Google 可以在必要时就应用的相关事宜与您联系。
- 标准 API 客户需要一个在您所选择的项目中设置的 API 密钥。
- Google Maps APIs Premium Plan 客户需要一个在 Google Maps Premium 项目(在您订购 Google Maps Roads API 时为您创建的项目)中设置的 API 密钥。如果您尚未购买 API 的访问权限,请联系销售人员。
API 密钥
如果您使用的是标准 Google Maps Roads API:
点击下面的按钮,它可以将您转到 Google API Console,引导您完成整个过程,并自动激活 Google Maps Roads API。
获取密钥或者,请按照下列步骤获取 API 密钥:
- 转至 Google API Console。
- 创建或选择一个项目。
- 点击 Continue 以启用 API。
- 在 Credentials 页面上,获取 API 密钥(并设置 API 密钥限制)。
注:如果已有不受限的 API 密钥或拥有存在服务器限制的密钥,可以使用该密钥。 - 为了防止配额盗用,请遵循这些最佳做法保护您的 API 密钥。
- (可选)启用计费。如需了解详细信息,请参阅使用限制。
如果您已购买 Google Maps APIs Premium Plan 许可证:
要开始使用 Google Maps Roads API,请点击下面的按钮,它可以将您转到 Google API Console,引导您完成整个过程。重要说明:在项目下拉菜单中,请务必选择当您购买 Premium Plan 时为您创建的项目。*
获取密钥或者,请按照下列步骤获取 API 密钥:
- 转至 Google API Console。
- 从项目下拉菜单中,选择 Google Maps Premium 项目。*
- 点击 Continue。
- 在 Credentials 页面上,获取 API 密钥(并设置 API 密钥限制)。
注:如果已有不受限的 API 密钥或拥有存在服务器限制的密钥,可以使用该密钥。 - 为了防止配额盗用,请遵循这些最佳做法保护您的 API 密钥。
* 注:在项目下拉菜单中,您必须选择当您购买 Premium Plan 时为您创建的项目。根据您合同的不同,项目名称会以 Google Maps APIs for Business 或 Google Maps for Work 或 Google Maps 开头。
您也可以在 Google API Console 中查找现有密钥。
如需了解有关使用 Google API Console 的详细信息,请参阅 API Console 帮助。
API 密钥限制的类型
Google Maps API 可用于 Android 或 iOS 应用、网络浏览器,并可通过 HTTP 网络服务使用。任何平台上的 API 均可以使用通用(无限制的)API 密钥。您可以选择向 API 密钥添加限制(例如 IP 地址)。受限后,密钥仅会在支持这一类型限制的平台上有效。详细了解密钥和凭据。
在您的请求中指定密钥
如需在您的请求中指定密钥,请将其作为 key 参数的值加入。
例如:
https://roads.googleapis.com/v1/snapToRoads?path=-35.27801,149.12958|-35.28032,149.12907|-35.28099,149.12929|-35.28144,149.12984|-35.28194,149.13003|-35.28282,149.12956|-35.28302,149.12881|-35.28473,149.12836 &interpolate=true &key=YOUR_API_KEY
