私有主机版使用 Google Maps 相关功能时,需自行申请并设置 Google Maps API 密钥,使用费用由 Google 依其计价方式收取。若未设置,以下功能将受到影响:
既有的地址数据不会因此删除。
1. 请至 Google Cloud Console 创建或选择专案并绑定帐单帐户(Google Maps Platform 需启用帐单才能使用),接着启用以下 API:
Maps JavaScript API
Places API (New)
Geocoding API
Maps Static API
2. 接着创建两组 API 密钥,分别供浏览器与 Ragic 服务器使用,并设置以下使用限制:
| 密钥 | 应用程序限制 | 许可使用的 API |
|---|---|---|
| Browser key(浏览器密钥) | 选择“站点”,加入实际使用 Ragic 的站点网址。 | Maps JavaScript API、Places API (New)、Geocoding API、Maps Static API |
| Server key(服务器密钥) | 选择“IP 地址”,加入 Ragic 服务器对外联机使用的公开 IP 地址。 | Places API (New)、Geocoding API、Maps Static API |
注意:
1. Browser key(浏览器密钥)会出现在网页中,请务必设置站点限制。
2. Server key(服务器密钥)请妥善保管,不要公开。
详细设置方式请参阅 Google 官方密钥安全建议。
以 SYSAdmin 身分进入“私有主机设置”页面填入以下设置,或直接编辑 conf/ragic.properties。保存后请重新启动 Ragic 服务使设置生效。
GOOGLE_MAPS_BROWSER_KEY=你的 Browser key GOOGLE_MAPS_SERVER_KEY=你的 Server key GOOGLE_MAPS_PROXY_SECRET=你自行生成的随机密钥GOOGLE_MAPS_PROXY_SECRET 是由你自行生成的随机密钥,不需向 Google 申请,用来保护对外提供的地图图片链接。建议使用安全的随机生成工具,例如运行以下指令:
openssl rand -hex 16
注意:
1. 请妥善保存 GOOGLE_MAPS_PROXY_SECRET,设置后请尽量不要替换。替换后,先前生成的地图图片链接将失效,包括已寄出 Email 中的地图图片。
2. 若未设置 GOOGLE_MAPS_PROXY_SECRET,Email 通知、打印预览、主页元件、部分报表及 API 格式化引出中的静态地图会改为显示地址字。在两组 Google API 密钥已正确设置的前提下,表单页面与 PDF 汇出的静态地图不受影响。
3. Email 中的地图图片会透过你的 Ragic 服务器加载,收件者必须能联机到该服务器才能看到。若服务器仅限内网访问,外部收件者将无法看到地图图片。