3D Maps

Map3DElement class

google.maps.maps3d.Map3DElement class
extends HTMLElement
implements Map3DElementOptions
library "maps3d"

Map3DElement เป็นอินเทอร์เฟซ HTML สำหรับมุมมองแผนที่ 3 มิติ โปรดทราบว่าต้องตั้งค่า mode เพื่อให้แผนที่ 3 มิติเริ่มแสดงผล

                  
<gmp-map-3d
  autofits-camera-animation="value-name"
  camera-position="lat,lng,altitude"
  center="lat,lng,altitude"
  default-ui-hidden
  description="string"
  fov="number"
  gesture-handling="value-name"
  heading="number"
  internal-usage-attribution-ids="id1 id2"
  map-id="string"
  max-altitude="number"
  max-heading="number"
  max-tilt="number"
  min-altitude="number"
  min-heading="number"
  min-tilt="number"
  mode="value-name"
  range="number"
  roll="number"
  tilt="number">
</gmp-map-3d>

const {Map3DElement} = await google.maps.importLibrary("maps3d");

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

พร็อพเพอร์ตี้
autofitsCameraAnimation attr: autofits-camera-animation	ประกาศ: ใช้ได้เฉพาะในแชแนล v=alpha ประเภทอินพุต: AutofitsCameraAnimation optional ประเภทเอาต์พุต: AutofitsCameraAnimation optional ค่าเริ่มต้น: none ภาพเคลื่อนไหวที่จะใช้สำหรับการปรับกล้องให้พอดีโดยอัตโนมัติ แอตทริบิวต์ HTML: autofits-camera-animation="value-name"
bounds	ประเภทอินพุต: LatLngBounds|LatLngBoundsLiteral optional ประเภทเอาต์พุต: LatLngBounds optional เมื่อตั้งค่าแล้ว จะจำกัดตำแหน่งของกล้องให้อยู่ภายในขอบเขตละติจูด/ลองจิจูดที่ระบุ โปรดทราบว่าระบบจะยังคงแสดงผลออบเจ็กต์ที่อยู่นอกขอบเขต ขอบเขตสามารถจำกัดทั้งลองจิจูดและละติจูด หรือจะจำกัดเฉพาะละติจูดหรือลองจิจูดเท่านั้นก็ได้ สำหรับขอบเขตเฉพาะละติจูด ให้ใช้ลองจิจูดตะวันตกและตะวันออกเป็น -180 และ 180 ตามลำดับ สำหรับขอบเขตเฉพาะลองจิจูด ให้ใช้ละติจูดเหนือและใต้เป็น 90 และ -90 ตามลำดับ
cameraPosition attr: camera-position	ประเภทอินพุต: LatLngAltitude|LatLngAltitudeLiteral|LatLngLiteral optional ประเภทเอาต์พุต: LatLngAltitude optional ตำแหน่งของกล้องที่ระบุเป็น LatLngAltitude ระบบจะดึงข้อมูลหากไม่ระบุ หากไม่ใส่ center แต่ระบุ cameraPosition ระบบจะดึง center มาจาก cameraPosition. หากอัปเดตทั้ง 2 รายการในลูปการเรียกใช้เดียวกัน ระบบจะเลือกใช้ cameraPosition ฟิลด์ cameraPosition และ center สามารถได้มาจากกันและกันแบบหนึ่งต่อหนึ่งในบริบทของทิศทาง ช่วง การหมุน และการเอียงที่แชร์ที่ระบุ แอตทริบิวต์ HTML: camera-position="lat,lng,altitude"
center attr: center	ประเภทอินพุต: LatLngAltitude|LatLngAltitudeLiteral|LatLngLiteral optional ประเภทเอาต์พุต: LatLngAltitude optional ศูนย์กลางของแผนที่ที่ระบุเป็น LatLngAltitude โดยที่ระดับความสูงมีหน่วยเป็นเมตรเหนือระดับน้ำทะเลปานกลาง โปรดทราบว่านี่ไม่ใช่ตำแหน่งที่กล้องอยู่ เนื่องจากช่อง range จะส่งผลต่อระยะห่างของกล้องจากศูนย์กลางแผนที่ หากไม่ได้ตั้งค่าไว้ ระบบจะใช้ค่าเริ่มต้นเป็น {lat: 0, lng: 0, altitude: 63170000} 63170000 เมตรคือระดับความสูงสูงสุดที่อนุญาต (รัศมีของโลกคูณด้วย 10) แอตทริบิวต์ HTML: center="lat,lng,altitude"
defaultUIHidden attr: default-ui-hidden	ประเภทอินพุต: boolean optional ประเภทเอาต์พุต: boolean ค่าเริ่มต้น: false เมื่อ true ปุ่ม UI เริ่มต้นทั้งหมดจะซ่อนอยู่ แอตทริบิวต์ HTML: default-ui-hidden
description attr: description	ประเภทอินพุต: string optional ประเภทเอาต์พุต: string optional หากระบุไว้ ระบบจะเพิ่มคำอธิบายการช่วยเหลือพิเศษ (เช่น สำหรับใช้กับโปรแกรมอ่านหน้าจอ) ลงในแผนที่พร้อมค่าที่ระบุ แอตทริบิวต์ HTML: description="string"
fov attr: fov	ประเภทอินพุต: number optional ประเภทเอาต์พุต: number optional ระบุขอบเขตการมองเห็นแนวตั้งเป็นองศา ค่าที่ใช้ได้จะอยู่ในช่วง 5.0 ถึง 80.0 ค่าที่สูงขึ้นจะเพิ่มพื้นที่ที่มองเห็นได้ แต่อาจทำให้เกิดการบิดเบี้ยวของมุมมอง ค่าเริ่มต้น: 35.0 แอตทริบิวต์ HTML: fov="number"
gestureHandling attr: gesture-handling	ประเภทอินพุต: GestureHandling optional ประเภทเอาต์พุต: GestureHandling ค่าเริ่มต้น: GestureHandling.GREEDY ควบคุมการจัดการท่าทางสัมผัสแบบร่วมมือ เมื่อตั้งค่าเป็น COOPERATIVE คุณต้องใช้แป้นกดร่วมหรือท่าทางสัมผัสด้วย 2 นิ้วเพื่อเลื่อนแผนที่ เมื่อตั้งค่าเป็น GREEDY จะเลื่อนหน้าโฮสต์จากเหตุการณ์ของผู้ใช้ในองค์ประกอบแผนที่ไม่ได้ เมื่อตั้งค่าเป็น AUTO การจัดการท่าทางสัมผัสจะกำหนดโดยความสามารถในการเลื่อนของหน้าโฮสต์ แอตทริบิวต์ HTML: gesture-handling="value-name"
heading attr: heading	ประเภทอินพุต: number optional ประเภทเอาต์พุต: number optional ทิศทางเข็มทิศของแผนที่ในหน่วยองศา โดยทิศเหนือคือ 0 เมื่อไม่มีการเอียง ระบบจะตีความการหมุนเป็นการมุ่งหน้า แอตทริบิวต์ HTML: heading="number"
internalUsageAttributionIds attr: internal-usage-attribution-ids	ประเภทอินพุต: Iterable<string> optional ประเภทเอาต์พุต: Array<string> optional เพิ่มรหัสการระบุแหล่งที่มาของการใช้งานลงใน Initializer ซึ่งช่วยให้ Google เข้าใจว่าไลบรารีและตัวอย่างใดมีประโยชน์ต่อนักพัฒนาซอฟต์แวร์ เช่น การใช้ไลบรารีการคลัสเตอร์เครื่องหมาย หากต้องการเลือกไม่ส่งรหัสการระบุแหล่งที่มาของการใช้งาน คุณสามารถลบพร็อพเพอร์ตี้นี้ได้อย่างปลอดภัย ระบบจะส่งเฉพาะค่าที่ไม่ซ้ำกันเท่านั้น ระบบอาจละเว้นการเปลี่ยนแปลงค่านี้หลังจากการสร้างอินสแตนซ์ แอตทริบิวต์ HTML: internal-usage-attribution-ids="id1 id2"
language	ประเภทอินพุต: string optional ประเภทเอาต์พุต: string optional ภาษาที่พยายามแสดงผลภาษาของแผนที่ฐาน ระบบจะใช้ภาษาที่นักพัฒนาซอฟต์แวร์ขอเป็นค่าเริ่มต้นเมื่อโหลด Maps JS API
mapId attr: map-id	ประเภทอินพุต: string optional ประเภทเอาต์พุต: string optional ระบุรหัสแผนที่ซึ่งจะใช้เพื่อดึงข้อมูลรูปแบบแผนที่ในระบบคลาวด์สำหรับแผนที่ แอตทริบิวต์ HTML: map-id="string"
maxAltitude attr: max-altitude	ประเภทอินพุต: number optional ประเภทเอาต์พุต: number optional ระดับความสูงสูงสุดเหนือพื้นดินที่จะแสดงบนแผนที่ ค่าที่ถูกต้องอยู่ระหว่าง 0 ถึง 63170000 เมตร (รัศมีของโลกคูณด้วย 10) แอตทริบิวต์ HTML: max-altitude="number"
maxHeading attr: max-heading	ประเภทอินพุต: number optional ประเภทเอาต์พุต: number optional มุมสูงสุดของทิศทาง (การหมุน) ของแผนที่ ค่าที่ถูกต้องอยู่ระหว่าง 0 ถึง 360 องศา minHeading และ maxHeading แสดงช่วงเวลา <= 360 องศาซึ่งจะอนุญาตให้ใช้ท่าทางของศีรษะ minHeading = 180 และ maxHeading = 90 จะช่วยให้มุ่งหน้าไปยัง [0, 90] และมุ่งหน้าไปยัง [180, 360] minHeading = 90 และ maxHeading = 180 จะอนุญาตให้มุ่งหน้าไปใน [90, 180] แอตทริบิวต์ HTML: max-heading="number"
maxTilt attr: max-tilt	ประเภทอินพุต: number optional ประเภทเอาต์พุต: number optional มุมตกกระทบสูงสุดของแผนที่ ค่าที่ถูกต้องอยู่ระหว่าง 0 ถึง 90 องศา แอตทริบิวต์ HTML: max-tilt="number"
minAltitude attr: min-altitude	ประเภทอินพุต: number optional ประเภทเอาต์พุต: number optional ระดับความสูงขั้นต่ำเหนือพื้นดินซึ่งจะแสดงบนแผนที่ ค่าที่ถูกต้องอยู่ระหว่าง 0 ถึง 63170000 เมตร (รัศมีของโลกคูณด้วย 10) แอตทริบิวต์ HTML: min-altitude="number"
minHeading attr: min-heading	ประเภทอินพุต: number optional ประเภทเอาต์พุต: number optional มุมต่ำสุดของทิศทาง (การหมุน) ของแผนที่ ค่าที่ถูกต้องอยู่ระหว่าง 0 ถึง 360 องศา minHeading และ maxHeading แสดงช่วงเวลา <= 360 องศาซึ่งจะอนุญาตให้ใช้ท่าทางของศีรษะได้ minHeading = 180 และ maxHeading = 90 จะช่วยให้คุณมุ่งหน้าไปยัง [0, 90] และ [180, 360] ได้ minHeading = 90 และ maxHeading = 180 จะอนุญาตให้มุ่งหน้าไปใน [90, 180] แอตทริบิวต์ HTML: min-heading="number"
minTilt attr: min-tilt	ประเภทอินพุต: number optional ประเภทเอาต์พุต: number optional มุมตกกระทบขั้นต่ำของแผนที่ ค่าที่ถูกต้องอยู่ระหว่าง 0 ถึง 90 องศา แอตทริบิวต์ HTML: min-tilt="number"
mode attr: mode	ประเภทอินพุต: MapMode optional ประเภทเอาต์พุต: MapMode optional ระบุโหมดที่ควรแสดงผลแผนที่ หากไม่ได้ตั้งค่า ระบบจะไม่แสดงผลแผนที่ แอตทริบิวต์ HTML: mode="value-name"
range attr: range	ประเภทอินพุต: number optional ประเภทเอาต์พุต: number optional ระยะทางจากกล้องไปยังศูนย์กลางของแผนที่ (หน่วยเป็นเมตร) แอตทริบิวต์ HTML: range="number"
region	ประเภทอินพุต: string optional ประเภทเอาต์พุต: string optional ภูมิภาคที่จะพยายามแสดงผลจุดที่น่าสนใจของแผนที่ฐาน ระบบจะใช้ภูมิภาคที่นักพัฒนาแอปขอเป็นค่าเริ่มต้นเมื่อโหลด Maps JS API
roll attr: roll	ประเภทอินพุต: number optional ประเภทเอาต์พุต: number optional การหมุนกล้องรอบเวกเตอร์มุมมองเป็นองศา เพื่อแก้ไขความกำกวม เมื่อไม่มีการเอียง การหมุนใดๆ จะตีความว่าเป็นการมุ่งหน้า แอตทริบิวต์ HTML: roll="number"
tilt attr: tilt	ประเภทอินพุต: number optional ประเภทเอาต์พุต: number optional การเอียงของเวกเตอร์มุมมองกล้องเป็นองศา เวกเตอร์มุมมองที่มองลงมายังโลกโดยตรงจะมีการเอียง 0 องศา เวกเตอร์มุมมองที่ชี้ออกจากโลกจะมีการเอียง 180 องศา แอตทริบิวต์ HTML: tilt="number"
defaultUIDisabled attr: default-ui-disabled	เลิกใช้งาน: โปรดใช้ Map3DElement.defaultUIHidden แทน เราจะนำพร็อพเพอร์ตี้นี้ออกเมื่อเปิดตัวเวอร์ชันใหม่ในอนาคต ประเภท: boolean optional ค่าเริ่มต้น: false เมื่อ true ระบบจะปิดใช้ปุ่ม UI เริ่มต้นทั้งหมด ไม่ปิดใช้แป้นพิมพ์และการควบคุมด้วยท่าทางสัมผัส แอตทริบิวต์ HTML: default-ui-disabled

