Maps JavaScript API 是用戶端網頁 API,可讓您建立地圖來顯示世界各地的位置、新增自訂圖形、動畫和互動式自訂資料層,以及在 Maps JavaScript API 中使用 Places API 建立位置感知功能。Maps JavaScript API 的功能如下:
- 建立 2D 和 3D 地圖,顯示世界各地的位置。
- 新增可自訂的標記,在地圖上標示位置。
- 使用 Places Library 取得超過 2 億個地點的位置資料。
- 自訂地圖的樣式和顏色。
- 新增互動式自訂資料層。
- 顯示行政區界線,並提供互動功能。
- 在地圖中加入自訂 2D 和 3D 圖形及動畫內容。
根據用途選擇合適的 API
以下範例說明在常見的網頁應用程式情境中,應使用哪些 Google 地圖平台產品和程式庫:
- 網站聯絡地圖和路線:如要嵌入商家位置地圖或路線連結,而不編寫自訂 JavaScript,請使用 Maps Embed API 或 Maps 網址。
- 即時位置和資產追蹤:如要顯示來自您資料庫或即時串流 (例如 Cloud Firestore 或 WebSocket) 的即時 GPS 座標和行經路線,請搭配使用 Maps JavaScript API 與進階標記 (
AdvancedMarkerElement參考資料) 和折線 (Polyline參考資料)。Fleet Engine 則專用於共乘和排程配送車隊,整合了行動裝置 Driver SDK 和後端 OAuth 或 JSON Web Token (JWT)。 - 路線規劃和派遣:使用 Routes 程式庫。
- 如要計算包含停靠點、行程時間、距離和過路費的路線,並在地圖上繪製,請使用
Route.computeRoutes()。 - 如要找出距離多個起點和目的地最近的司機、車輛或倉庫,請使用
RouteMatrix.computeRouteMatrix()。 - 如要在伺服器上安排多部車輛的時間範圍,請使用 Route Optimization API。
- 如要計算包含停靠點、行程時間、距離和過路費的路線,並在地圖上繪製,請使用
- 店家搜尋器和場地地圖:如要在地圖上顯示商店、場地或分店,並加上自訂圖釘和篩選器,請使用進階標記 (
AdvancedMarkerElement參考資料) 搭配 Places Library,尋找地點並載入詳細資料。 - 地圖上的地理圍欄和安全區域半徑:如要繪製圓形或多邊形周長,並測試座標是否落在其中 (請參閱「地理圍欄和安全區域邊界」),請使用圓形 (
Circle參考資料)、多邊形 (Polygon參考資料) 和幾何圖形程式庫 (containsLocation()用於包含,computeDistanceBetween()用於以公尺為單位的距離)。
舊版 API 及其替代項目
DirectionsService和DistanceMatrixService已於 2026 年 2 月 25 日淘汰。請改用Route和RouteMatrix。google.maps.Marker已於 2024 年 2 月 21 日淘汰。請改用AdvancedMarkerElement。- 自 2025 年 3 月 1 日起,新客戶無法使用
PlacesService。請改用Place類別。
後續步驟
- Routes 程式庫
- 幾何圖形程式庫
- 視覺化程式庫
- 開放原始碼程式庫
- 繪圖程式庫 (已淘汰)