私有主機版使用 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 伺服器載入,收件者必須能連線到該伺服器才能看到。若伺服器僅限內網存取,外部收件者將無法看到地圖圖片。