เมธอด
flyCameraAround	flyCameraAround(options) พารามิเตอร์ options: FlyAroundAnimationOptions ผลลัพธ์: ไม่มี วิธีนี้จะหมุนกล้องรอบตำแหน่งที่กำหนดตามระยะเวลาที่กำหนด ภาพเคลื่อนไหวจะเล่นซ้ำได้ตามจำนวน FlyAroundAnimationOptions.repeatCount ครั้งที่กำหนด กล้องจะหมุนตามเข็มนาฬิกา ตำแหน่งที่โคจรรอบจะระบุผ่าน CameraOptions.center นี่คือตำแหน่งที่จะแสดงตรงกลางวิวพอร์ตระหว่างภาพเคลื่อนไหวแบบวงโคจร ขณะที่กล้องเคลื่อนที่ไปรอบๆ เมธอดนี้เป็นแบบอะซิงโครนัสเนื่องจากภาพเคลื่อนไหวจะเริ่มได้หลังจากที่แผนที่โหลดข้อมูลขั้นต่ำแล้วเท่านั้น เมธอดจะแสดงผลเมื่อภาพเคลื่อนไหวเริ่มทำงาน หากจำนวนครั้ง FlyAroundAnimationOptions.repeatCount เป็น 0 จะไม่มีการหมุน และภาพเคลื่อนไหวจะเสร็จสมบูรณ์ทันทีหลังจากเริ่ม
flyCameraTo	flyCameraTo(options) พารามิเตอร์ options: FlyToAnimationOptions ผลลัพธ์: ไม่มี วิธีนี้จะย้ายกล้องแบบพาราโบลาจากตำแหน่งปัจจุบันไปยังตำแหน่งสิ้นสุดที่กำหนดตามระยะเวลาที่กำหนด คุณสามารถระบุตำแหน่งสิ้นสุดได้ผ่าน CameraOptions.cameraPosition ซึ่งจะควบคุมตำแหน่งกล้องที่แน่นอน หรือผ่าน CameraOptions.center ซึ่งจะควบคุมศูนย์กลางวิวพอร์ตที่มองเห็นได้ของแผนที่ เมธอดนี้เป็นแบบอะซิงโครนัสเนื่องจากภาพเคลื่อนไหวจะเริ่มได้หลังจากที่แผนที่โหลดข้อมูลขั้นต่ำแล้วเท่านั้น เมธอดจะแสดงผลเมื่อภาพเคลื่อนไหวเริ่มทำงาน
stopCameraAnimation	stopCameraAnimation() พารามิเตอร์: ไม่มี ผลลัพธ์: ไม่มี เมธอดนี้จะหยุดภาพเคลื่อนไหวการบินที่อาจกำลังทำงานอยู่ กล้องจะยังคงอยู่ที่เดิมในระหว่างที่เล่นภาพเคลื่อนไหว และจะไม่เทเลพอร์ตไปยังจุดสิ้นสุด เมธอดนี้เป็นแบบอะซิงโครนัสเนื่องจากภาพเคลื่อนไหวจะเริ่มหรือหยุดได้หลังจากที่แผนที่โหลดข้อมูลขั้นต่ำแล้วเท่านั้น เมธอดจะแสดงผลเมื่อภาพเคลื่อนไหวหยุดลง
สืบทอด: addEventListener, removeEventListener

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

