Bạn có thể tự động tạo khung cho điểm đánh dấu, hình nhiều đường, đa giác và tuyến đường 3D trong khung nhìn <gmp-map-3d> bằng cách đặt thuộc tính HTML autofits-camera hoặc thuộc tính autofitsCamera trên các phần tử con được hỗ trợ. Khi một hoặc nhiều phần tử con chọn sử dụng, bản đồ sẽ tính toán vị trí camera để giữ tất cả các phần tử đã chọn sử dụng trong chế độ xem.
Tính năng tự động điều chỉnh camera có trong kênh v=beta của Maps JavaScript API. Để biết hướng dẫn về cách tải kênh thử nghiệm beta, hãy xem phần Tạo phiên bản.
Phần tử được hỗ trợ
Bảng sau đây liệt kê các phần tử con của Map3DElement hỗ trợ autofits-camera (autofitsCamera):
| phần tử HTML | Lớp JavaScript | Thư viện | Ghi chú |
|---|---|---|---|
<gmp-marker-3d>, <gmp-marker-3d-interactive> |
Marker3DElement,
Marker3DInteractiveElement
|
maps3d |
Đóng khung position của điểm đánh dấu. |
<gmp-marker>, <gmp-marker-interactive> |
MarkerElement,
MarkerInteractiveElement
|
maps3d |
Đóng khung position của điểm đánh dấu. |
<gmp-polyline-3d>, <gmp-polyline-3d-interactive> |
Polyline3DElement,
Polyline3DInteractiveElement
|
maps3d |
Đóng khung tất cả toạ độ trong path của hình nhiều đường. |
<gmp-polygon-3d>, <gmp-polygon-3d-interactive> |
Polygon3DElement,
Polygon3DInteractiveElement
|
maps3d |
Đóng khung tất cả toạ độ trong path của đa giác. |
<gmp-route-3d> |
Route3DElement
|
routes |
Chờ yêu cầu về tuyến đường được giải quyết, sau đó đóng khung đường dẫn tuyến đường. |
Phần tử không được hỗ trợ
Model3DElement,
PopoverElement
và
FlattenerElement
không hỗ trợ autofitsCamera. Để đóng khung các phần tử đó, hãy đặt center và range trên <gmp-map-3d> hoặc gọi flyCameraTo.
Điều chỉnh camera cho vừa với khung hình khi tải ban đầu
Để đóng khung các phần tử khi bản đồ tải, hãy thêm thuộc tính autofits-camera vào từng phần tử con mà bạn muốn đưa vào khung nhìn ban đầu. Bạn không cần phải
tính center hoặc range trên <gmp-map-3d>:
<gmp-map-3d
style="height: 400px; width: 100%;"
mode="hybrid">
<gmp-marker-3d
position="47.6205,-122.3493"
title="Space Needle"
autofits-camera>
</gmp-marker-3d>
<gmp-marker-3d
position="47.6097,-122.3425"
title="Pike Place Market"
autofits-camera>
</gmp-marker-3d>
<gmp-polyline-3d
path="47.6205,-122.3493,0 47.6097,-122.3425,0"
stroke-color="#4285F4"
stroke-width="8"
altitude-mode="clamp-to-ground"
autofits-camera>
</gmp-polyline-3d>
</gmp-map-3d>
<script async
src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&v=beta&libraries=maps3d">
</script>
Thay thế YOUR_API_KEY bằng khoá API Google Maps Platform của bạn.
Điều chỉnh và tạo ảnh động cho nội dung cập nhật động
Khi bạn thêm một phần tử đã chọn tham gia sau lần tải ban đầu, hãy cập nhật toạ độ hoặc điểm cuối của tuyến đường, hoặc đặt autofitsCamera thành true, bản đồ sẽ tính toán lại camera để đóng khung tất cả các phần tử đã chọn tham gia. Việc xoá một phần tử hoặc đặt autofitsCamera thành false sẽ giữ nguyên camera ở vị trí của nó và loại trừ phần tử đó khỏi các bản cập nhật trong tương lai.
Để kiểm soát việc cập nhật động có chụp nhanh hay tạo ảnh động hay không, hãy đặt autofitsCameraAnimation (autofits-camera-animation) trên Map3DElement thành giá trị AutofitsCameraAnimation:
AutofitsCameraAnimation.NONE("none", mặc định): Chuyển nhanh đến vị trí đã cập nhật mà không có ảnh động.AutofitsCameraAnimation.FLY_TO("fly-to"): Di chuyển mượt mà đến vị trí mới. Lần tải bản đồ đầu tiên sẽ chuyển nhanh mà không có ảnh động vàFLY_TOsẽ quay lại chế độ chuyển nhanh khi hệ điều hành của người dùng yêu cầu giảm chuyển động.
Để định cấu hình autofitsCamera và AutofitsCameraAnimation.FLY_TO theo phương thức lập trình, hãy xem ví dụ sau:
<div id="map-container" style="height: 400px; width: 100%;"></div>
<script>
async function initMap() {
const {
AutofitsCameraAnimation,
Map3DElement,
Marker3DElement,
MapMode,
} = await google.maps.importLibrary('maps3d');
const map = new Map3DElement({
mode: MapMode.HYBRID,
autofitsCameraAnimation: AutofitsCameraAnimation.FLY_TO,
});
document.getElementById('map-container').append(map);
const originMarker = new Marker3DElement({
position: { lat: 37.7955, lng: -122.3937 },
autofitsCamera: true,
});
map.append(originMarker);
/* Adding a second opted-in marker flies the camera to frame both. */
const destinationMarker = new Marker3DElement({
position: { lat: 37.8080, lng: -122.4177 },
autofitsCamera: true,
});
map.append(destinationMarker);
}
</script>
<script async
src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&v=beta&loading=async&callback=initMap">
</script>
Thay thế YOUR_API_KEY bằng khoá API Google Maps Platform của bạn.
Cách các thuộc tính và quy định hạn chế của máy ảnh tương tác với nhau
Khi có ít nhất một phần tử con chọn sử dụng autofits-camera, Map3DElement sẽ kết hợp cấu hình bản đồ của bạn với các ranh giới được tính toán theo các quy tắc sau:
centervàrange: Bị ghi đè bằng khung được tính toán, giúp thêm khoảng đệm phạm vi 20% và thực thi phạm vi tối thiểu là 80 m. Nếu không có phần tử con nào chọn tham gia cung cấp toạ độ, thì bản đồ sẽ sử dụngcentervàrangeđã định cấu hình làm phương án dự phòng.tiltvàheading: Được coi là giá trị đề xuất trong quá trình đóng khung. Khi bị bỏ qua, cả hai đều mặc định là0°cho chế độ xem từ trên xuống, hướng bắc lên trên.rollvàfov: Được giữ nguyên theo cấu hình trênMap3DElement.- Phần tử con không đồng bộ: Trước khi hiển thị khung hiển thị ban đầu,
Map3DElementsẽ đợi các phần tử con không đồng bộ đã chọn tham gia (chẳng hạn như<gmp-route-3d>) hoàn tất việc tải hình học tuyến đường. - Các quy định hạn chế về bản đồ và camera: Các giới hạn về địa lý
boundsvà camera (minAltitude,maxAltitude,minTilt,maxTilt,minHeadingvàmaxHeading) vẫn ràng buộc chế độ xem tự động điều chỉnh. Để biết thêm thông tin, hãy xem phần Giới hạn chế độ xem và ranh giới của camera.
Các bước tiếp theo
- Hiển thị tuyến đường trên bản đồ 3D
- Điều khiển vị trí của camera
- Tạo ảnh động cho đường đi của camera