3D Maps

Map3DElement class

google.maps.maps3d.Map3DElement ชั้นเรียน

หมายเหตุ: ใช้ได้เฉพาะในช่อง v=alpha เท่านั้น

Map3DElement เป็นอินเทอร์เฟซ HTML สำหรับมุมมองแผนที่ 3 มิติ

องค์ประกอบที่กำหนดเอง:
<gmp-map-3d center="lat,lng,altitude" default-labels-disabled default-ui-disabled heading="number" max-altitude="number" max-heading="number" max-tilt="number" min-altitude="number" min-heading="number" min-tilt="number" range="number" roll="number" tilt="number"></gmp-map-3d>

ชั้นเรียนนี้ขยายเวลา HTMLElement

คลาสนี้ใช้ Map3DElementOptions

เข้าถึงได้โดยโทรไปที่ const {Map3DElement} = await google.maps.importLibrary("maps3d")
ดูไลบรารีใน Maps JavaScript API

ผู้ผลิต
Map3DElement	Map3DElement([options]) พารามิเตอร์:  options:  Map3DElementOptions optional

พร็อพเพอร์ตี้
bounds	ประเภท:  LatLngBounds|LatLngBoundsLiteral optional เมื่อตั้งค่าแล้ว จะจำกัดตำแหน่งของกล้องภายในขอบเขตละติจูด/ลองจิจูดที่ระบุ โปรดทราบว่าระบบจะยังคงแสดงผลออบเจ็กต์ที่อยู่นอกขอบเขต ขอบเขตสามารถจำกัดทั้งลองจิจูดและละติจูด หรือจะจำกัดเฉพาะละติจูดหรือลองจิจูดอย่างใดอย่างหนึ่งก็ได้ สำหรับขอบเขตละติจูดเท่านั้น ให้ใช้ลองจิจูดตะวันตกและตะวันออกของ -180 และ 180 ตามลำดับ สำหรับขอบเขตที่มีลองจิจูดเท่านั้น ให้ใช้ละติจูดเหนือและใต้ของ 90 และ -90 ตามลำดับ
center	ประเภท:  LatLngAltitude|LatLngAltitudeLiteral optional ศูนย์กลางของแผนที่ที่ระบุเป็น LatLngAltitude โดยที่ระดับความสูงเป็นเมตรเหนือระดับพื้นดิน โปรดทราบว่านี่ไม่ใช่ตำแหน่งของกล้องเสมอไป เนื่องจากฟิลด์ range จะส่งผลต่อระยะห่างของกล้องจากจุดกึ่งกลางของแผนที่ หากไม่ได้ตั้งค่าไว้ ระบบจะใช้ {lat: 0, lng: 0, altitude: 63170000} เป็นค่าเริ่มต้น 63170000 เมตรคือระดับความสูงสูงสุดที่อนุญาต (รัศมีของโลกคูณด้วย 10) แอตทริบิวต์ HTML: <gmp-map-3d center="lat,lng,altitude"></gmp-map-3d>
defaultLabelsDisabled	ประเภท:  boolean optional ค่าเริ่มต้น: false เมื่อ true ระบบจะไม่แสดงป้ายกำกับแผนที่เริ่มต้น แอตทริบิวต์ HTML: <gmp-map-3d default-labels-disabled></gmp-map-3d>
defaultUIDisabled	ประเภท:  boolean optional ค่าเริ่มต้น: false เมื่อ true ระบบจะปิดใช้ปุ่ม UI เริ่มต้นทั้งหมด ไม่ได้ปิดใช้การควบคุมด้วยแป้นพิมพ์และท่าทางสัมผัส แอตทริบิวต์ HTML: <gmp-map-3d default-ui-disabled></gmp-map-3d>
heading	ประเภท:  number optional เข็มทิศของแผนที่ในหน่วยองศา โดยทิศเหนือคือ 0 เมื่อไม่มีการเอียง ระบบจะตีความการหมุนเป็นการมุ่งหน้า แอตทริบิวต์ HTML: <gmp-map-3d heading="number"></gmp-map-3d>
maxAltitude	ประเภท:  number optional ความสูงสูงสุดเหนือพื้นดินที่จะแสดงบนแผนที่ ค่าที่ถูกต้องอยู่ระหว่าง 0 ถึง 63170000 เมตร (รัศมีโลกคูณด้วย 10) แอตทริบิวต์ HTML: <gmp-map-3d max-altitude="number"></gmp-map-3d>
maxHeading	ประเภท:  number optional มุมสูงสุดของส่วนหัว (การหมุน) ของแผนที่ ค่าที่ถูกต้องอยู่ระหว่าง 0 ถึง 360 องศา minHeading และ maxHeading แสดงช่วงเวลาที่มีการอนุญาตให้ใช้ท่าทางสัมผัสการมุ่งหน้าซึ่งมีค่า <= 360 องศา minHeading = 180 และ maxHeading = 90 จะอนุญาตให้มีส่วนหัวใน [0, 90] และส่วนหัวใน [180, 360] minHeading = 90 และ maxHeading = 180 จะอนุญาตให้ใช้ส่วนหัวใน [90, 180] แอตทริบิวต์ HTML: <gmp-map-3d max-heading="number"></gmp-map-3d>
maxTilt	ประเภท:  number optional มุมตกกระทบสูงสุดของแผนที่ ค่าที่ถูกต้องอยู่ระหว่าง 0 ถึง 90 องศา แอตทริบิวต์ HTML: <gmp-map-3d max-tilt="number"></gmp-map-3d>
minAltitude	ประเภท:  number optional ระดับความสูงเหนือพื้นดินขั้นต่ำที่จะแสดงบนแผนที่ ค่าที่ถูกต้องอยู่ระหว่าง 0 ถึง 63170000 เมตร (รัศมีโลกคูณด้วย 10) แอตทริบิวต์ HTML: <gmp-map-3d min-altitude="number"></gmp-map-3d>
minHeading	ประเภท:  number optional มุมต่ำสุดของส่วนหัว (การหมุน) ของแผนที่ ค่าที่ถูกต้องอยู่ระหว่าง 0 ถึง 360 องศา minHeading และ maxHeading แสดงช่วงเวลาที่มีการอนุญาตให้ใช้ท่าทางสัมผัสการมุ่งหน้าซึ่งมีค่า <= 360 องศา minHeading = 180 และ maxHeading = 90 จะอนุญาตให้มีส่วนหัวใน [0, 90] และส่วนหัวใน [180, 360] minHeading = 90 และ maxHeading = 180 จะอนุญาตให้ใช้ส่วนหัวใน [90, 180] แอตทริบิวต์ HTML: <gmp-map-3d min-heading="number"></gmp-map-3d>
minTilt	ประเภท:  number optional มุมตกกระทบต่ำสุดของแผนที่ ค่าที่ถูกต้องอยู่ระหว่าง 0 ถึง 90 องศา แอตทริบิวต์ HTML: <gmp-map-3d min-tilt="number"></gmp-map-3d>
range	ประเภท:  number optional ระยะห่างจากกล้องไปยังกึ่งกลางของแผนที่ หน่วยเป็นเมตร แอตทริบิวต์ HTML: <gmp-map-3d range="number"></gmp-map-3d>
roll	ประเภท:  number optional การหมุนของกล้องรอบเวกเตอร์มุมมองเป็นองศา หากต้องการแก้ปัญหาความคลุมเครือ เมื่อไม่มีการเอียง ระบบจะตีความการหมุนเป็นการมุ่งหน้า แอตทริบิวต์ HTML: <gmp-map-3d roll="number"></gmp-map-3d>
tilt	ประเภท:  number optional การเอียงของเวกเตอร์มุมมองของกล้องเป็นองศา เวกเตอร์มุมมองที่มองลงมายังโลกโดยตรงจะมีมุมเอียง 0 องศา เวกเตอร์มุมมองที่ชี้ออกจากโลกจะมีมุมเอียง 180 องศา แอตทริบิวต์ HTML: <gmp-map-3d tilt="number"></gmp-map-3d>