Map3DElementOptions interface

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

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

พร็อพเพอร์ตี้
autofitsCameraAnimation ไม่บังคับ	ประกาศ: ใช้ได้เฉพาะในแชแนล v=alpha ประเภท: AutofitsCameraAnimation optional ดูMap3DElement.autofitsCameraAnimation
bounds ไม่บังคับ	ประเภท: LatLngBounds|LatLngBoundsLiteral optional ดูMap3DElement.bounds
cameraPosition ไม่บังคับ	ประเภท: LatLngAltitude|LatLngAltitudeLiteral|LatLngLiteral optional ดูMap3DElement.cameraPosition
center ไม่บังคับ	ประเภท: LatLngAltitude|LatLngAltitudeLiteral|LatLngLiteral optional ดูMap3DElement.center
defaultUIDisabled ไม่บังคับ	เลิกใช้งาน: โปรดใช้ Map3DElement.defaultUIHidden แทน เราจะนำพร็อพเพอร์ตี้นี้ออกเมื่อเปิดตัวเวอร์ชันใหม่ในอนาคต ประเภท: boolean optional ดูMap3DElement.defaultUIDisabled
defaultUIHidden ไม่บังคับ	ประเภท: boolean optional ดูMap3DElement.defaultUIHidden
description ไม่บังคับ	ประเภท: string optional ดูMap3DElement.description
fov ไม่บังคับ	ประเภท: number optional ดูMap3DElement.fov
gestureHandling ไม่บังคับ	ประเภท: GestureHandling optional ดูMap3DElement.gestureHandling
heading ไม่บังคับ	ประเภท: number optional ดูMap3DElement.heading
internalUsageAttributionIds ไม่บังคับ	ประเภท: Iterable<string> optional ดูMap3DElement.internalUsageAttributionIds
language ไม่บังคับ	ประเภท: string optional ดูMap3DElement.language
mapId ไม่บังคับ	ประเภท: string optional ดูMap3DElement.mapId
maxAltitude ไม่บังคับ	ประเภท: number optional ดูMap3DElement.maxAltitude
maxHeading ไม่บังคับ	ประเภท: number optional ดูMap3DElement.maxHeading
maxTilt ไม่บังคับ	ประเภท: number optional ดูMap3DElement.maxTilt
minAltitude ไม่บังคับ	ประเภท: number optional ดูMap3DElement.minAltitude
minHeading ไม่บังคับ	ประเภท: number optional ดูMap3DElement.minHeading
minTilt ไม่บังคับ	ประเภท: number optional ดูMap3DElement.minTilt
mode ไม่บังคับ	ประเภท: MapMode optional ดูMap3DElement.mode
range ไม่บังคับ	ประเภท: number optional ดูMap3DElement.range
region ไม่บังคับ	ประเภท: string optional ดูMap3DElement.region
roll ไม่บังคับ	ประเภท: number optional ดูMap3DElement.roll
tilt ไม่บังคับ	ประเภท: number optional ดูMap3DElement.tilt

