关于Google Maps API强制使用API密钥的技术咨询

Hey，我完全懂你现在的处境——之前一直用无密钥的方式加载Google Maps，突然收到通知说2018年6月11日之后必须加API密钥，还要给多个项目做过渡，肯定一堆问号。我结合官方规则和实际项目迁移的经验，给你梳理最关键的信息，帮你顺利完成过渡：

1. 怎么修改你当前的API调用URL？ #

你现在用的这个调用地址：

<script type="text/javascript" src="https://maps-api-ssl.google.com/maps/api/js?sensor=true"></script>

首先，sensor参数早就被官方弃用了，可以直接删掉。然后必须加上你的API密钥，修改后的标准格式是：

<script type="text/javascript" src="https://maps.googleapis.com/maps/api/js?key=你的API密钥"></script>

注意：这个密钥得是你在Google Cloud控制台创建的，并且要给它启用Maps JavaScript API权限，不然调用会直接报错。

2. 多项目怎么管理API密钥才合理？ #

建议给每个项目单独创建一个API密钥，别共用！这样做有几个核心好处：

• 可以给每个密钥设置独立的应用限制（比如只允许你的项目域名调用），防止密钥被别人盗用滥用；
• 能分别监控每个项目的API调用量，方便排查流量异常或者费用问题；
• 万一某个项目的密钥出问题，不会牵连其他正常运行的项目。

3. 过渡期间会不会有兼容坑？ #

只要你的代码没用到旧版未授权模式的特殊逻辑，替换成带密钥的调用后，地图功能应该和之前完全一致。不过有两个细节要注意：

• 如果你的项目还在使用非常老旧的API版本（比如v2），那必须升级到v3（现在官方只维护v3版本），不过大多数项目应该早就完成这个升级了；
• 测试的时候要在生产环境的域名下测，要是你给密钥设了域名限制，本地localhost测试可能需要临时调整限制，或者专门创建一个测试用的密钥。

4. 免费额度够不够支撑多项目？ #

Google Maps API有每月的免费调用额度，只要你的项目不是流量特别大的那种，免费额度基本够用。你可以在Google Cloud控制台的账单页面设置使用告警，一旦接近额度就会提醒你，避免意外产生费用。

5. 旧的无密钥调用之后会怎么样？ #

从2018年6月11日开始，所有无密钥的API调用都会返回错误，地图直接加载不出来，所以一定要在这个截止日期前完成所有项目的替换，别拖到最后踩坑。

过渡小技巧 #

• 先挑一个测试项目或者流量最小的项目做验证，确认没问题后再批量推广到其他项目；
• 要是项目数量多，可以写个简单的脚本批量替换代码里的旧URL，省得手动改到吐；
• 记得给团队里的所有开发者同步这个要求，避免有人在新代码里还沿用旧的调用方式。

内容的提问来源于stack exchange，提问作者Dhiraj