เมธอด
addEventListener	หมายเหตุ: ใช้ได้เฉพาะในช่อง v=beta เท่านั้น addEventListener(type, listener[, options]) พารามิเตอร์:  type:  string สตริงที่คำนึงถึงตัวพิมพ์เล็กและตัวพิมพ์ใหญ่ซึ่งแสดงถึงประเภทเหตุการณ์ที่จะรับฟัง listener:  EventListener|EventListenerObject ออบเจ็กต์ที่ได้รับการแจ้งเตือน ซึ่งต้องเป็นฟังก์ชันหรือออบเจ็กต์ที่มีเมธอด handleEvent options:  boolean|AddEventListenerOptions optional ดูตัวเลือก เหตุการณ์ที่กำหนดเองรองรับเฉพาะ capture และ passive ค่าที่ส่งคืน:  void ตั้งค่าฟังก์ชันที่จะเรียกใช้เมื่อใดก็ตามที่มีการส่งเหตุการณ์ที่ระบุไปยังเป้าหมาย ดู addEventListener
flyCameraAround	flyCameraAround(options) พารามิเตอร์:  options:  FlyAroundAnimationOptions ค่าที่ส่งคืน: ไม่มี วิธีนี้จะหมุนกล้องรอบตำแหน่งที่กำหนดเป็นระยะเวลาที่กำหนด โดยหมุนตามจำนวนรอบที่กำหนดในเวลานั้น โดยค่าเริ่มต้น กล้องจะหมุนตามเข็มนาฬิกา หากระบุจำนวนรอบเป็นค่าลบ กล้องจะโคจรในทิศทางทวนเข็มนาฬิกาแทน วิธีนี้เป็นแบบไม่พร้อมกันเนื่องจากภาพเคลื่อนไหวจะเริ่มได้หลังจากที่แผนที่โหลดข้อมูลขั้นต่ำแล้วเท่านั้น เมธอดจะแสดงผลเมื่อเริ่มภาพเคลื่อนไหวแล้ว หากจำนวนรอบเป็น 0 จะไม่มีการหมุน และภาพเคลื่อนไหวจะเสร็จสมบูรณ์ทันทีหลังจากเริ่ม
flyCameraTo	flyCameraTo(options) พารามิเตอร์:  options:  FlyToAnimationOptions ค่าที่ส่งคืน: ไม่มี วิธีนี้จะย้ายกล้องแบบพาราโบลาจากตำแหน่งปัจจุบันไปยังตำแหน่งสิ้นสุดที่กำหนดในช่วงระยะเวลาที่กำหนด วิธีนี้เป็นแบบไม่พร้อมกันเนื่องจากภาพเคลื่อนไหวจะเริ่มได้หลังจากที่แผนที่โหลดข้อมูลขั้นต่ำแล้วเท่านั้น เมธอดจะแสดงผลเมื่อเริ่มภาพเคลื่อนไหวแล้ว
removeEventListener	หมายเหตุ: ใช้ได้เฉพาะในช่อง v=beta เท่านั้น removeEventListener(type, listener[, options]) พารามิเตอร์:  type:  string สตริงที่ระบุประเภทของเหตุการณ์ที่จะนำเครื่องมือฟังเหตุการณ์ออก listener:  EventListener|EventListenerObject Listener เหตุการณ์ของตัวแฮนเดิลเหตุการณ์ที่จะนำออกจากเป้าหมายเหตุการณ์ options:  boolean|EventListenerOptions optional ดูตัวเลือก ค่าที่ส่งคืน:  void นำ Listener เหตุการณ์ที่ลงทะเบียนไว้ก่อนหน้านี้ด้วย addEventListener ออกจากเป้าหมาย ดู removeEventListener
stopCameraAnimation	stopCameraAnimation() พารามิเตอร์: ไม่มี ค่าที่ส่งคืน: ไม่มี วิธีนี้จะหยุดภาพเคลื่อนไหวการบินที่อาจกำลังทำงานอยู่ กล้องจะอยู่ที่ตำแหน่งเดิมในระหว่างภาพเคลื่อนไหว ไม่ได้เคลื่อนย้ายไปยังจุดสิ้นสุด เมธอดนี้เป็นแบบไม่พร้อมกันเนื่องจากภาพเคลื่อนไหวจะเริ่มหรือหยุดได้หลังจากที่แผนที่โหลดข้อมูลขั้นต่ำแล้วเท่านั้น เมธอดจะแสดงผลเมื่อภาพเคลื่อนไหวหยุดแล้ว

กิจกรรม
gmp-animationend	function(animationEndEvent) อาร์กิวเมนต์:  animationEndEvent:  Event เหตุการณ์นี้จะเริ่มทำงานเมื่อภาพเคลื่อนไหวการบินสิ้นสุดลง เหตุการณ์นี้จะส่งต่อขึ้นไปตามแผนผัง DOM
gmp-centerchange	function(centerChangeEvent) อาร์กิวเมนต์:  centerChangeEvent:  Event ระบบจะทริกเกอร์เหตุการณ์นี้เมื่อพร็อพเพอร์ตี้ center ของ Map3DElement เปลี่ยนแปลง
gmp-click	function(clickEvent) อาร์กิวเมนต์:  clickEvent:  LocationClickEvent|PlaceClickEvent เหตุการณ์นี้จะเริ่มทำงานเมื่อมีการคลิกองค์ประกอบ Map3DElement
gmp-headingchange	function(headingChangeEvent) อาร์กิวเมนต์:  headingChangeEvent:  Event ระบบจะทริกเกอร์เหตุการณ์นี้เมื่อพร็อพเพอร์ตี้ heading ของ Map3DElement เปลี่ยนแปลง
gmp-rangechange	function(rangeChangeEvent) อาร์กิวเมนต์:  rangeChangeEvent:  Event เหตุการณ์นี้จะทริกเกอร์เมื่อพร็อพเพอร์ตี้ช่วงของ Map3DElement เปลี่ยนแปลง
gmp-rollchange	function(rollChangeEvent) อาร์กิวเมนต์:  rollChangeEvent:  Event ระบบจะทริกเกอร์เหตุการณ์นี้เมื่อพร็อพเพอร์ตี้การหมุนของ Map3DElement เปลี่ยนแปลง
gmp-steadychange	function(steadyChangeEvent) อาร์กิวเมนต์:  steadyChangeEvent:  SteadyChangeEvent เหตุการณ์นี้จะทริกเกอร์เมื่อสถานะคงที่ของ Map3DElement เปลี่ยนแปลง
gmp-tiltchange	function(tiltChangeEvent) อาร์กิวเมนต์:  tiltChangeEvent:  Event เหตุการณ์นี้จะทริกเกอร์เมื่อพร็อพเพอร์ตี้การเอียงของ Map3DElement เปลี่ยนแปลง

Map3DElementOptions อินเทอร์เฟซ

google.maps.maps3d.Map3DElementOptions อินเทอร์เฟซ

หมายเหตุ: ใช้ได้เฉพาะในช่อง v=alpha เท่านั้น

ออบเจ็กต์ Map3DElementOptions ใช้เพื่อกำหนดพร็อพเพอร์ตี้ที่ตั้งค่าได้ใน Map3DElement