ค่าคงที่ MapMode

google.maps.maps3d.MapMode ค่าคงที่
ไลบรารี "maps3d"

ระบุโหมดที่ควรแสดงผลแผนที่

ค่าคงที่เหล่านี้ยังใช้เป็นสตริงได้ด้วย ใน TypeScript สตริงลิเทอรัลจะกำหนดโดยประเภท MapModeString

const {MapMode} = await google.maps.importLibrary("maps3d");

ค่าคงที่
HYBRID	โหมดแผนที่นี้จะแสดงเลเยอร์โปร่งใสของถนนสายหลักบนภาพถ่ายจากดาวเทียมหรือภาพที่สมจริง
ROADMAP	ประกาศ: ใช้ได้เฉพาะในแชแนล v=alpha โหมดแผนที่นี้จะแสดงแผนที่ถนนปกติ
SATELLITE	โหมดแผนที่นี้จะแสดงภาพถ่ายจากดาวเทียมหรือภาพถ่ายเสมือนจริง (หากมี)

ค่าคงที่ GestureHandling

google.maps.maps3d.GestureHandling ค่าคงที่
ไลบรารี "maps3d"

ระบุวิธีจัดการเหตุการณ์ท่าทางสัมผัสในองค์ประกอบแผนที่

ค่าคงที่เหล่านี้ยังใช้เป็นสตริงได้ด้วย ใน TypeScript สตริงลิเทอรัลจะกำหนดโดยประเภท GestureHandlingString

