คุณสามารถจัดเฟรมเครื่องหมาย เส้นประกอบ รูปหลายเหลี่ยม และเส้นทาง 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) ยังคงจำกัดมุมมองที่ปรับพอดีอัตโนมัติ ดูข้อมูลเพิ่มเติมได้ที่จำกัดมุมมองและขอบเขตของกล้อง