พร็อพเพอร์ตี้
bounds optional	ประเภท:  LatLngBounds|LatLngBoundsLiteral optional ดูMap3DElement.bounds
center optional	ประเภท:  LatLngAltitude|LatLngAltitudeLiteral optional ดูMap3DElement.center
defaultLabelsDisabled optional	ประเภท:  boolean optional ดูMap3DElement.defaultLabelsDisabled
defaultUIDisabled optional	ประเภท:  boolean optional ดูMap3DElement.defaultUIDisabled
heading optional	ประเภท:  number optional ดูMap3DElement.heading
maxAltitude optional	ประเภท:  number optional ดูMap3DElement.maxAltitude
maxHeading optional	ประเภท:  number optional ดูMap3DElement.maxHeading
maxTilt optional	ประเภท:  number optional ดูMap3DElement.maxTilt
minAltitude optional	ประเภท:  number optional ดูMap3DElement.minAltitude
minHeading optional	ประเภท:  number optional ดูMap3DElement.minHeading
minTilt optional	ประเภท:  number optional ดูMap3DElement.minTilt
range optional	ประเภท:  number optional ดูMap3DElement.range
roll optional	ประเภท:  number optional ดูMap3DElement.roll
tilt optional	ประเภท:  number optional ดูMap3DElement.tilt

FlyAroundAnimationOptions อินเทอร์เฟซ

google.maps.maps3d.FlyAroundAnimationOptions อินเทอร์เฟซ

หมายเหตุ: ใช้ได้เฉพาะในช่อง v=alpha เท่านั้น

ตัวเลือกการปรับแต่งสำหรับภาพเคลื่อนไหว FlyCameraAround

พร็อพเพอร์ตี้
camera	ประเภท:  CameraOptions จุดกึ่งกลางที่กล้องควรหันไปมองระหว่างภาพเคลื่อนไหววงโคจร โปรดทราบว่าส่วนหัวของแผนที่จะเปลี่ยนไปเมื่อกล้องโคจรรอบจุดกึ่งกลางนี้
durationMillis optional	ประเภท:  number optional ระยะเวลาของภาพเคลื่อนไหวเป็นมิลลิวินาที นี่คือระยะเวลาทั้งหมดของภาพเคลื่อนไหว ไม่ใช่ระยะเวลาของการหมุนครั้งเดียว
rounds optional	ประเภท:  number optional จำนวนรอบที่จะหมุนรอบจุดกึ่งกลางในระยะเวลาที่กำหนด ซึ่งจะควบคุมความเร็วโดยรวมของการหมุน การส่งตัวเลขที่เป็นลบไปยังฟังก์ชัน round จะทำให้กล้องหมุนในทิศทางทวนเข็มนาฬิกาแทนที่จะเป็นทิศทางตามเข็มนาฬิกาเริ่มต้น

FlyToAnimationOptions interface

google.maps.maps3d.FlyToAnimationOptions อินเทอร์เฟซ

หมายเหตุ: ใช้ได้เฉพาะในช่อง v=alpha เท่านั้น

ตัวเลือกการปรับแต่งสำหรับภาพเคลื่อนไหว FlyCameraTo

พร็อพเพอร์ตี้
endCamera	ประเภท:  CameraOptions ตำแหน่งที่กล้องควรชี้ไปที่จุดสิ้นสุดของภาพเคลื่อนไหว
durationMillis optional	ประเภท:  number optional ระยะเวลาของภาพเคลื่อนไหวเป็นมิลลิวินาที ระยะเวลา 0 จะทำให้กล้องเคลื่อนที่ไปยังตำแหน่งสุดท้ายโดยตรง

CameraOptions อินเทอร์เฟซ

google.maps.maps3d.CameraOptions อินเทอร์เฟซ

หมายเหตุ: ใช้ได้เฉพาะในช่อง v=alpha เท่านั้น

ออบเจ็กต์ CameraOptions ใช้เพื่อกำหนดพร็อพเพอร์ตี้ที่ตั้งค่าในออบเจ็กต์กล้องได้ ออบเจ็กต์กล้องอาจเป็นอะไรก็ได้ที่มีตำแหน่งกล้อง เช่น สถานะแผนที่ปัจจุบัน หรือสถานะภาพเคลื่อนไหวที่ขอในอนาคต

พร็อพเพอร์ตี้
center optional	ประเภท:  LatLngAltitude|LatLngAltitudeLiteral optional ดูMap3DElement.center
heading optional	ประเภท:  number optional ดูMap3DElement.heading
range optional	ประเภท:  number optional ดูMap3DElement.range
roll optional	ประเภท:  number optional ดูMap3DElement.roll
tilt optional	ประเภท:  number optional ดูMap3DElement.tilt

SteadyChangeEvent class

google.maps.maps3d.SteadyChangeEvent ชั้นเรียน

หมายเหตุ: ใช้ได้เฉพาะในช่อง v=alpha เท่านั้น

เหตุการณ์นี้สร้างขึ้นจากการตรวจสอบสถานะคงที่ของ Map3DElement เหตุการณ์นี้จะส่งต่อขึ้นไปตามแผนผัง DOM

ชั้นเรียนนี้ขยายเวลา Event

เข้าถึงได้โดยโทรไปที่ const {SteadyChangeEvent} = await google.maps.importLibrary("maps3d")
ดูไลบรารีใน Maps JavaScript API

พร็อพเพอร์ตี้
isSteady	ประเภท:  boolean ระบุว่า Map3DElement คงที่ (เช่น การแสดงผลทั้งหมดสำหรับฉากปัจจุบันเสร็จสมบูรณ์แล้ว) หรือไม่

LocationClickEvent class

google.maps.maps3d.LocationClickEvent ชั้นเรียน

หมายเหตุ: ใช้ได้เฉพาะในช่อง v=alpha เท่านั้น

เหตุการณ์นี้สร้างขึ้นจากการคลิก Map3DElement

ชั้นเรียนนี้ขยายเวลา Event

เข้าถึงได้โดยโทรไปที่ const {LocationClickEvent} = await google.maps.importLibrary("maps3d")
ดูไลบรารีใน Maps JavaScript API

พร็อพเพอร์ตี้
position	ประเภท:  LatLngAltitude optional ละติจูด/ลองจิจูด/ระดับความสูงที่อยู่ใต้เคอร์เซอร์เมื่อเกิดเหตุการณ์ โปรดทราบว่าที่ระดับหยาบกว่า ระบบจะแสดงข้อมูลที่มีความแม่นยำน้อยกว่า นอกจากนี้ ระบบอาจแสดงระดับความสูงของพื้นทะเลเป็นค่าระดับความสูงเมื่อคลิกที่ผิวน้ำจากตำแหน่งกล้องที่สูงขึ้น เหตุการณ์นี้จะส่งต่อขึ้นไปตามแผนผัง DOM

PlaceClickEvent class

google.maps.maps3d.PlaceClickEvent ชั้นเรียน

หมายเหตุ: ใช้ได้เฉพาะในช่อง v=alpha เท่านั้น

เหตุการณ์นี้สร้างขึ้นจากการคลิก Map3DElement

ชั้นเรียนนี้ขยายเวลา LocationClickEvent

เข้าถึงได้โดยโทรไปที่ const {PlaceClickEvent} = await google.maps.importLibrary("maps3d")
ดูไลบรารีใน Maps JavaScript API

พร็อพเพอร์ตี้
placeId	ประเภท:  string รหัสสถานที่ของฟีเจอร์แผนที่
รับค่า: position

เมธอด
fetchPlace	fetchPlace() พารามิเตอร์: ไม่มี ค่าที่ส่งคืน:  Promise<Place> ดึงข้อมูล Place สำหรับรหัสสถานที่นี้ ในออบเจ็กต์ Place ที่ได้ ระบบจะป้อนข้อมูลพร็อพเพอร์ตี้รหัส คุณขอฟิลด์เพิ่มเติมได้ในภายหลังผ่าน Place.fetchFields() โดยขึ้นอยู่กับการเปิดใช้และการเรียกเก็บเงิน Places API ตามปกติ ระบบจะปฏิเสธ Promise หากเกิดข้อผิดพลาดในการดึงข้อมูล Place

