【Google Maps】開發者注意!Maps Javascript API’s Places Library 二項參數即將停用

Google 曾於去年底正式公告opening_hours.open_now 以及 utc_offset 這兩項 Place filed 參數已開始啟動停用程序,面對這項異動,企業客戶應該如何調整與取代呢?

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_nowPlace Details請使用 opening_hours.isOpen() 方法來替代
opening_hours.open_nowFind Places沒有替代參數;建議改用 Place Details requests來取得opening_hours (是否為開放或是否營業) 結果
opening_hours.open_nowNearby Search / Text Search請用openNow呼叫參數來替代,此參數具備可篩選出回傳地點是否為開放營業資訊
utc_offsetPlace 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 任何問題,歡迎隨時與我們聯繫!

了解更多

相關文章

Leave Us Your Message.
We are ready to talk!

歡迎您與我們聯絡。
我們會協助您取得最佳解決方案!

歡迎您與我們聯絡。
我們會協助您取得最佳解決方案!

Leave Us Your Message.
We are ready to talk!

找不到您需要的? 加入我們的最新活動!

搶先了解
新趨勢