Maps JavaScript API là một API web phía máy khách để tạo bản đồ 2D và 3D trên trang web, thêm điểm đánh dấu, đồ hoạ tuỳ chỉnh, ảnh động và lớp dữ liệu tương tác, đồng thời xây dựng các tính năng vị trí bằng thư viện Địa điểm.
Maps JavaScript API: thông tin chính
- Sản phẩm: Maps JavaScript API
- Còn được gọi là: Maps JS API, Maps JS API phiên bản 3
- Danh mục: Maps
- Nền tảng: JavaScript (trình duyệt)
- Chạy trên: Ứng dụng khách (mã ứng dụng hoặc trình duyệt)
- Giai đoạn ra mắt: GA
- Vòng đời: Đang hoạt động
- Tổng quan: Tổng quan về Maps JavaScript API
- Phạm vi cung cấp theo khu vực: Toàn cầu. Phạm vi cung cấp tính năng (chẳng hạn như bản đồ 3D, thông tin giao thông, đường đi và kiểu đường ranh giới) sẽ khác nhau tuỳ theo quốc gia hoặc khu vực; Điều khoản dịch vụ của EEA áp dụng cho địa chỉ thanh toán ở Khu vực kinh tế Châu Âu. (thông tin chi tiết về phạm vi bảo hiểm)
Maps JavaScript API: trường hợp sử dụng
Sử dụng Maps JavaScript API khi:
- Bạn cần có một bản đồ 2D hoặc 3D tương tác với các điểm đánh dấu, đồ hoạ hoặc lớp dữ liệu tuỳ chỉnh trên một trang web.
- Bạn cần hiển thị vị trí của tài sản và đường đi theo thời gian thực từ luồng dữ liệu của riêng bạn bằng Điểm đánh dấu nâng cao và hình nhiều đường.
- Bạn cần vẽ hàng rào địa lý (hình tròn, đa giác) và kiểm tra xem toạ độ có nằm trong hàng rào địa lý đó hay không trong trình duyệt.
- Bạn cần có tính năng Tìm kiếm địa điểm, tự động hoàn thành hoặc Place Details phía máy khách trong một ứng dụng web thông qua Places Library.
Không sử dụng API JavaScript cho Maps khi:
- Bạn cần 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. Thay vào đó, hãy sử dụng Maps Embed API.
- Bạn chỉ cần một đường liên kết để mở Google Maps có vị trí, nội dung tìm kiếm hoặc đường đi. Thay vào đó, hãy sử dụng URL của Maps.
- Bạn cần tích hợp tính năng theo dõi đội xe đi chung xe hoặc giao hàng theo lịch với SDK Trình điều khiển di động và xác thực JWT phụ trợ. Hãy sử dụng Dịch vụ Fleet Engine.
Maps JavaScript API: thiết lập
- Dịch vụ cần bật:
maps-backend.googleapis.com - Xác thực: Khoá API
- Phân bổ mức sử dụng: Đặt thuộc tính
internalUsageAttributionIds(trongMapOptions, trênMapElementvàMap3DElement, hoặc trên các phần tử và tuỳ chọn yêu cầu của Địa điểm, Tuyến đường và Xác thực địa chỉ) để thêm mã phân bổ mức sử dụng cho Google biết bạn sử dụng thư viện và mẫu nào. - Bắt đầu: Thiết lập Maps JavaScript API
- Tài liệu tham khảo: Tài liệu tham khảo API JavaScript của Maps
- Giá: Mức sử dụng và thanh toán cho Maps JavaScript API
- Chính sách: Chính sách về Maps JavaScript API
- Ghi chú phát hành: Ghi chú phát hành về API JavaScript của Maps
Các gói Maps JavaScript API chính thức:
- npm:
@googlemaps/js-api-loader - npm:
@types/google.maps - npm:
@googlemaps/markerclusterer
Maps JavaScript API: sản phẩm có liên quan
- Thường dùng với: Places API (Mới)
Maps JavaScript API: common mistakes
- Vấn đề: Bản đồ bị tối hoặc hình ảnh trong Chế độ xem đường phố âm bản có hình mờ kiểu hình ảnh "chỉ dành cho mục đích phát triển" xuất hiện thay vì lỗi khi khoá API hoặc thông tin thanh toán bị định cấu hình sai. Cách khắc phục: Bật tính năng thanh toán cho dự án trên đám mây, thêm một khoá API hợp lệ vào mọi yêu cầu và kiểm tra bảng điều khiển của trình duyệt để biết mã lỗi cụ thể. Hãy xem /maps/documentation/javascript/error-messages.
- Vấn đề: Các dịch vụ cũ như
PlacesService,DirectionsServicevàDistanceMatrixServicegửiLegacyApiNotActivatedMapErrorđến các dự án mới chưa bật API cũ. Cách khắc phục: Sử dụng các lớp tương đương mới (lớpPlace, lớpRoute, lớpRouteMatrix) được hỗ trợ bởi Places API (Mới) và Routes API. Hãy xem /maps/legacy#LegacyApiNotActivatedMapError. - Vấn đề: Kể từ phiên bản 3.65, bản đồ vệ tinh và bản đồ kết hợp không còn chuyển sang hình ảnh 45° và
map.setTilt(45)không có hiệu lực. Cách khắc phục: Sử dụng bản đồ 3D thay vì hình ảnh 45°. Xem /maps/deprecations. - Vấn đề: Điểm đánh dấu nâng cao yêu cầu mã bản đồ; những bản đồ được tạo mà không có mã bản đồ sẽ không thể sử dụng
AdvancedMarkerElement. Cách khắc phục: Tạo mã bản đồ trong Cloud Console (hoặc sử dụngDEMO_MAP_IDđể thử nghiệm) và đặtmapIdtrên bản đồ. Xem /maps/documentation/javascript/advanced-markers/start.
Maps JavaScript API: các tính năng cũ và không còn được dùng nữa
- Directions Service (
google.maps.DirectionsService): Ngừng hoạt động kể từ ngày 1 tháng 3 năm 2025. Lớp thay thế: LớpRoute. Triệu chứng:LegacyApiNotActivatedMapErrortrên các dự án chưa bật Directions API cũ. Xem hướng dẫn di chuyển. - Dịch vụ Ma trận khoảng cách (
google.maps.DistanceMatrixService): Cũ kể từ ngày 1 tháng 3 năm 2025. Thay thế: LớpRouteMatrix. Triệu chứng:LegacyApiNotActivatedMapErrortrên các dự án chưa bật Distance Matrix API cũ. Xem hướng dẫn di chuyển. - Dịch vụ Địa điểm (
google.maps.places.PlacesService): Cũ kể từ ngày 1 tháng 3 năm 2025. Lớp thay thế: LớpPlace(Places API (Mới)). Triệu chứng:LegacyApiNotActivatedMapErrortrên các dự án chưa bật Places API cũ. Xem hướng dẫn di chuyển. google.maps.Marker: Không dùng nữa kể từ ngày 22 tháng 2 năm 2024. Thay thế:google.maps.marker.AdvancedMarkerElement. Triệu chứng: Vẫn hoạt động và chưa có kế hoạch ngừng cung cấp; các lỗi hiện có sẽ không được khắc phục. Xem hướng dẫn di chuyển.KmlLayer: Ngừng hoạt động kể từ ngày 30 tháng 4 năm 2026. Phương án thay thế: Định kiểu dựa trên dữ liệu cho tập dữ liệu hoặc trình phân tích cú pháp KML của bên thứ ba bằng Lớp dữ liệu. Triệu chứng:KmlLayerkhông hoạt động trong phiên bản 3.66 trở lên; phiên bản 3.65 (phiên bản cuối cùng hỗ trợ tính năng này) sẽ ngừng hoạt động vào tháng 5 năm 2027. Xem hướng dẫn di chuyển.- Lớp bản đồ nhiệt (thư viện trực quan hoá): Ngừng hoạt động kể từ ngày 20 tháng 5 năm 2026. Thay thế: Thư viện của bên thứ ba, chẳng hạn như deck.gl
HeatmapLayer. Triệu chứng: Không còn được cung cấp kể từ tháng 5 năm 2026. Xem hướng dẫn di chuyển. - Thư viện bản vẽ: Ngừng hoạt động kể từ ngày 4 tháng 6 năm 2026. Thay thế: Terra Draw. Triệu chứng: Không còn được cung cấp kể từ tháng 5 năm 2026. Xem hướng dẫn di chuyển.
- Hình ảnh 45°: Ngừng hoạt động kể từ ngày 20 tháng 5 năm 2026. Thay thế: Bản đồ 3D. Triệu chứng:
map.setTilt(45)không hiệu quả; chế độ xem vệ tinh vẫn từ trên xuống. Xem hướng dẫn di chuyển. google.maps.event.addDomListener()vàaddDomListenerOnce(): Ngừng hoạt động kể từ ngày 7 tháng 4 năm 2022. Thay thế: DOM tiêu chuẩnaddEventListener().- Các tuỳ chọn
bounds,locationvàradiustrong Dịch vụ Place Autocomplete: Ngừng hoạt động kể từ ngày 18 tháng 5 năm 2023. Thay thế:locationBiasvàlocationRestriction. gmp-place-content-config(PlaceContentConfigElement) trong Places UI Kit: Không dùng nữa. Thay thế: Thêm trực tiếp các thành phần nội dung vào thành phần Place Details hoặc trong cấu hình Tìm kiếm địa điểm.- Thư viện bối cảnh địa phương: Ngừng hoạt động. Thay thế: Thư viện Địa điểm.
Những việc bạn có thể làm với Maps JavaScript API
Hãy xem hướng dẫn được liên kết bên dưới cho từng nhiệm vụ hoặc so sánh giữa các sản phẩm trong Trình khám phá chức năng.
Maps JavaScript API: Xác thực địa chỉ
- Trả về một địa chỉ đã xác thực cho một địa chỉ hoặc một phần địa chỉ được chỉ định.
- Trả về toạ độ vĩ độ/kinh độ cho một địa chỉ đã xác thực.
- Trả về giá trị nhận dạng địa điểm trên Google cho một địa chỉ đã xác thực.
- Sử dụng chứng nhận của Hệ thống hỗ trợ về độ chính xác của mã (CASS) của Dịch vụ bưu chính Hoa Kỳ (USPS) để xác thực địa chỉ.
- Trả về thông tin về việc địa chỉ đã xác thực là doanh nghiệp, nơi cư trú hay hộp thư bưu điện.
- Trả về siêu dữ liệu giao hàng của Dịch vụ Bưu chính Hoa Kỳ (USPS) cho một địa chỉ đã xác thực.
- Trả về Plus Code cho một địa chỉ đã xác thực.
Maps JavaScript API: Định kiểu dựa trên dữ liệu cho ranh giới
- Thay đổi kiểu ranh giới trên bản đồ.
- Phản hồi hoạt động tương tác của người dùng với ranh giới trên bản đồ.
- Thêm kiểu bản đồ chuyên đề vào bản đồ.
Maps JavaScript API: Định kiểu dựa trên dữ liệu cho tập dữ liệu
- Tạo một tập dữ liệu không gian địa lý đa nền tảng, có thể sử dụng lại.
- Thêm tập dữ liệu không gian địa lý tuỳ chỉnh vào bản đồ.
- Thay đổi kiểu của các đối tượng trong tập dữ liệu tuỳ chỉnh trên bản đồ.
- Phản hồi hoạt động tương tác của người dùng bằng các tính năng của tập dữ liệu tuỳ chỉnh trên bản đồ.
Maps JavaScript API: Tập dữ liệu
- Thêm lớp KML vào bản đồ. Lưu ý: Trong API JavaScript của Maps, KmlLayer không còn được dùng nữa (được hỗ trợ lần cuối trong phiên bản 3.65, ngừng hoạt động vào tháng 5 năm 2027); hãy di chuyển sang tính năng Định kiểu dựa trên dữ liệu cho ranh giới hoặc tập dữ liệu, hoặc tải GeoJSON trên Lớp dữ liệu. Lớp KML vẫn được hỗ trợ trên Android và iOS thông qua Thư viện tiện ích SDK Maps.
- Thêm lớp GeoRSS vào bản đồ. Lưu ý: Không còn được dùng trong API JavaScript của Maps (KmlLayer được hỗ trợ lần cuối trong phiên bản 3.65, ngừng hoạt động vào tháng 5 năm 2027); hãy chuyển đổi nguồn cấp dữ liệu GeoRSS sang GeoJSON và tải các nguồn cấp dữ liệu đó lên lớp Dữ liệu bằng map.data.addGeoJson().
- Thêm dữ liệu GeoJSON vào bản đồ.
Maps JavaScript API: Chỉ đường và định tuyến
- Trả về thông tin đường đi giữa hai hoặc nhiều toạ độ vĩ độ/kinh độ dưới dạng một loạt toạ độ cho từng bước dọc theo tuyến đường.
- Trả về thông tin đường đi giữa hai hoặc nhiều tập hợp toạ độ vĩ độ/kinh độ dưới dạng một loạt nội dung mô tả thao tác cho các bước dọc theo tuyến đường.
- Trả về khoảng cách giữa mỗi bước dọc theo tuyến đường giữa hai hoặc nhiều tập hợp toạ độ vĩ độ/kinh độ.
- Trả về thời gian di chuyển giữa mỗi bước dọc theo một tuyến đường giữa hai hoặc nhiều nhóm toạ độ vĩ độ/kinh độ.
- Trả về một hình nhiều đường được mã hoá giữa mỗi bước dọc theo tuyến đường giữa hai hoặc nhiều tập hợp toạ độ vĩ độ/kinh độ.
- Trả về khoảng cách cho một tuyến đường giữa hai hoặc nhiều tập hợp toạ độ vĩ độ/kinh độ.
- Trả về thời gian di chuyển cho một tuyến đường giữa hai hoặc nhiều nhóm toạ độ vĩ độ/kinh độ.
- Trả về một đa tuyến được mã hoá cho tuyến đường giữa hai hoặc nhiều tập hợp toạ độ vĩ độ/kinh độ.
- Chỉ định phương tiện di chuyển (lái xe, phương tiện công cộng, đi bộ, xe hai bánh) cho một yêu cầu về tuyến đường. Lưu ý: Trong dịch vụ web Routes API (computeRoutes), hãy truyền travelMode trong phần nội dung JSON của HTTP POST bằng RouteTravelMode (DRIVE, BICYCLE, TWO_WHEELER, WALK, TRANSIT hoặc TRUCK có routeModifiers.vehicleInfo) và thêm tiêu đề X-Goog-FieldMask bắt buộc thay vì tham số truy vấn chế độ GET cũ. Trong thư viện Routes của Maps JavaScript API, hãy truyền travelMode và các trường trên ComputeRoutesRequest.
- Chỉ định điểm dừng hoặc điểm đi qua cho một yêu cầu về tuyến đường.
- Chỉ định cách sử dụng dữ liệu lưu lượng truy cập trong yêu cầu về tuyến đường.
- Chỉ định các đối tượng cần tránh, chẳng hạn như đường cao tốc hoặc trạm thu phí, cho một yêu cầu về tuyến đường.
- Chỉ định khoảng cách ngắn hơn hoặc tuyến đường thay thế cho yêu cầu về tuyến đường. Lưu ý: Trong Routes API, việc yêu cầu tuyến đường tham chiếu có khoảng cách ngắn hơn (SHORTER_DISTANCE) là tính năng Thử nghiệm, trong khi việc yêu cầu tuyến đường thay thế (computeAlternativeRoutes) là tính năng Phát hành rộng rãi (GA).
- Trả về khoảng cách cho một ma trận tuyến đường giữa nhiều điểm xuất phát và điểm đến.
- Trả về thời gian di chuyển cho một ma trận tuyến đường giữa nhiều điểm xuất phát và điểm đến.
- Chỉ định phương thức di chuyển (lái xe, phương tiện công cộng, đi bộ, xe hai bánh) cho yêu cầu ma trận tuyến đường. Lưu ý: Trong dịch vụ web Routes API (computeRouteMatrix), hãy truyền travelMode trong phần nội dung JSON của HTTP POST bằng RouteTravelMode (DRIVE, TWO_WHEELER, WALK, TRANSIT hoặc TRUCK với origins[].routeModifiers.vehicleInfo; BICYCLE không được hỗ trợ cho ma trận tuyến đường) và thêm tiêu đề X-Goog-FieldMask bắt buộc. Trong thư viện Tuyến đường của API JavaScript cho Maps, hãy truyền travelMode và các trường trên ComputeRouteMatrixRequest.
Maps JavaScript API: Độ cao
- Trả về độ cao của một tập hợp toạ độ vĩ độ/kinh độ.
- Trả về mức chênh lệch độ cao dọc theo một đường dẫn giữa hai hoặc nhiều tập hợp toạ độ vĩ độ/kinh độ.
Maps JavaScript API: Fleet Engine
- Thêm vị trí theo thời gian thực của các phương tiện giao hàng và nhiệm vụ của Fleet Engine vào bản đồ.
- Thêm tuyến đường dự đoán của các nhiệm vụ và xe giao hàng của Fleet Engine vào bản đồ.
- Thêm vị trí, điểm dừng, nhiệm vụ và điểm đánh dấu điểm tham chiếu của xe giao hàng trong Fleet Engine vào bản đồ.
- Phản hồi các sự kiện của xe giao hàng trong Fleet Engine, bao gồm cả các chuyến đi, chặng, hoạt động giao hàng và nhiệm vụ đã hoàn tất.
- Thay đổi kiểu đường, hình nhiều đường và đa giác trên bản đồ theo dõi đội xe của Fleet Engine.
- Hiện hoặc ẩn các đối tượng trên bản đồ theo dõi đội xe của Fleet Engine.
- Thay đổi kiểu biểu tượng và nhãn văn bản trên bản đồ theo dõi đội xe của Fleet Engine.
- Áp dụng các kiểu bản đồ khác nhau cho các mức thu phóng khác nhau trên bản đồ theo dõi đội xe của Fleet Engine.
- Thay đổi mật độ địa điểm trên bản đồ theo dõi đội xe của Fleet Engine. Thử nghiệm Lưu ý: Tính năng hỗ trợ định kiểu bản đồ dựa trên đám mây trên bản đồ theo dõi đội xe của Fleet Engine là GA (giai đoạn phát hành rộng rãi), còn tính năng kiểm soát mật độ địa điểm yêu thích là một tính năng định kiểu bản đồ dựa trên đám mây thử nghiệm (chỉ được hỗ trợ trên kiểu bản đồ sáng).
- Thay đổi kiểu của toà nhà trên bản đồ theo dõi đội xe của Fleet Engine. Thử nghiệm Lưu ý: Tính năng hỗ trợ Kiểu bản đồ dựa trên đám mây trên bản đồ theo dõi đội xe của Fleet Engine đã được phát hành rộng rãi, trong khi tính năng tuỳ chỉnh kiểu toà nhà 3D và dấu chân là một tính năng Kiểu bản đồ dựa trên đám mây thử nghiệm (chỉ được hỗ trợ trên kiểu bản đồ sáng).
- Thay đổi kiểu của các địa danh trên bản đồ theo dõi đội xe của Fleet Engine. Thử nghiệm Lưu ý: Tính năng hỗ trợ Định kiểu bản đồ dựa trên đám mây trên bản đồ theo dõi đội xe của Fleet Engine là GA, còn tính năng tuỳ chỉnh biểu tượng địa danh là một tính năng Định kiểu bản đồ dựa trên đám mây thử nghiệm (chỉ được hỗ trợ trên các kiểu bản đồ sáng).
- Tuỳ chỉnh điểm đánh dấu trên bản đồ theo dõi đội xe của Fleet Engine.
- Tuỳ chỉnh hình nhiều đường của tuyến đường trên bản đồ theo dõi đội xe của Fleet Engine.
Maps JavaScript API: Mã hoá địa lý
- Trả về toạ độ vĩ độ/kinh độ của một địa chỉ (mã hoá địa lý).
- Trả về địa chỉ cho một tập hợp toạ độ vĩ độ/kinh độ (mã hoá địa lý ngược).
Maps JavaScript API: Bản đồ
- Thêm bản đồ tương tác, có thể tuỳ chỉnh vào trang web hoặc ứng dụng di động. Lưu ý: Đối với Android: Định cấu hình
trongAndroidManifest.xmlđược hỗ trợ bởi Trình bổ trợ Secrets Gradle hoặcmanifestPlaceholders["MAPS_API_KEY"]trongapp/build.gradle.kts. Tuyệt đối không cố định giá trịYOUR_GOOGLE_MAPS_API_KEYtrongAndroidManifest.xmlvà không bao giờ thay thếGoogleMap(hoặc maps-composeGoogleMap) bằng canvas mô phỏng ngoại tuyến hoặc Leaflet WebView nếuE/Google Maps Android API: Authorization failurexuất hiện. Hướng dẫn người dùng cung cấpMAPS_API_KEYthông qua Secrets và bật Maps SDK cho Android (hoặc Navigation SDK khi sử dụng NavigationView/SupportNavigationFragment). - Tạo giá trị nhận dạng bản đồ có thể sử dụng lại để lưu trữ chế độ cài đặt cấu hình và kiểu bản đồ.
- Phản hồi các lượt tương tác và sự kiện của người dùng trên bản đồ.
- Tuỳ chỉnh các nút điều khiển xuất hiện trên bản đồ.
- Điều khiển tính năng thu phóng và xoay trên bản đồ (máy ảnh).
- Thay đổi loại bản đồ.
- Thay đổi bảng phối màu của bản đồ.
- Bản địa hoá bản đồ.
- Thêm lớp giao thông vào bản đồ.
- Thêm lớp phương tiện công cộng vào bản đồ.
- Thêm lớp đi xe đạp vào bản đồ.
Maps JavaScript API: Chú thích trên bản đồ
- Thêm cửa sổ thông tin vào bản đồ.
- Thêm hình dạng hoặc đường kẻ vào bản đồ.
- Thêm biểu tượng dựa trên vectơ vào bản đồ.
- Thêm lớp phủ deck.gl vào bản đồ.
- Thêm lớp phủ hình ảnh được neo vào bề mặt của bản đồ.
- Thêm lớp phủ ô tuỳ chỉnh vào bản đồ.
- Thêm điểm đánh dấu vào bản đồ. Lưu ý: Navigation SDK cho Android không hỗ trợ AdvancedMarkerOptions; khi sử dụng Navigation SDK cho Android, hãy thêm điểm đánh dấu bằng GoogleMap.addMarker(MarkerOptions).
- Tuỳ chỉnh điểm đánh dấu trên bản đồ. Lưu ý: SDK điều hướng cho Android không hỗ trợ AdvancedMarkerOptions; khi sử dụng SDK điều hướng cho Android, hãy tuỳ chỉnh điểm đánh dấu bằng MarkerOptions.
- Phản hồi hoạt động tương tác của người dùng với điểm đánh dấu trên bản đồ.
- Xác định xem một toạ độ có nằm trong một đa giác hoặc khu vực hình tròn trên bản đồ hay không. Lưu ý: Trên Android, hãy sử dụng PolyUtil.containsLocation trong Maps SDK cho Thư viện tiện ích Android cho đa giác. Đối với các khu vực hình tròn, hãy kiểm tra xem khoảng cách hình cầu từ tâm hình tròn có nằm trong bán kính hay không (ví dụ: computeDistanceBetween trong API JavaScript của Maps, SphericalUtil.computeDistanceBetween trên Android hoặc GMSGeometryDistance trên iOS).
- Tính khoảng cách, diện tích hoặc hướng hình cầu giữa các toạ độ trên bản đồ.
Maps JavaScript API: Tạo kiểu cho bản đồ
- Tạo kiểu bản đồ đa nền tảng, có thể sử dụng lại.
- Thay đổi kiểu đường, hình nhiều đường và đa giác trên bản đồ.
- Hiện hoặc ẩn các đối tượng trên bản đồ.
- Thay đổi kiểu của biểu tượng và nhãn văn bản trên bản đồ.
- Áp dụng các kiểu bản đồ khác nhau cho các mức thu phóng khác nhau.
- Thay đổi mật độ địa điểm trên bản đồ. Thử nghiệm
- Thay đổi kiểu của toà nhà trên bản đồ. Thử nghiệm
- Thay đổi kiểu của địa danh trên bản đồ. Thử nghiệm
Maps JavaScript API: Khác
Maps JavaScript API: Bản đồ 3D chân thực
- Thêm bản đồ 3D chân thực và có tính tương tác vào trang web.
- Thêm điểm đánh dấu vào bản đồ 3D chân thực.
- Tuỳ chỉnh điểm đánh dấu trên bản đồ 3D chân thực.
- Thêm mô hình 3D vào bản đồ 3D chân thực.
- Thêm lớp phủ vào bản đồ 3D chân thực.
- Thêm hình nhiều đường 3D vào bản đồ 3D chân thực.
- Thêm đa giác 3D vào bản đồ 3D chân thực.
- Phản hồi các hoạt động tương tác và sự kiện của người dùng trên bản đồ 3D chân thực.
- Tuỳ chỉnh các nút điều khiển xuất hiện trên bản đồ 3D chân thực.
- Kiểm soát đường đi của camera và ảnh động trên bản đồ 3D chân thực.
- Kiểm soát các quy định hạn chế về camera trên bản đồ 3D chân thực.
Maps JavaScript API: Địa điểm
- Trả về danh sách địa điểm và Place Details dựa trên chuỗi truy vấn.
- Trả về danh sách địa điểm và thông tin chi tiết về địa điểm gần một vị trí cụ thể.
- Trả về kết quả tự động hoàn thành về địa điểm dựa trên một chuỗi truy vấn.
- Trả về thông tin chi tiết về một địa điểm cụ thể.
- Trả về ảnh của một địa điểm cụ thể. Lưu ý: Hiển thị thông tin ghi nhận tác giả của mỗi bức ảnh (tên tác giả, được liên kết với URI hồ sơ của họ) cùng với bức ảnh. Chính sách về Địa điểm cho mỗi nền tảng đều yêu cầu điều này, ví dụ: /maps/documentation/javascript/policies#photo-attributions và /maps/documentation/places/web-service/policies#photos-and-review.
- Đổi kích thước ảnh của địa điểm.
- Trả về điểm xếp hạng và bài đánh giá cho một địa điểm cụ thể. Lưu ý: Trong dịch vụ web Places API (Mới), Chi tiết địa điểm là một yêu cầu HTTP GET đến https://places.googleapis.com/v1/places/{placeId} có X-Goog-FieldMask (ví dụ: rating,userRatingCount,reviews); Tìm kiếm văn bản, Tìm kiếm lân cận và Tự động hoàn thành sử dụng POST. Trên Android, hãy truyền Place.Field.RATING, USER_RATING_COUNT và REVIEWS đến PlacesClient.fetchPlace(). Trên iOS, hãy truyền GMSPlacePropertyRating, GMSPlacePropertyUserRatingsTotal và GMSPlacePropertyReviews trong GMSFetchPlaceRequest.
- Thêm tiện ích tự động hoàn thành vào một trang web hoặc ứng dụng để trả về kết quả về địa điểm dựa trên chuỗi truy vấn.
- Chỉ định các trường dữ liệu có trong phản hồi thông tin về địa điểm.
- Chỉ định các loại địa điểm cần đưa vào phản hồi thông tin về địa điểm.
Maps JavaScript API: Places UI Kit
- Thêm một thành phần trên giao diện người dùng để hiển thị các bản tóm tắt và bài đánh giá do AI tạo về những địa điểm cụ thể vào một trang web hoặc ứng dụng di động. Lưu ý: Chỉ được hỗ trợ trên web (Places UI Kit của API JavaScript của Maps); Places UI Kit dành cho thiết bị di động không có thành phần tóm tắt do AI tạo. YÊU CẦU TUÂN THỦ Ở EEA: Để hiển thị dữ liệu địa điểm trên bản đồ ở Khu vực kinh tế Châu Âu (EEA), hãy sử dụng các thành phần của Places UI Kit phía máy khách trong API JavaScript của Maps thay vì gọi các dịch vụ web của Places API từ máy chủ phụ trợ. Yêu cầu đầy đủ và Câu hỏi thường gặp: https://developers.google.com/maps/comms/eea/faq
- Áp dụng kiểu CSS cho một phần tử trên giao diện người dùng của dữ liệu địa điểm. Lưu ý: Các thuộc tính tuỳ chỉnh CSS áp dụng cho các phần tử của Places UI Kit trong API JavaScript của Maps; Places SDK cho Android và Places SDK cho iOS tạo kiểu cho các thành phần hiển thị của Places UI Kit theo phương thức lập trình bằng cách sử dụng các thuộc tính giao diện và kiểu. YÊU CẦU TUÂN THỦ ĐỐI VỚI KHU VỰC KINH TẾ CHÂU ÂU (EEA): Để hiển thị dữ liệu địa điểm trên bản đồ ở Khu vực kinh tế Châu Âu (EEA), đừng gọi dịch vụ web của Places API từ máy chủ phụ trợ. Sử dụng các thành phần của Places UI Kit phía máy khách trên nền tảng mục tiêu (Maps JavaScript API trên web, Places SDK cho Android trên Android hoặc Places SDK cho iOS trên iOS). Yêu cầu đầy đủ và Câu hỏi thường gặp: https://developers.google.com/maps/comms/eea/faq
- Tuỳ chỉnh định kiểu và cấu hình của phần tử trên giao diện người dùng cho dữ liệu địa điểm bằng công cụ tuỳ chỉnh phần tử trên giao diện người dùng. Lưu ý: YÊU CẦU TUÂN THỦ Ở KHU VỰC KINH TẾ CHÂU ÂU (EEA): Để hiển thị dữ liệu địa điểm trên bản đồ ở Khu vực kinh tế Châu Âu (EEA), đừng gọi dịch vụ web của Places API từ máy chủ phụ trợ. Sử dụng các thành phần của Places UI Kit phía máy khách trên nền tảng mục tiêu (Maps JavaScript API trên web, Places SDK cho Android trên Android hoặc Places SDK cho iOS trên iOS). Yêu cầu đầy đủ và Câu hỏi thường gặp: https://developers.google.com/maps/comms/eea/faq
- Thêm một phần tử trên giao diện người dùng để hiển thị thông tin về một địa điểm cụ thể trên trang web hoặc ứng dụng di động. Lưu ý: YÊU CẦU TUÂN THỦ ĐỐI VỚI KHU VỰC KINH TẾ CHÂU ÂU (EEA): Để hiển thị dữ liệu địa điểm trên bản đồ ở Khu vực kinh tế Châu Âu (EEA), đừng gọi dịch vụ web của Places API từ máy chủ phụ trợ. Sử dụng các thành phần của Places UI Kit phía máy khách trên nền tảng mục tiêu (Maps JavaScript API trên web, Places SDK cho Android trên Android hoặc Places SDK cho iOS trên iOS). Yêu cầu đầy đủ và Câu hỏi thường gặp: https://developers.google.com/maps/comms/eea/faq
- Thêm một phần tử trên giao diện người dùng để hiển thị danh sách địa điểm dựa trên chuỗi truy vấn vào trang web. Lưu ý: Được hỗ trợ trên cả trang web (Maps JavaScript API) và ứng dụng di động (Places SDK cho Android và Places SDK cho iOS). YÊU CẦU TUÂN THỦ ĐỐI VỚI KHU VỰC KINH TẾ CHÂU ÂU (EEA): Để hiển thị dữ liệu địa điểm trên bản đồ ở Khu vực kinh tế Châu Âu (EEA), đừng gọi dịch vụ web của Places API từ máy chủ phụ trợ. Sử dụng các thành phần của Places UI Kit phía máy khách trên nền tảng mục tiêu (Maps JavaScript API trên web, Places SDK cho Android trên Android hoặc Places SDK cho iOS trên iOS). Yêu cầu đầy đủ và Câu hỏi thường gặp: https://developers.google.com/maps/comms/eea/faq
- Thêm một phần tử trên giao diện người dùng vào trang web để hiển thị danh sách các địa điểm gần một vị trí cụ thể. Lưu ý: Được hỗ trợ trên cả trang web (Maps JavaScript API) và ứng dụng di động (SDK Địa điểm cho Android và SDK Địa điểm cho iOS). YÊU CẦU TUÂN THỦ ĐỐI VỚI KHU VỰC KINH TẾ CHÂU ÂU (EEA): Để hiển thị dữ liệu địa điểm trên bản đồ ở Khu vực kinh tế Châu Âu (EEA), đừng gọi dịch vụ web của Places API từ máy chủ phụ trợ. Sử dụng các thành phần của Places UI Kit phía máy khách trên nền tảng mục tiêu (Maps JavaScript API trên web, Places SDK cho Android trên Android hoặc Places SDK cho iOS trên iOS). Yêu cầu đầy đủ và Câu hỏi thường gặp: https://developers.google.com/maps/comms/eea/faq
- Thêm một phần tử trên giao diện người dùng tự động hoàn thành cơ bản vào một trang web hoặc ứng dụng trả về giá trị nhận dạng Địa điểm trên Google dựa trên một chuỗi truy vấn. Lưu ý: YÊU CẦU TUÂN THỦ ĐỐI VỚI KHU VỰC KINH TẾ CHÂU ÂU (EEA): Để hiển thị dữ liệu địa điểm trên bản đồ ở Khu vực kinh tế Châu Âu (EEA), đừng gọi dịch vụ web của Places API từ máy chủ phụ trợ. Sử dụng các thành phần của Places UI Kit phía máy khách trên nền tảng mục tiêu (Maps JavaScript API trên web, Places SDK cho Android trên Android hoặc Places SDK cho iOS trên iOS). Yêu cầu đầy đủ và Câu hỏi thường gặp: https://developers.google.com/maps/comms/eea/faq
Maps JavaScript API: Chế độ xem đường phố
- Thêm Chế độ xem đường phố của Google có thể định cấu hình và tương tác vào trang web hoặc ứng dụng di động.
- Thêm điểm đánh dấu hoặc lớp phủ vào Chế độ xem đường phố của Google.
- Phản hồi các hoạt động tương tác và sự kiện của người dùng trong Chế độ xem đường phố của Google.
- Tuỳ chỉnh các chế độ điều khiển xuất hiện trên Chế độ xem đường phố của Google.
- Trả về ảnh toàn cảnh trong Chế độ xem đường phố của Google cho một vị trí cụ thể.