Marker3DElement class

google.maps.maps3d.Marker3DElement ชั้นเรียน

หมายเหตุ: ใช้ได้เฉพาะในช่อง v=alpha เท่านั้น

แสดงตำแหน่งบนแผนที่ 3 มิติ โปรดทราบว่าต้องตั้งค่า position เพื่อให้ Marker3DElement แสดง

องค์ประกอบที่กำหนดเอง:
<gmp-marker-3d altitude-mode="absolute" collision-behavior="required" draws-when-occluded extruded label="string" size-preserved z-index="number"></gmp-marker-3d>

ชั้นเรียนนี้ขยายเวลา HTMLElement

คลาสนี้ใช้ Marker3DElementOptions

เข้าถึงได้โดยโทรไปที่ const {Marker3DElement} = await google.maps.importLibrary("maps3d")
ดูไลบรารีใน Maps JavaScript API

ผู้ผลิต
Marker3DElement	Marker3DElement([options]) พารามิเตอร์:  options:  Marker3DElementOptions optional สร้าง Marker3DElement โดยมีตัวเลือกที่ระบุ

พร็อพเพอร์ตี้
altitudeMode	ประเภท:  AltitudeMode optional ค่าเริ่มต้น: AltitudeMode.CLAMP_TO_GROUND ระบุวิธีตีความคอมโพเนนต์ระดับความสูงของตำแหน่ง แอตทริบิวต์ HTML: <gmp-marker-3d altitude-mode="absolute"></gmp-marker-3d> <gmp-marker-3d altitude-mode="clamp-to-ground"></gmp-marker-3d> <gmp-marker-3d altitude-mode="relative-to-ground"></gmp-marker-3d> <gmp-marker-3d altitude-mode="relative-to-mesh"></gmp-marker-3d>
collisionBehavior	ประเภท:  CollisionBehavior optional ค่าเริ่มต้น: CollisionBehavior.REQUIRED การแจงนับที่ระบุลักษณะการทำงานของ Marker3DElement เมื่อชนกับ Marker3DElement อื่นหรือป้ายกำกับของแผนที่ฐาน แอตทริบิวต์ HTML: <gmp-marker-3d collision-behavior="required"></gmp-marker-3d> <gmp-marker-3d collision-behavior="required-and-hides-optional"></gmp-marker-3d> <gmp-marker-3d collision-behavior="optional-and-hides-lower-priority"></gmp-marker-3d>
drawsWhenOccluded	ประเภท:  boolean optional ค่าเริ่มต้น: false ระบุว่าควรวาดเครื่องหมายนี้หรือไม่เมื่อถูกบดบัง เครื่องหมายอาจถูกบดบังด้วยรูปเรขาคณิตของแผนที่ (เช่น อาคาร) แอตทริบิวต์ HTML: <gmp-marker-3d draws-when-occluded></gmp-marker-3d>
extruded	ประเภท:  boolean optional ค่าเริ่มต้น: false ระบุว่าจะเชื่อมต่อเครื่องหมายกับพื้นหรือไม่ หากต้องการดึงเครื่องหมายออกมา altitudeMode ต้องเป็น RELATIVE_TO_GROUND หรือ ABSOLUTE แอตทริบิวต์ HTML: <gmp-marker-3d extruded></gmp-marker-3d>
label	ประเภท:  string optional ข้อความที่เครื่องหมายนี้จะแสดง แอตทริบิวต์ HTML: <gmp-marker-3d label="string"></gmp-marker-3d>
position	ประเภท:  LatLngLiteral|LatLngAltitude|LatLngAltitudeLiteral optional ตำแหน่งของปลายเครื่องหมาย ระบบจะไม่สนใจระดับความสูงในบางโหมด จึงไม่จำเป็นต้องระบุ
sizePreserved	ประเภท:  boolean optional ค่าเริ่มต้น: false ระบุว่าเครื่องหมายนี้ควรคงขนาดไว้หรือไม่โดยไม่คำนึงถึงระยะห่างจากกล้อง โดยค่าเริ่มต้น ระบบจะปรับขนาดเครื่องหมายตามระยะห่างจากกล้อง/การเอียง แอตทริบิวต์ HTML: <gmp-marker-3d size-preserved></gmp-marker-3d>
zIndex	ประเภท:  number optional zIndex เมื่อเทียบกับเครื่องหมายอื่นๆ แอตทริบิวต์ HTML: <gmp-marker-3d z-index="number"></gmp-marker-3d>

สล็อต

default

ระบบจะใส่องค์ประกอบที่กำหนดเองซึ่งเพิ่มลงใน Marker3DElement โดยตรง แต่จะใช้เฉพาะองค์ประกอบประเภท HTMLImageElement, SVGElement และ PinElement ในการวาดเครื่องหมาย ส่วนองค์ประกอบอื่นๆ จะถูกละเว้น HTMLImageElement และ SVGElement ต้องอยู่ในองค์ประกอบ <template> ก่อนที่จะกำหนดให้กับช่องเริ่มต้นของ Marker3DElement ปัจจุบันระบบจะแรสเตอร์รูปภาพและ SVG ก่อนที่จะแสดงผลในฉาก 3 มิติ ดังนั้น HTML ที่กำหนดเองซึ่งฝังอยู่ใน SVG หรือคลาส CSS ที่เพิ่มลงในรูปภาพจะไม่มีผลและอาจไม่แสดงเมื่อเครื่องหมายปรากฏบนหน้าจอ

เมธอด
addEventListener	หมายเหตุ: ใช้ได้เฉพาะในช่อง v=beta เท่านั้น addEventListener(type, listener[, options]) พารามิเตอร์:  type:  string สตริงที่คำนึงถึงตัวพิมพ์เล็กและตัวพิมพ์ใหญ่ซึ่งแสดงถึงประเภทเหตุการณ์ที่จะรับฟัง listener:  EventListener|EventListenerObject ออบเจ็กต์ที่ได้รับการแจ้งเตือน ซึ่งต้องเป็นฟังก์ชันหรือออบเจ็กต์ที่มีเมธอด handleEvent options:  boolean|AddEventListenerOptions optional ดูตัวเลือก เหตุการณ์ที่กำหนดเองรองรับเฉพาะ capture และ passive ค่าที่ส่งคืน:  void ตั้งค่าฟังก์ชันที่จะเรียกใช้เมื่อใดก็ตามที่มีการส่งเหตุการณ์ที่ระบุไปยังเป้าหมาย ดู addEventListener
removeEventListener	หมายเหตุ: ใช้ได้เฉพาะในช่อง v=beta เท่านั้น removeEventListener(type, listener[, options]) พารามิเตอร์:  type:  string สตริงที่ระบุประเภทของเหตุการณ์ที่จะนำเครื่องมือฟังเหตุการณ์ออก listener:  EventListener|EventListenerObject Listener เหตุการณ์ของตัวแฮนเดิลเหตุการณ์ที่จะนำออกจากเป้าหมายเหตุการณ์ options:  boolean|EventListenerOptions optional ดูตัวเลือก ค่าที่ส่งคืน:  void นำ Listener เหตุการณ์ที่ลงทะเบียนไว้ก่อนหน้านี้ด้วย addEventListener ออกจากเป้าหมาย ดู removeEventListener

Marker3DElementOptions อินเทอร์เฟซ

google.maps.maps3d.Marker3DElementOptions อินเทอร์เฟซ

