常見問題
遇到問題了嗎?不用擔心,答案都在這。
分類目錄
全站搜尋

    私有主機版如何設定 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樓
    使用者條款 | 隱私權政策