Google 地圖平台 (Google Maps Platform) 為 Google Cloud Platform 生態圈的一環,簡單來說,這是企業版的 Google Maps。 Google Maps 提供多種 API 與 SDK 讓企業內部開發者免於重新研發其功能,而是能直接透過串接 API 的方式讓自家的產品或解決方案能為客戶帶來更好的使用體驗。
”Google 地圖平台可讓企業利用 Google Maps 準確的即時資料和動態圖像,打造出身歷其境的地點體驗,並做出更明智的業務決策。“ – Google Cloud
Maps API 參數停用公告
為了更好的協助企業客戶,Google 團隊也會持續更新不同產品(地圖 Maps、路徑 Route 以及地點 Place)的 API 與 SDK。Google 曾於去年底正式公告 opening_hours.open_now 以及 utc_offset 這兩項 Place filed 參數已開始啟動停用程序,此兩支參數,將於 2021 年 2 月 20 日於 Maps Javascript API’s Places Library 正式停止服務。
所有 Google Maps Platform 企業客戶,若您的專案 (Project) 會受到影響,應該已經收到來自Google 所寄發的通知函。若您的網站與應用程式有使用此二項 Place filed 參數,請務必請程式開發人員進行程式碼更新。
這2支 Maps Javascript API’s Places Library Place filed 參數,在哪裡會用到呢?
- opening_hours.open_now : 使用 Place Details、Find Place、Nearby Search、Text Search 等法呼叫語法的回傳結果參數
- utc_offset :使用 Place Details 呼叫語法的回傳結果參數
為什麼 Google 要停用?
這是為了維持不同開發平台的一致性,包括Maps Javascript API, Places SDK for Android, Places SDK for iOs等
新舊程式碼參數的取代與置換
詳請參考 官網詳細移轉說明與語法範例
原本參數 | 呼叫語法 | 替代參數 |
opening_hours.open_now | Place Details | 請使用 opening_hours.isOpen() 方法來替代 |
opening_hours.open_now | Find Places | 沒有替代參數;建議改用 Place Details requests來取得opening_hours (是否為開放或是否營業) 結果 |
opening_hours.open_now | Nearby Search / Text Search | 請用openNow呼叫參數來替代,此參數具備可篩選出回傳地點是否為開放營業資訊 |
utc_offset | Place Details | 請使用 utc_offset_minutes 來替代 |
於 2021 年 2 月 20 日開始,Maps Javascript API’s Places Library 如有使用以上二項 Place field 參數者,程式回傳結果將會停止回應;若尚未完成相關參數替代與更新,將會看到 PlacesResult object 回傳結果出現 Unsupported field name 錯誤訊息、回傳值顯示為未定義(undefined) 。
思想科技建議,若您的企業目前正在使用 opening_hours.open_now 或 utc_offset 這2支 Maps Javascript API’s Places Library Place filed 參數,務必於2021 年 2 月 20 日前採取行動,及早進行程式碼參數修正。 程式開發人員可以參考 官網詳細移轉說明與語法範例 進行程式碼參數更新,以避免影響您的企業網站或應用程式前端使用者的用戶體驗。
思想科技 Master Concept 為台灣首間 Google Cloud 合作夥伴,同時也是首間獲得 Google Maps Platrofm 認證資格的合作夥伴,至今已協助零售業、房地產業、共享運輸、物流業等橫跨各產業的企業客戶提供專業諮詢與技術導入。若您對於 Google Maps Platrofm 任何問題,歡迎隨時與我們聯繫!