หมายเหตุ: ใช้ได้เฉพาะในช่อง v=alpha เท่านั้น

ออบเจ็กต์ Marker3DElementOptions ใช้เพื่อกำหนดพร็อพเพอร์ตี้ที่ตั้งค่าได้ใน Marker3DElement

พร็อพเพอร์ตี้
altitudeMode optional	ประเภท:  AltitudeMode optional ดูMarker3DElement.altitudeMode
collisionBehavior optional	ประเภท:  CollisionBehavior optional ดูMarker3DElement.collisionBehavior
drawsWhenOccluded optional	ประเภท:  boolean optional ดูMarker3DElement.drawsWhenOccluded
extruded optional	ประเภท:  boolean optional ดูMarker3DElement.extruded
label optional	ประเภท:  string optional ดูMarker3DElement.label
position optional	ประเภท:  LatLngLiteral|LatLngAltitude|LatLngAltitudeLiteral optional ดูMarker3DElement.position
sizePreserved optional	ประเภท:  boolean optional ดูMarker3DElement.sizePreserved
zIndex optional	ประเภท:  number optional ดูMarker3DElement.zIndex

Marker3DInteractiveElement class

google.maps.maps3d.Marker3DInteractiveElement ชั้นเรียน

หมายเหตุ: ใช้ได้เฉพาะในช่อง v=alpha เท่านั้น

แสดงตำแหน่งบนแผนที่ 3 มิติ โปรดทราบว่าต้องตั้งค่า position เพื่อให้ Marker3DInteractiveElement แสดง Marker3DInteractiveElement จะได้รับgmp-clickเหตุการณ์ ซึ่งแตกต่างจาก Marker3DElement

องค์ประกอบที่กำหนดเอง:
<gmp-marker-3d-interactive></gmp-marker-3d-interactive>

ชั้นเรียนนี้ขยายเวลา Marker3DElement

คลาสนี้ใช้ Marker3DInteractiveElementOptions

เข้าถึงได้โดยโทรไปที่ const {Marker3DInteractiveElement} = await google.maps.importLibrary("maps3d")
ดูไลบรารีใน Maps JavaScript API

ผู้ผลิต
Marker3DInteractiveElement	Marker3DInteractiveElement([options]) พารามิเตอร์:  options:  Marker3DInteractiveElementOptions optional สร้าง Marker3DInteractiveElement โดยมีตัวเลือกที่ระบุ

พร็อพเพอร์ตี้
สืบทอด: altitudeMode, collisionBehavior, drawsWhenOccluded, extruded, label, position, sizePreserved, zIndex

สล็อต
default	ระบบจะจัดช่องสำหรับองค์ประกอบที่กำหนดเองซึ่งเพิ่มลงใน Marker3DInteractiveElement โดยตรง แต่จะใช้เฉพาะองค์ประกอบประเภท PinElement ในการวาดเครื่องหมาย ส่วนองค์ประกอบอื่นๆ จะไม่นำมาใช้

เมธอด
addEventListener	addEventListener(type, listener[, options]) พารามิเตอร์:  type:  string สตริงที่คำนึงถึงตัวพิมพ์เล็กและตัวพิมพ์ใหญ่ซึ่งแสดงถึงประเภทเหตุการณ์ที่จะรับฟัง listener:  EventListener|EventListenerObject ออบเจ็กต์ที่ได้รับการแจ้งเตือน ซึ่งต้องเป็นฟังก์ชันหรือออบเจ็กต์ที่มีเมธอด handleEvent options:  boolean|AddEventListenerOptions optional ดูตัวเลือก เหตุการณ์ที่กำหนดเองรองรับเฉพาะ capture และ passive ค่าที่ส่งคืน:  void ตั้งค่าฟังก์ชันที่จะเรียกใช้เมื่อใดก็ตามที่มีการส่งเหตุการณ์ที่ระบุไปยังเป้าหมาย ดู addEventListener
removeEventListener	removeEventListener(type, listener[, options]) พารามิเตอร์:  type:  string สตริงที่ระบุประเภทของเหตุการณ์ที่จะนำเครื่องมือฟังเหตุการณ์ออก listener:  EventListener|EventListenerObject Listener เหตุการณ์ของตัวแฮนเดิลเหตุการณ์ที่จะนำออกจากเป้าหมายเหตุการณ์ options:  boolean|EventListenerOptions optional ดูตัวเลือก ค่าที่ส่งคืน:  void นำ Listener เหตุการณ์ที่ลงทะเบียนไว้ก่อนหน้านี้ด้วย addEventListener ออกจากเป้าหมาย ดู removeEventListener

กิจกรรม
gmp-click	function(clickEvent) อาร์กิวเมนต์:  clickEvent:  LocationClickEvent เหตุการณ์นี้จะเริ่มทำงานเมื่อมีการคลิกองค์ประกอบ Marker3DInteractiveElement

Marker3DInteractiveElementOptions interface

google.maps.maps3d.Marker3DInteractiveElementOptions อินเทอร์เฟซ

หมายเหตุ: ใช้ได้เฉพาะในช่อง v=alpha เท่านั้น

ออบเจ็กต์ Marker3DInteractiveElementOptions ใช้เพื่อกำหนดพร็อพเพอร์ตี้ที่ตั้งค่าได้ใน Marker3DInteractiveElement

อินเทอร์เฟซนี้ขยาย Marker3DElementOptions

พร็อพเพอร์ตี้
สืบทอด: altitudeMode, collisionBehavior, drawsWhenOccluded, extruded, label, position, sizePreserved, zIndex

Model3DElement class

google.maps.maps3d.Model3DElement ชั้นเรียน

หมายเหตุ: ใช้ได้เฉพาะในช่อง v=alpha เท่านั้น

โมเดล 3 มิติที่อนุญาตให้แสดงผลโมเดล gLTF โปรดทราบว่าต้องตั้งค่า position และ src เพื่อให้ Model3DElement แสดง

ควรมีการรองรับพร็อพเพอร์ตี้หลักของ gLTF PBR ขณะนี้ระบบยังไม่รองรับส่วนขยายหรือพร็อพเพอร์ตี้ส่วนขยาย

องค์ประกอบที่กำหนดเอง:
<gmp-model-3d altitude-mode="absolute" src="src"></gmp-model-3d>

ชั้นเรียนนี้ขยายเวลา HTMLElement

คลาสนี้ใช้ Model3DElementOptions

เข้าถึงได้โดยโทรไปที่ const {Model3DElement} = await google.maps.importLibrary("maps3d")
ดูไลบรารีใน Maps JavaScript API

ผู้ผลิต
Model3DElement	Model3DElement([options]) พารามิเตอร์:  options:  Model3DElementOptions optional สร้าง Model3DElement โดยมีตัวเลือกที่ระบุ

