Google Maps API 密钥生成与限制配置教程

生成 API 密钥

Google Maps Platform 的所有 API 和 SDK 都需要一个有效的 API 密钥，用于身份验证和计费。以下是生成 API 密钥的步骤：

1. 前往 Google Cloud Platform 控制台
   确保你已经选择了要为哪个项目生成或限制 API 密钥。

2. 创建 API 密钥
   

   • 选择页面左上角的菜单按钮，将鼠标悬停在“API 和服务”上，然后选择“凭据”。
     
   • 在“凭据”页面上，依次点击“创建凭据 > API 密钥”。
     
   • 点击“创建”后，你会看到一个弹出式窗口，显示你的新 API 密钥。此密钥还会显示在页面上的 API 密钥列表中。
   • 系统会给密钥默认分配一个名称，但你可以随时点击它旁边的修改图标，给密钥重命名和调整限制。

3. 使用 Cloud SDK 创建 API 密钥（可选）
   如果你更喜欢使用命令行工具，可以通过 Google Cloud SDK 创建 API 密钥：

   gcloud services api-keys create \
      --project ""YOUR_PROJECT_ID"" \
      --display-name ""YOUR_DISPLAY_NAME""

限制 API 密钥

限制 API 密钥虽非必要，但强烈建议这么做，因为它们有助于确保你的账号安全无虞，防止你的项目遭到意外或恶意使用。以下是限制 API 密钥的步骤：

1. 点击修改图标
   在“凭据”页面的 API 密钥列表中，点击你想要限制的密钥旁边的修改图标。

2. 设置应用限制
   

   • HTTP 引荐来源网址限制：适用于从网站或 Web 应用发出请求的 API 密钥。例如，添加 emilysdonuts.com 将仅允许来自该域名的请求。
   • IP 地址限制：适用于从特定 IP 地址调用 Google Maps Platform 的后端开发者。
   • Android 应用限制：需要指定软件包名称和 SHA-1 签名证书。
   • iOS 应用限制：需要指定至少一个 iOS 软件包标识符。

3. 设置 API 限制

   • 点击“限制密钥”，然后从“选择 API”下拉菜单中选择你希望此密钥访问的 API。
   • 你可以在任何应用限制的基础上添加 API 限制。

4. 保存限制
   
   设置完密钥限制后，点击“保存”。限制最多可能需要 5 分钟才会完全生效。

使用 API 密钥

在每个 Google Maps Platform 请求中，都需要添加你的 API 密钥。例如，对于 Maps JavaScript API，你可以这样添加：

<script>
  (g=>{var h,a,k,p=""The Google Maps JavaScript API"",c=""google"",l=""importLibrary"",q=""__ib__"",m=document,b=window;b=b[c]||(b[c]={});var d=b.maps||(b.maps={}),r=new Set,e=new URLSearchParams,u=()=>h||(h=new Promise(async(f,n)=>{await (a=m.createElement(""script""));e.set(""libraries"",[...r]+"""");for(k in g)e.set(k.replace(/[A-Z]/g,t=>""_""+t[0].toLowerCase()),g[k]);e.set(""callback"",c+"".maps.""+q);a.src=`https://maps.${c}apis.com/maps/api/js?`+e;d[q]=f;a.onerror=()=>h=n(Error(p+"" could not load.""));a.nonce=m.querySelector(""script[nonce]"")?.nonce||"""";m.head.append(a)}));d[l]?console.warn(p+"" only loads once. Ignoring:"",g):d[l]=(f,...n)=>r.add(f)&&u().then(()=>d[l](f,...n))})({
    key: ""YOUR_API_KEY"",
    v: ""weekly"",
    // Use the 'v' parameter to indicate the version to use (weekly, beta, alpha, etc.).
    // Add other bootstrap parameters as needed, using camel case.
  });
</script>

对于 Maps Embed API，请求格式如下：

https://www.google.com/maps/embed/v1/MAP_MODE?key=YOUR_API_KEY&parameters

总结

通过以上步骤，你可以成功生成并限制 Google Maps API 密钥，从而确保你的项目安全且符合 Google Maps Platform 的使用要求。如果你在配置过程中遇到任何问题，可以参考 Google Developers 官方文档。

原文引自YouTube视频：https://www.youtube.com/watch?v=2_HZObVbe-g