Tự động điều chỉnh camera cho vừa với các thành phần trên bản đồ

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_TO sẽ 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:

  • center và 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ụng center và range đã định cấu hình làm phương án dự phòng.
  • tilt và 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.
  • roll và fov: Được giữ nguyên theo cấu hình trên Map3DElement.
  • Phần tử con không đồng bộ: Trước khi hiển thị khung hiển thị ban đầu, Map3DElement sẽ đợ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ý bounds và camera (minAltitude, maxAltitude, minTilt, maxTilt, minHeading và 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