พร็อพเพอร์ตี้
altitudeMode	ประเภท:  AltitudeMode optional ค่าเริ่มต้น: AltitudeMode.CLAMP_TO_GROUND ระบุวิธีตีความระดับความสูงในตำแหน่ง แอตทริบิวต์ HTML: <gmp-model-3d altitude-mode="absolute"></gmp-model-3d> <gmp-model-3d altitude-mode="clamp-to-ground"></gmp-model-3d> <gmp-model-3d altitude-mode="relative-to-ground"></gmp-model-3d> <gmp-model-3d altitude-mode="relative-to-mesh"></gmp-model-3d>
orientation	ประเภท:  Orientation3D|Orientation3DLiteral optional อธิบายการหมุนระบบพิกัดของโมเดล 3 มิติเพื่อวางตำแหน่งโมเดลบนแผนที่ 3 มิติ การหมุนจะใช้กับโมเดลตามลำดับต่อไปนี้ การหมุน การเอียง และการมุ่งหน้า
position	ประเภท:  LatLngLiteral|LatLngAltitude|LatLngAltitudeLiteral optional ตั้งค่าตำแหน่งของ Model3DElement ระบบจะไม่สนใจระดับความสูงในบางโหมด จึงไม่จำเป็นต้องระบุ
scale	ประเภท:  number|Vector3D|Vector3DLiteral optional ค่าเริ่มต้น: 1 ปรับขนาดโมเดลตามแกน x, y และ z ในพื้นที่พิกัดของโมเดล
src	ประเภท:  string|URL optional ระบุ URL ของโมเดล 3 มิติ ปัจจุบันรองรับเฉพาะโมเดลในรูปแบบ .glb เท่านั้น ระบบจะเปลี่ยน URL HTTP สัมพัทธ์เป็น URL ที่สมบูรณ์ที่เกี่ยวข้อง โปรดทราบว่าหากคุณโฮสต์ไฟล์โมเดล .glb ในเว็บไซต์หรือเซิร์ฟเวอร์อื่นที่ไม่ใช่แอปพลิเคชันหลัก ให้ตรวจสอบว่าได้ตั้งค่าส่วนหัว HTTP ของ CORS อย่างถูกต้อง ซึ่งจะช่วยให้แอปพลิเคชันเข้าถึงไฟล์โมเดลจากโดเมนอื่นได้อย่างปลอดภัย แอตทริบิวต์ HTML: <gmp-model-3d src="src"></gmp-model-3d>

เมธอด
addEventListener	หมายเหตุ: ใช้ได้เฉพาะในช่อง v=beta เท่านั้น addEventListener(type, listener[, options]) พารามิเตอร์:  type:  string สตริงที่คำนึงถึงตัวพิมพ์เล็กและตัวพิมพ์ใหญ่ซึ่งแสดงถึงประเภทเหตุการณ์ที่จะรับฟัง listener:  EventListener|EventListenerObject ออบเจ็กต์ที่ได้รับการแจ้งเตือน ซึ่งต้องเป็นฟังก์ชันหรือออบเจ็กต์ที่มีเมธอด handleEvent options:  boolean|AddEventListenerOptions optional ดูตัวเลือก เหตุการณ์ที่กำหนดเองรองรับเฉพาะ capture และ passive ค่าที่ส่งคืน:  void ตั้งค่าฟังก์ชันที่จะเรียกใช้เมื่อใดก็ตามที่มีการส่งเหตุการณ์ที่ระบุไปยังเป้าหมาย ดู addEventListener
removeEventListener	หมายเหตุ: ใช้ได้เฉพาะในช่อง v=beta เท่านั้น removeEventListener(type, listener[, options]) พารามิเตอร์:  type:  string สตริงที่ระบุประเภทของเหตุการณ์ที่จะนำเครื่องมือฟังเหตุการณ์ออก listener:  EventListener|EventListenerObject Listener เหตุการณ์ของตัวแฮนเดิลเหตุการณ์ที่จะนำออกจากเป้าหมายเหตุการณ์ options:  boolean|EventListenerOptions optional ดูตัวเลือก ค่าที่ส่งคืน:  void นำ Listener เหตุการณ์ที่ลงทะเบียนไว้ก่อนหน้านี้ด้วย addEventListener ออกจากเป้าหมาย ดู removeEventListener

Model3DElementOptions interface

google.maps.maps3d.Model3DElementOptions อินเทอร์เฟซ

หมายเหตุ: ใช้ได้เฉพาะในช่อง v=alpha เท่านั้น

ออบเจ็กต์ Model3DElementOptions ใช้เพื่อกำหนดพร็อพเพอร์ตี้ที่ตั้งค่าได้ใน Model3DElement

พร็อพเพอร์ตี้
altitudeMode optional	ประเภท:  AltitudeMode optional ดูModel3DElement.altitudeMode
orientation optional	ประเภท:  Orientation3D|Orientation3DLiteral optional ดูModel3DElement.orientation
position optional	ประเภท:  LatLngLiteral|LatLngAltitude|LatLngAltitudeLiteral optional ดูModel3DElement.position
scale optional	ประเภท:  number|Vector3D|Vector3DLiteral optional ดูModel3DElement.scale
src optional	ประเภท:  string|URL optional ดูModel3DElement.src

Polyline3DElement class

google.maps.maps3d.Polyline3DElement ชั้นเรียน

หมายเหตุ: ใช้ได้เฉพาะในช่อง v=alpha เท่านั้น

เส้นประกอบ 3 มิติคือการซ้อนทับเชิงเส้นของส่วนเส้นที่เชื่อมต่อกันบนแผนที่ 3 มิติ

องค์ประกอบที่กำหนดเอง:
<gmp-polyline-3d altitude-mode="absolute" draws-occluded-segments extruded geodesic outer-color="string" outer-width="number" stroke-color="string" stroke-width="number" z-index="number"></gmp-polyline-3d>

ชั้นเรียนนี้ขยายเวลา HTMLElement

คลาสนี้ใช้ Polyline3DElementOptions

เข้าถึงได้โดยโทรไปที่ const {Polyline3DElement} = await google.maps.importLibrary("maps3d")
ดูไลบรารีใน Maps JavaScript API

ผู้ผลิต
Polyline3DElement	Polyline3DElement([options]) พารามิเตอร์:  options:  Polyline3DElementOptions optional สร้าง Polyline3DElement โดยมีตัวเลือกที่ระบุ

พร็อพเพอร์ตี้
altitudeMode	ประเภท:  AltitudeMode optional ค่าเริ่มต้น: AltitudeMode.ABSOLUTE ระบุวิธีตีความคอมโพเนนต์ระดับความสูงในพิกัด แอตทริบิวต์ HTML: <gmp-polyline-3d altitude-mode="absolute"></gmp-polyline-3d> <gmp-polyline-3d altitude-mode="clamp-to-ground"></gmp-polyline-3d> <gmp-polyline-3d altitude-mode="relative-to-ground"></gmp-polyline-3d> <gmp-polyline-3d altitude-mode="relative-to-mesh"></gmp-polyline-3d>
coordinates	ประเภท:  Iterable<LatLngAltitude|LatLngAltitudeLiteral|LatLngLiteral> optional ลำดับพิกัดของ Polyline ระบบจะไม่สนใจระดับความสูงในบางโหมด จึงไม่จำเป็นต้องระบุ
drawsOccludedSegments	ประเภท:  boolean optional ค่าเริ่มต้น: false ระบุว่าจะวาดส่วนของเส้นหลายเส้นที่อาจถูกบดบังหรือไม่ รูปหลายเหลี่ยมอาจถูกเรขาคณิตของแผนที่ (เช่น อาคาร) บดบัง แอตทริบิวต์ HTML: <gmp-polyline-3d draws-occluded-segments></gmp-polyline-3d>
extruded	ประเภท:  boolean optional ค่าเริ่มต้น: false ระบุว่าจะเชื่อมต่อเส้นหลายเส้นกับพื้นหรือไม่ หากต้องการดึงเส้นประกอบ altitudeMode ต้องเป็น RELATIVE_TO_GROUND หรือ ABSOLUTE แอตทริบิวต์ HTML: <gmp-polyline-3d extruded></gmp-polyline-3d>
geodesic	ประเภท:  boolean optional ค่าเริ่มต้น: false เมื่อ true ระบบจะตีความขอบของเส้นหลายเส้นเป็นเส้นโค้งตามพื้นผิวโลกและจะโค้งตามความโค้งของโลก เมื่อ false ขอบของเส้นหลายส่วนจะแสดงเป็นเส้นตรงในพื้นที่หน้าจอ แอตทริบิวต์ HTML: <gmp-polyline-3d geodesic></gmp-polyline-3d>
outerColor	ประเภท:  string optional สีด้านนอก รองรับสี CSS3 ทั้งหมด แอตทริบิวต์ HTML: <gmp-polyline-3d outer-color="string"></gmp-polyline-3d>
outerWidth	ประเภท:  number optional ความกว้างด้านนอกอยู่ระหว่าง 0.0 ถึง 1.0 ซึ่งเป็นเปอร์เซ็นต์ของ strokeWidth แอตทริบิวต์ HTML: <gmp-polyline-3d outer-width="number"></gmp-polyline-3d>
strokeColor	ประเภท:  string optional สีเส้น รองรับสี CSS3 ทั้งหมด แอตทริบิวต์ HTML: <gmp-polyline-3d stroke-color="string"></gmp-polyline-3d>
strokeWidth	ประเภท:  number optional ความหนาของเส้นในหน่วยพิกเซล แอตทริบิวต์ HTML: <gmp-polyline-3d stroke-width="number"></gmp-polyline-3d>
zIndex	ประเภท:  number optional zIndex เมื่อเทียบกับรูปหลายเหลี่ยมอื่นๆ แอตทริบิวต์ HTML: <gmp-polyline-3d z-index="number"></gmp-polyline-3d>

