隨著科技進步與數位轉型的浪潮，Google 地圖一直在更新其 API 服務，讓開發者能夠更高效地整合地圖功能。從 2025 年 3 月 1 日起，深受大家喜愛的 Directions API 與 Distance Matrix API 將進入 Legacy 模式。雖然現有用戶仍可繼續使用，但如果你還沒在 Google Cloud Console 上啟用這兩項服務，就得盡快轉向新選擇！
為滿足日益增長的路線規劃與距離計算需求，Google 地圖早在 2022 年便推出了全新的 Routes API，這不僅整合了舊有 API 的優點，還加入了更多先進功能。今天就讓我們來看看為什麼這個更新如此值得關注，以及如何順利完成遷移。
為什麼要選擇全新 Routes API？
更快的反應速度
Google Maps Routes API 針對現代應用做了性能優化，能迅速回傳路線與距離資訊。不論你是在做即時導航還是需要預測交通狀況，這都是個大大的加分！
多元進階功能
- 收費資訊一手掌握： 除了計算距離，還能獲得詳細的收費資料，讓你能規劃更省錢的路線。
- 即時與預測交通狀況： 隨時了解路況，幫助使用者做出更準確的行程預估。
- 路線最佳化： 支援多達 25 個途徑點，讓你的應用能自動挑選出最佳路線。
- 多種交通模式： 除了傳統駕車外，Routes API 還新增了自行車、步行與機車等模式，滿足各種出行需求。
這些功能不僅對開發者有極大幫助，同時也是物流、旅遊、智慧城市規劃等領域不可或缺的工具。
如何順利遷移到 Routes API？
別擔心，下面的步驟將帶您輕鬆完成從舊 Google Maps API 到全新 Routes API 的轉換：
1. 先瞭解官方文件
在動手前，先瀏覽 Google 地圖提供的 Routes API 文件及遷移指南，熟悉每個細節。這樣做能幫助你順利過渡，避免出現意外狀況。
2. 更新你的 API 呼叫
將應用程式中原本使用的 Directions 與 Distance Matrix API 程式碼更新為新的 Routes API 呼叫，確保所有參數和端點都符合最新標準。
若你原先使用的是 Directions API
請改用 Routes API 的 Compute Routes 端點。範例如下：
POST https://routes.googleapis.com/directions/v2:computeRoutes
Content-Type: application/json; charset=utf-8
X-Goog-Api-Key: YOUR_API_KEY
X-Goog-FieldMask: routes.duration,routes.distanceMeters,routes.polyline,routes.legs,routes.travelAdvisory.tollInfo,routes.legs.travelAdvisory.tollInfo,routes.travelAdvisory.speedReadingIntervals
{
"origin": {
"location": {
"latLng": {
"latitude": 49.1951165,
"longitude": -123.1814285
}
}
},
"destination": {
"location": {
"latLng": {
"latitude": 50.1042288,
"longitude": -123.0840866
}
}
},
"travelMode": "DRIVE",
"polylineQuality": "OVERVIEW",
"routingPreference": "TRAFFIC_AWARE",
"departureTime": "2025-10-23T15:00:00Z"
}
如果你在使用 Distance Matrix API
改用 Routes API 的 Compute Route Matrix 端點，範例如下：
POST https://routes.googleapis.com/distanceMatrix/v2:computeRouteMatrix
Content-Type: application/json; charset=utf-8
X-Goog-Api-Key: YOUR_API_KEY
X-Goog-FieldMask: originIndex,destinationIndex,duration,distanceMeters,status
{
"origins": [
{
"waypoint": {
"location": {
"latLng": {
"latitude": 49.2682989,
"longitude": -123.1830924
}
}
}
}
],
"destinations": [
{
"waypoint": {
"location": {
"latLng": {
"latitude": 49.254563,
"longitude": -123.1121977
}
}
}
},
{
"waypoint": {
"location": {
"latLng": {
"latitude": 49.3137275,
"longitude": -123.0540365
}
}
}
},
{
"waypoint": {
"location": {
"latLng": {
"latitude": 49.2351204,
"longitude": -123.1692661
}
}
}
}
],
"travelMode": "DRIVE",
"routingPreference": "TRAFFIC_AWARE",
"departureTime": "2025-10-23T15:00:00Z"
}3. 測試與調整
完成程式碼更新後，務必進行全面測試。確保所有功能運作正常，尤其是新功能或資料格式上的改變。
4. 持續監控使用情況與費用
遷移成功後，記得定期檢查 API 使用情況與帳單。Routes API 採用按量付費模式，根據你在 X-Goog-FieldMask 中選擇的欄位，可能會對應到 Basic（每 CPM $5）、Advanced（每 CPM $10）或 Preferred（每 CPM $15）的計費方案。
專業支援就在 Master Concept
在 Master Concept，我們專注於協助各行各業整合 Google 地圖平台，無論您是需要 API 遷移、路線優化，還是最新定價策略，我們都能提供專業建議與技術支援。作為亞太區的官方 Google Maps Platform 合作夥伴，我們了解各行各業的需求，期待幫助更多企業客戶將地圖數據效益最大化！
如果你對 Routes API 遷移或 2025 年 Google Maps API 價格與政策調整有任何疑問，歡迎聯繫我們的專業團隊，一起打造更優秀的地圖使用體驗！