const {GestureHandling} = await google.maps.importLibrary("maps3d");

ค่าคงที่
AUTO	ซึ่งจะช่วยให้แผนที่เลือกได้ว่าจะใช้การจัดการท่าทางสัมผัสแบบร่วมมือหรือแบบโลภ ลักษณะการทำงานนี้เป็นลักษณะการทำงานเริ่มต้นหากไม่ได้ระบุไว้ ซึ่งจะทำให้แผนที่เข้าสู่โหมดความร่วมมือหากแผนที่ครอบคลุมองค์ประกอบหลักที่เลื่อนได้ (โดยปกติคือหน้าโฮสต์) จนผู้ใช้ไม่สามารถเลื่อนออกจากแผนที่ไปยังเนื้อหาอื่นๆ ได้
COOPERATIVE	ซึ่งจะบังคับให้ใช้โหมดความร่วมมือ ซึ่งต้องใช้แป้นกดร่วมหรือท่าทางสัมผัสด้วย 2 นิ้วเพื่อเลื่อนแผนที่
GREEDY	ซึ่งจะบังคับใช้โหมด Greedy ซึ่งหน้าโฮสต์จะไม่สามารถเลื่อนจากเหตุการณ์ของผู้ใช้ในองค์ประกอบแผนที่ได้