เมธอด
addEventListener	หมายเหตุ: ใช้ได้เฉพาะในช่อง v=beta เท่านั้น addEventListener(type, listener[, options]) พารามิเตอร์:  type:  string สตริงที่คำนึงถึงตัวพิมพ์เล็กและตัวพิมพ์ใหญ่ซึ่งแสดงถึงประเภทเหตุการณ์ที่จะรับฟัง listener:  EventListener|EventListenerObject ออบเจ็กต์ที่ได้รับการแจ้งเตือน ซึ่งต้องเป็นฟังก์ชันหรือออบเจ็กต์ที่มีเมธอด handleEvent options:  boolean|AddEventListenerOptions optional ดูตัวเลือก เหตุการณ์ที่กำหนดเองรองรับเฉพาะ capture และ passive ค่าที่ส่งคืน:  void ตั้งค่าฟังก์ชันที่จะเรียกใช้เมื่อใดก็ตามที่มีการส่งเหตุการณ์ที่ระบุไปยังเป้าหมาย ดู addEventListener
removeEventListener	หมายเหตุ: ใช้ได้เฉพาะในช่อง v=beta เท่านั้น removeEventListener(type, listener[, options]) พารามิเตอร์:  type:  string สตริงที่ระบุประเภทของเหตุการณ์ที่จะนำเครื่องมือฟังเหตุการณ์ออก listener:  EventListener|EventListenerObject Listener เหตุการณ์ของตัวแฮนเดิลเหตุการณ์ที่จะนำออกจากเป้าหมายเหตุการณ์ options:  boolean|EventListenerOptions optional ดูตัวเลือก ค่าที่ส่งคืน:  void นำ Listener เหตุการณ์ที่ลงทะเบียนไว้ก่อนหน้านี้ด้วย addEventListener ออกจากเป้าหมาย ดู removeEventListener

Polyline3DElementOptions อินเทอร์เฟซ

google.maps.maps3d.Polyline3DElementOptions อินเทอร์เฟซ

หมายเหตุ: ใช้ได้เฉพาะในช่อง v=alpha เท่านั้น

ออบเจ็กต์ Polyline3DElementOptions ใช้เพื่อกำหนดพร็อพเพอร์ตี้ที่ตั้งค่าได้ใน Polyline3DElement

พร็อพเพอร์ตี้
altitudeMode optional	ประเภท:  AltitudeMode optional ดูPolyline3DElement.altitudeMode
coordinates optional	ประเภท:  Iterable<LatLngAltitude|LatLngAltitudeLiteral|LatLngLiteral> optional ดูPolyline3DElement.coordinates
drawsOccludedSegments optional	ประเภท:  boolean optional ดูPolyline3DElement.drawsOccludedSegments
extruded optional	ประเภท:  boolean optional ดูPolyline3DElement.extruded
geodesic optional	ประเภท:  boolean optional ดูPolyline3DElement.geodesic
outerColor optional	ประเภท:  string optional ดูPolyline3DElement.outerColor
outerWidth optional	ประเภท:  number optional ดูPolyline3DElement.outerWidth
strokeColor optional	ประเภท:  string optional ดูPolyline3DElement.strokeColor
strokeWidth optional	ประเภท:  number optional ดูPolyline3DElement.strokeWidth
zIndex optional	ประเภท:  number optional ดูPolyline3DElement.zIndex

Polygon3DElement class

google.maps.maps3d.Polygon3DElement ชั้นเรียน

หมายเหตุ: ใช้ได้เฉพาะในช่อง v=alpha เท่านั้น

รูปหลายเหลี่ยม 3 มิติ (เช่น เส้นประกอบ 3 มิติ) จะกำหนดชุดพิกัดที่เชื่อมต่อกันในลำดับที่เรียง นอกจากนี้ รูปหลายเหลี่ยมยังสร้างลูปปิดและกำหนดพื้นที่ที่เติม

องค์ประกอบที่กำหนดเอง:
<gmp-polygon-3d altitude-mode="absolute" draws-occluded-segments extruded fill-color="string" geodesic stroke-color="string" stroke-width="number" z-index="number"></gmp-polygon-3d>

ชั้นเรียนนี้ขยายเวลา HTMLElement

คลาสนี้ใช้ Polygon3DElementOptions

เข้าถึงได้โดยโทรไปที่ const {Polygon3DElement} = await google.maps.importLibrary("maps3d")
ดูไลบรารีใน Maps JavaScript API

ผู้ผลิต
Polygon3DElement	Polygon3DElement([options]) พารามิเตอร์:  options:  Polygon3DElementOptions optional สร้าง Polygon3DElement โดยมีตัวเลือกที่ระบุ

