Maps JavaScript API là một API web phía máy khách cho phép bạn tạo bản đồ để hiển thị các vị trí ở bất cứ đâu trên thế giới, thêm đồ hoạ, ảnh động và các lớp dữ liệu tuỳ chỉnh tương tác của riêng bạn, đồng thời tạo các tính năng nhận biết vị trí bằng cách sử dụng Places API trong Maps JavaScript API. Với Maps JavaScript API, bạn có thể:
- Tạo bản đồ 2D và 3D để hiển thị các vị trí ở bất cứ đâu trên thế giới.
- Thêm điểm đánh dấu có thể tuỳ chỉnh để cho biết vị trí trên bản đồ.
- Sử dụng Thư viện địa điểm để lấy dữ liệu vị trí của hơn 200 triệu địa điểm.
- Tuỳ chỉnh kiểu và màu sắc của bản đồ.
- Thêm các lớp dữ liệu tuỳ chỉnh tương tác của riêng bạn.
- Hiển thị ranh giới hành chính và cho phép tương tác với ranh giới đó.
- Thêm nội dung ảnh động và đồ hoạ 2D và 3D tuỳ chỉnh vào bản đồ.
Chọn API phù hợp với trường hợp sử dụng của bạn
Các ví dụ sau đây cho thấy những sản phẩm và thư viện của Google Maps Platform nên dùng cho các trường hợp ứng dụng web phổ biến:
- Bản đồ và chỉ đường liên hệ trên trang web: Để nhúng bản đồ vị trí doanh nghiệp hoặc đường liên kết chỉ đường mà không cần viết JavaScript tuỳ chỉnh, hãy sử dụng Maps Embed API hoặc URL của Maps.
- Theo dõi vị trí và tài sản theo thời gian thực: Để hiển thị toạ độ GPS và đường đi theo thời gian thực từ cơ sở dữ liệu của riêng bạn hoặc luồng dữ liệu theo thời gian thực (chẳng hạn như Cloud Firestore hoặc WebSockets), hãy sử dụng API JavaScript của Maps cùng với Điểm đánh dấu nâng cao (tài liệu tham khảo
AdvancedMarkerElement) và hình nhiều đường (tài liệu tham khảoPolyline). Dành riêng Fleet Engine cho các đội xe đi chung và giao hàng theo lịch trình có tích hợp SDK Trình điều khiển di động và OAuth phụ trợ hoặc Mã thông báo web JSON (JWT). - Lập kế hoạch và điều phối tuyến đường: Sử dụng thư viện Tuyến đường.
- Để tính toán một tuyến đường có các điểm dừng, thời gian di chuyển, khoảng cách và phí cầu đường, đồng thời vẽ tuyến đường đó trên bản đồ, hãy sử dụng
Route.computeRoutes(). - Để tìm tài xế, xe hoặc kho hàng gần nhất tại nhiều điểm xuất phát và điểm đến, hãy sử dụng
RouteMatrix.computeRouteMatrix(). - Để lên lịch cho nhiều xe có khung thời gian trên máy chủ, hãy sử dụng Route Optimization API.
- Để tính toán một tuyến đường có các điểm dừng, thời gian di chuyển, khoảng cách và phí cầu đường, đồng thời vẽ tuyến đường đó trên bản đồ, hãy sử dụng
- Công cụ định vị cửa hàng và bản đồ địa điểm: Để hiển thị cửa hàng, địa điểm hoặc chi nhánh trên bản đồ bằng ghim và bộ lọc tuỳ chỉnh, hãy sử dụng Điểm đánh dấu nâng cao (tài liệu tham khảo
AdvancedMarkerElement) cùng với Thư viện địa điểm để tìm địa điểm và tải thông tin chi tiết về địa điểm. - Bán kính khoanh vùng địa lý và vùng an toàn trên bản đồ: Để vẽ các đường ranh giới hình tròn hoặc đa giác và kiểm tra xem toạ độ có nằm trong các đường ranh giới đó hay không (xem phần Khoanh vùng địa lý và ranh giới vùng an toàn), hãy sử dụng hình tròn (tham chiếu
Circle), hình đa giác (tham chiếuPolygon) và Thư viện hình học (containsLocation()để chứa vàcomputeDistanceBetween()cho khoảng cách tính bằng mét).
API cũ và các API thay thế
DirectionsServicevàDistanceMatrixServicesẽ ngừng hoạt động kể từ ngày 25 tháng 2 năm 2026. Thay vào đó, hãy sử dụngRoutevàRouteMatrix.google.maps.Markersẽ ngừng hoạt động kể từ ngày 21 tháng 2 năm 2024. Thay vào đó, hãy sử dụngAdvancedMarkerElement.PlacesServicekhông còn dành cho khách hàng mới kể từ ngày 1 tháng 3 năm 2025. Thay vào đó, hãy sử dụng lớpPlace.
Bước tiếp theo
- Thêm điểm đánh dấu vào bản đồ
- Thêm hình dạng, đường kẻ và khoanh vùng địa lý vào bản đồ
- Sử dụng Thư viện địa điểm để lấy dữ liệu vị trí
- Tính toán và hiển thị tuyến đường cũng như ma trận tuyến đường
- Tuỳ chỉnh kiểu và màu sắc của bản đồ
- Thêm các lớp dữ liệu tương tác
- Hiển thị ranh giới hành chính
- Thêm lớp phủ đồ hoạ WebGL
Xem mã ví dụ cho các tính năng của Maps