ปรับกล้องให้พอดีกับองค์ประกอบแผนที่โดยอัตโนมัติ

คุณสามารถจัดเฟรมเครื่องหมาย เส้นประกอบ รูปหลายเหลี่ยม และเส้นทาง 3 มิติภายในวิวพอร์ต <gmp-map-3d> ได้โดยอัตโนมัติด้วยการตั้งค่าแอตทริบิวต์ HTML autofits-camera หรือพร็อพเพอร์ตี้ autofitsCamera ในองค์ประกอบย่อยที่รองรับ เมื่อองค์ประกอบย่อยอย่างน้อย 1 รายการเลือกใช้ แผนที่จะคำนวณตำแหน่งกล้องที่ทำให้องค์ประกอบที่เลือกใช้ทั้งหมดอยู่ในมุมมอง

การปรับกล้องให้พอดีโดยอัตโนมัติพร้อมใช้งานในแชแนล v=beta ของ Maps JavaScript API ดูวิธีการโหลดเวอร์ชันเบต้าได้ที่การกำหนดเวอร์ชัน

องค์ประกอบที่รองรับ

ตารางต่อไปนี้แสดงองค์ประกอบย่อยของ Map3DElement ที่รองรับ autofits-camera (autofitsCamera)

องค์ประกอบ HTML คลาส JavaScript คลัง หมายเหตุ
<gmp-marker-3d>, <gmp-marker-3d-interactive> Marker3DElement, Marker3DInteractiveElement maps3d จัดเฟรม position ของเครื่องหมาย
<gmp-marker>, <gmp-marker-interactive> MarkerElement, MarkerInteractiveElement maps3d จัดเฟรม position ของเครื่องหมาย
<gmp-polyline-3d>, <gmp-polyline-3d-interactive> Polyline3DElement, Polyline3DInteractiveElement maps3d จัดเฟรมพิกัดทั้งหมดใน path ของเส้นประกอบ
<gmp-polygon-3d>, <gmp-polygon-3d-interactive> Polygon3DElement, Polygon3DInteractiveElement maps3d จัดเฟรมพิกัดทั้งหมดใน path ของรูปหลายเหลี่ยม
<gmp-route-3d> Route3DElement routes รอให้คำขอเส้นทางได้รับการแก้ไข จากนั้นจึงกำหนดเฟรมเส้นทาง

องค์ประกอบที่ไม่รองรับ

Model3DElement, PopoverElement และ FlattenerElement ไม่รองรับ autofitsCamera หากต้องการจัดเฟรมองค์ประกอบเหล่านั้น ให้ตั้งค่า center และ range ใน <gmp-map-3d> หรือเรียกใช้ flyCameraTo

ปรับกล้องให้พอดีเมื่อโหลดครั้งแรก

หากต้องการจัดเฟรมองค์ประกอบเมื่อโหลดแผนที่ ให้เพิ่มแอตทริบิวต์ autofits-camera ลงในองค์ประกอบย่อยแต่ละรายการที่ต้องการภายในวิวพอร์ตเริ่มต้น คุณไม่จำเป็นต้องคำนวณ center หรือ range ใน <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>

แทนที่ YOUR_API_KEY ด้วยคีย์ API ของ Google Maps Platform

ปรับขนาดและทำให้การอัปเดตแบบไดนามิกเคลื่อนไหว

เมื่อคุณเพิ่มองค์ประกอบที่เลือกใช้หลังจากโหลดครั้งแรก ให้อัปเดตพิกัดหรือปลายทางของเส้นทาง หรือตั้งค่า autofitsCamera เป็น true แผนที่จะคำนวณกล้องใหม่เพื่อจัดเฟรมองค์ประกอบที่เลือกใช้ทั้งหมด การนำองค์ประกอบออกหรือตั้งค่า autofitsCamera เป็น false จะทำให้กล้องอยู่ในตำแหน่งเดิมและยกเว้นองค์ประกอบนั้นจากการอัปเดตในอนาคต

หากต้องการควบคุมว่าจะให้การอัปเดตแบบไดนามิกสแนปหรือเคลื่อนไหว ให้ตั้งค่า autofitsCameraAnimation (autofits-camera-animation) ใน Map3DElement เป็นค่า AutofitsCameraAnimation ดังนี้

  • AutofitsCameraAnimation.NONE ("none", ค่าเริ่มต้น): เลื่อนไปยังตำแหน่งที่อัปเดตโดยไม่มีภาพเคลื่อนไหว
  • AutofitsCameraAnimation.FLY_TO ("fly-to"): บินไปยังตำแหน่งที่อัปเดตอย่างราบรื่น การโหลดแผนที่ครั้งแรกจะสแนปโดยไม่มีภาพเคลื่อนไหว และ FLY_TO จะกลับไปใช้การสแนปเมื่อระบบปฏิบัติการของผู้ใช้ขอให้ลดการเคลื่อนไหว

หากต้องการกำหนดค่า autofitsCamera และ AutofitsCameraAnimation.FLY_TO โดยใช้โปรแกรม โปรดดูตัวอย่างต่อไปนี้

<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>

แทนที่ YOUR_API_KEY ด้วยคีย์ API ของ Google Maps Platform

วิธีที่พร็อพเพอร์ตี้และข้อจำกัดของกล้องโต้ตอบกัน

เมื่อองค์ประกอบย่อยอย่างน้อย 1 รายการเลือกใช้ autofits-camera Map3DElement จะรวมการกำหนดค่าแผนที่กับขอบเขตที่คำนวณตามกฎต่อไปนี้

  • center และ range: ถูกลบล้างโดยการจัดเฟรมที่คำนวณ ซึ่งจะเพิ่มระยะห่างจากขอบ 20% และบังคับใช้ระยะต่ำสุด 80 ม. หากไม่มีองค์ประกอบย่อยที่เลือกใช้ซึ่งระบุพิกัด แผนที่จะใช้ center และ range ที่กำหนดค่าไว้เป็นทางเลือกสำรอง
  • tilt และ heading: ถือเป็นค่าที่แนะนำระหว่างการจัดเฟรม เมื่อละเว้น ทั้ง 2 ค่าจะใช้ค่าเริ่มต้นเป็น 0° สำหรับมุมมองจากบนลงล่างและทิศเหนืออยู่ด้านบน
  • roll และ fov: เก็บรักษาไว้ตามที่กำหนดค่าไว้ใน Map3DElement
  • องค์ประกอบย่อยแบบอะซิงโครนัส: ก่อนแสดงผลมุมมองเริ่มต้น Map3DElement จะรอให้องค์ประกอบย่อยแบบอะซิงโครนัสที่เลือกใช้ เช่น <gmp-route-3d> โหลดเรขาคณิตของเส้นทางจนเสร็จ
  • ข้อจำกัดของแผนที่และกล้อง: ขีดจำกัดทางภูมิศาสตร์ bounds และกล้อง (minAltitude, maxAltitude, minTilt, maxTilt, minHeading และ maxHeading) ยังคงจำกัดมุมมองที่ปรับพอดีอัตโนมัติ ดูข้อมูลเพิ่มเติมได้ที่จำกัดมุมมองและขอบเขตของกล้อง

ขั้นตอนถัดไป