พร็อพเพอร์ตี้
altitudeMode	ประเภท:  AltitudeMode optional ค่าเริ่มต้น: AltitudeMode.ABSOLUTE ระบุวิธีตีความคอมโพเนนต์ระดับความสูงในพิกัด แอตทริบิวต์ HTML: <gmp-polygon-3d altitude-mode="absolute"></gmp-polygon-3d> <gmp-polygon-3d altitude-mode="clamp-to-ground"></gmp-polygon-3d> <gmp-polygon-3d altitude-mode="relative-to-ground"></gmp-polygon-3d> <gmp-polygon-3d altitude-mode="relative-to-mesh"></gmp-polygon-3d>
drawsOccludedSegments	ประเภท:  boolean optional ค่าเริ่มต้น: false ระบุว่าจะวาดส่วนของรูปหลายเหลี่ยมที่อาจถูกบดบังหรือไม่ รูปหลายเหลี่ยมอาจถูกเรขาคณิตของแผนที่ (เช่น อาคาร) บดบัง แอตทริบิวต์ HTML: <gmp-polygon-3d draws-occluded-segments></gmp-polygon-3d>
extruded	ประเภท:  boolean optional ค่าเริ่มต้น: false ระบุว่าจะเชื่อมต่อรูปหลายเหลี่ยมกับพื้นหรือไม่ หากต้องการดึงรูปหลายเหลี่ยม altitudeMode ต้องเป็น RELATIVE_TO_GROUND หรือ ABSOLUTE แอตทริบิวต์ HTML: <gmp-polygon-3d extruded></gmp-polygon-3d>
fillColor	ประเภท:  string optional สีเติม รองรับสี CSS3 ทั้งหมด แอตทริบิวต์ HTML: <gmp-polygon-3d fill-color="string"></gmp-polygon-3d>
geodesic	ประเภท:  boolean optional ค่าเริ่มต้น: false เมื่อ true ขอบของรูปหลายเหลี่ยมจะได้รับการตีความเป็นเส้นโค้งบนพื้นผิวโลกและจะโค้งตามความโค้งของโลก เมื่อ false ขอบของรูปหลายเหลี่ยมจะแสดงเป็นเส้นตรงในพื้นที่หน้าจอ แอตทริบิวต์ HTML: <gmp-polygon-3d geodesic></gmp-polygon-3d>
innerCoordinates	ประเภท:  Iterable<Iterable<LatLngAltitude|LatLngAltitudeLiteral|LatLngLiteral>> optional ลำดับของพิกัดที่กำหนดลูปปิด รูปหลายเหลี่ยมอาจประกอบด้วยเส้นทางอย่างน้อย 1 เส้นทาง ซึ่งจะสร้างช่องเจาะหลายช่องภายในรูปหลายเหลี่ยม ซึ่งแตกต่างจากเส้นหลายเส้น
outerCoordinates	ประเภท:  Iterable<LatLngAltitude|LatLngAltitudeLiteral|LatLngLiteral> optional ลำดับของพิกัดที่กำหนดลูปปิด ระบบจะไม่สนใจระดับความสูงในบางโหมด จึงไม่จำเป็นต้องระบุ
strokeColor	ประเภท:  string optional สีเส้น รองรับสี CSS3 ทั้งหมด แอตทริบิวต์ HTML: <gmp-polygon-3d stroke-color="string"></gmp-polygon-3d>
strokeWidth	ประเภท:  number optional ความหนาของเส้นในหน่วยพิกเซล แอตทริบิวต์ HTML: <gmp-polygon-3d stroke-width="number"></gmp-polygon-3d>
zIndex	ประเภท:  number optional zIndex เมื่อเทียบกับรูปหลายเหลี่ยมอื่นๆ แอตทริบิวต์ HTML: <gmp-polygon-3d z-index="number"></gmp-polygon-3d>

เมธอด
addEventListener	หมายเหตุ: ใช้ได้เฉพาะในช่อง v=beta เท่านั้น addEventListener(type, listener[, options]) พารามิเตอร์:  type:  string สตริงที่คำนึงถึงตัวพิมพ์เล็กและตัวพิมพ์ใหญ่ซึ่งแสดงถึงประเภทเหตุการณ์ที่จะรับฟัง listener:  EventListener|EventListenerObject ออบเจ็กต์ที่ได้รับการแจ้งเตือน ซึ่งต้องเป็นฟังก์ชันหรือออบเจ็กต์ที่มีเมธอด handleEvent options:  boolean|AddEventListenerOptions optional ดูตัวเลือก เหตุการณ์ที่กำหนดเองรองรับเฉพาะ capture และ passive ค่าที่ส่งคืน:  void ตั้งค่าฟังก์ชันที่จะเรียกใช้เมื่อใดก็ตามที่มีการส่งเหตุการณ์ที่ระบุไปยังเป้าหมาย ดู addEventListener
removeEventListener	หมายเหตุ: ใช้ได้เฉพาะในช่อง v=beta เท่านั้น removeEventListener(type, listener[, options]) พารามิเตอร์:  type:  string สตริงที่ระบุประเภทของเหตุการณ์ที่จะนำเครื่องมือฟังเหตุการณ์ออก listener:  EventListener|EventListenerObject Listener เหตุการณ์ของตัวแฮนเดิลเหตุการณ์ที่จะนำออกจากเป้าหมายเหตุการณ์ options:  boolean|EventListenerOptions optional ดูตัวเลือก ค่าที่ส่งคืน:  void นำ Listener เหตุการณ์ที่ลงทะเบียนไว้ก่อนหน้านี้ด้วย addEventListener ออกจากเป้าหมาย ดู removeEventListener

Polygon3DElementOptions อินเทอร์เฟซ

google.maps.maps3d.Polygon3DElementOptions อินเทอร์เฟซ

หมายเหตุ: ใช้ได้เฉพาะในช่อง v=alpha เท่านั้น

ออบเจ็กต์ Polygon3DElementOptions ใช้เพื่อกำหนดพร็อพเพอร์ตี้ที่ตั้งค่าได้ใน Polygon3DElement

พร็อพเพอร์ตี้
altitudeMode optional	ประเภท:  AltitudeMode optional ดูPolygon3DElement.altitudeMode
drawsOccludedSegments optional	ประเภท:  boolean optional ดูPolygon3DElement.drawsOccludedSegments
extruded optional	ประเภท:  boolean optional ดูPolygon3DElement.extruded
fillColor optional	ประเภท:  string optional ดูPolygon3DElement.fillColor
geodesic optional	ประเภท:  boolean optional ดูPolygon3DElement.geodesic
innerCoordinates optional	ประเภท:  Iterable<Iterable<LatLngAltitude|LatLngAltitudeLiteral>|Iterable<LatLngLiteral>> optional ดูPolygon3DElement.innerCoordinates
outerCoordinates optional	ประเภท:  Iterable<LatLngAltitude|LatLngAltitudeLiteral|LatLngLiteral> optional ดูPolygon3DElement.outerCoordinates
strokeColor optional	ประเภท:  string optional ดูPolygon3DElement.strokeColor
strokeWidth optional	ประเภท:  number optional ดูPolygon3DElement.strokeWidth
zIndex optional	ประเภท:  number optional ดูPolygon3DElement.zIndex

AltitudeMode ค่าคงที่

google.maps.maps3d.AltitudeMode ค่าคงที่

หมายเหตุ: ใช้ได้เฉพาะในช่อง v=alpha เท่านั้น

ระบุวิธีตีความคอมโพเนนต์ระดับความสูงในพิกัด

เข้าถึงได้โดยโทรไปที่ const {AltitudeMode} = await google.maps.importLibrary("maps3d")
ดูไลบรารีใน Maps JavaScript API

ค่าคงที่
ABSOLUTE	ช่วยให้แสดงวัตถุเทียบกับระดับน้ำทะเลเฉลี่ยได้ นอกจากนี้ยังหมายความว่าหากระดับรายละเอียดของภูมิประเทศเปลี่ยนไปใต้วัตถุ ตำแหน่งสัมบูรณ์ของวัตถุจะยังคงเหมือนเดิม
CLAMP_TO_GROUND	ช่วยให้แสดงวัตถุที่วางอยู่บนพื้นได้ โดยจะยังคงอยู่ที่ระดับพื้นดินตามภูมิประเทศไม่ว่าจะมีการระบุความสูงเท่าใดก็ตาม หากวางออบเจ็กต์เหนือแหล่งน้ำขนาดใหญ่ ระบบจะวางออบเจ็กต์ที่ระดับน้ำทะเล
RELATIVE_TO_GROUND	ช่วยให้แสดงวัตถุที่สัมพันธ์กับพื้นผิวได้ หากระดับรายละเอียดของภูมิประเทศเปลี่ยนแปลง ตำแหน่งของวัตถุจะยังคงที่เมื่อเทียบกับพื้นดิน เมื่ออยู่เหนือน้ำ ระบบจะตีความระดับความสูงเป็นค่าในหน่วยเมตรเหนือระดับน้ำทะเล
RELATIVE_TO_MESH	ช่วยให้แสดงวัตถุที่สัมพันธ์กับพื้นดิน + อาคาร + ผิวน้ำที่สูงที่สุดได้ เมื่ออยู่เหนือน้ำ พื้นผิวจะเป็นผิวน้ำ เมื่ออยู่เหนือภูมิประเทศ พื้นผิวจะเป็นพื้นผิวอาคาร (หากมี) หรือพื้นผิวพื้นดิน (หากไม่มีอาคาร)