ค่าคงที่ AutofitsCameraAnimation

google.maps.maps3d.AutofitsCameraAnimation ค่าคงที่
ไลบรารี "maps3d"

ประกาศ: ใช้ได้เฉพาะในแชแนล v=alpha

ระบุลักษณะการทำงานของกล้องเมื่อเคลื่อนไปยังตำแหน่งใหม่เพื่อจัดให้อยู่ตรงกลางตามองค์ประกอบย่อยที่เลือกใช้

ค่าคงที่เหล่านี้ยังใช้เป็นสตริงได้ด้วย ใน TypeScript สตริงลิเทอรัลจะกำหนดโดยประเภท AutofitsCameraAnimationString

const {AutofitsCameraAnimation} = await google.maps.importLibrary("maps3d");

ค่าคงที่
FLY_TO	บินไปยังตำแหน่งใหม่
NONE	สแนปไปยังตำแหน่งใหม่โดยไม่มีภาพเคลื่อนไหว

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

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

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

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

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

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

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

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

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

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

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

พร็อพเพอร์ตี้
altitudeMode ไม่บังคับ	ประเภท: AltitudeMode optional ค่าเริ่มต้น: AltitudeMode.ABSOLUTE Enum ที่ระบุวิธีตีความค่าระดับความสูงของออบเจ็กต์ CameraOptions ที่ระบุ ซึ่งจะใช้ enum ของ AltitudeMode ที่มีอยู่ซ้ำ
cameraPosition ไม่บังคับ	ประเภท: LatLngAltitude|LatLngAltitudeLiteral|LatLngLiteral optional ดูMap3DElement.cameraPosition
center ไม่บังคับ	ประเภท: LatLngAltitude|LatLngAltitudeLiteral|LatLngLiteral optional ดูMap3DElement.center
fov ไม่บังคับ	ประเภท: number optional ดูMap3DElement.fov
heading ไม่บังคับ	ประเภท: number optional ดูMap3DElement.heading
range ไม่บังคับ	ประเภท: number optional ดูMap3DElement.range
roll ไม่บังคับ	ประเภท: number optional ดูMap3DElement.roll
tilt ไม่บังคับ	ประเภท: number optional ดูMap3DElement.tilt

คลาส SteadyChangeEvent

google.maps.maps3d.SteadyChangeEvent class
extends Event
library "maps3d"

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

const {SteadyChangeEvent} = await google.maps.importLibrary("maps3d");

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

คลาส LocationClickEvent

google.maps.maps3d.LocationClickEvent class
extends Event
library "maps3d"

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

const {LocationClickEvent} = await google.maps.importLibrary("maps3d");

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

คลาส PlaceClickEvent

google.maps.maps3d.PlaceClickEvent class
extends LocationClickEvent
library "maps3d"

กิจกรรมนี้สร้างขึ้นจากการคลิกไอคอนสถานที่ใน Map3DElement หากต้องการป้องกันไม่ให้ป๊อปโอเวอร์เริ่มต้นปรากฏขึ้น ให้เรียกใช้เมธอด preventDefault() ในเหตุการณ์นี้เพื่อป้องกันไม่ให้ Map3DElement จัดการเหตุการณ์ดังกล่าว

const {PlaceClickEvent} = await google.maps.importLibrary("maps3d");

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

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