常见问题
遇到问题了吗?不用担心,答案都在这。
归类目录
全站搜索

    私有主机版如何设置 Google Maps API 密钥

    私有主机版使用 Google Maps 相关功能时,需自行申请并设置 Google Maps API 密钥,使用费用由 Google 依其计价方式收取。若未设置,以下功能将受到影响:

    • 地图选点、地址自动完成、依目前位置带入地址,以及地图报表:无法使用。
    • 地址字段设置为“显示为静态地图”时的地图图片,包括表单页面、PDF 汇出、Email 通知、打印预览、主页元件、部分报表及 API 格式化引出:改为显示地址字。

    既有的地址数据不会因此删除。

    申请 Google Maps API 密钥

    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 官方密钥安全建议。

    在 Ragic 中设置

    以 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 服务器加载,收件者必须能联机到该服务器才能看到。若服务器仅限内网访问,外部收件者将无法看到地图图片。

    提供回馈给 Ragic

    请告诉我们您的意见:(多选, 必填)

    请针对上方勾选项目提供详细说明:

    截屏能够让我们更清楚了解您的建议:

    感谢您的宝贵意见!

    马上登记
    免费试用 Ragic!

    用 Google 帐号登记

    立即科技 Ragic, Inc.
    02-7728-8692
    info@ragic.com
    台北市中正区南昌路二段81号9楼
    用户条款 | 隐私权政策