Maps

คลาสแผนที่

google.maps.Map ชั้นเรียน

ชั้นเรียนนี้ขยายระยะเวลาถึง MVCObject

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

Map
Map(mapDiv[, opts])
พารามิเตอร์: 
  • mapDivHTMLElement แผนที่จะแสดงผลให้เต็มองค์ประกอบนี้
  • opts:  ตัวเลือก MapOptions optional
สร้างแผนที่ใหม่ภายในคอนเทนเนอร์ HTML ที่กำหนด ซึ่งโดยทั่วไปจะเป็นองค์ประกอบ DIV
DEMO_MAP_ID รหัสแผนที่ซึ่งสามารถใช้กับตัวอย่างโค้ดที่ต้องใช้รหัสแผนที่ รหัสแผนที่นี้ไม่ได้มีไว้ใช้ในแอปพลิเคชันเวอร์ชันที่ใช้งานจริง และไม่สามารถใช้สำหรับฟีเจอร์ที่ต้องการการกำหนดค่าในระบบคลาวด์ (เช่น การจัดรูปแบบระบบคลาวด์)
controls
ประเภท:  Array<MVCArray<HTMLElement>>
การควบคุมเพิ่มเติมสำหรับการแนบกับแผนที่ หากต้องการเพิ่มการควบคุมลงในแผนที่ ให้เพิ่ม <div> ของตัวควบคุมลงใน MVCArray ที่สอดคล้องกับ ControlPosition ในตำแหน่งที่ควรแสดง
data
ประเภท:  Data
อินสแตนซ์ของ Data เชื่อมโยงกับแผนที่ เพิ่มฟีเจอร์ลงในวัตถุ Data นี้เพื่อแสดงบนแผนที่นี้ได้อย่างสะดวก
mapTypes
ประเภท:  MapTypeRegistry
รีจิสทรีของอินสแตนซ์ MapType ตามรหัสสตริง
overlayMapTypes
ประเภท:  MVCArray<MapType optional>
ประเภทแผนที่เพิ่มเติมที่จะวางซ้อน ประเภทแผนที่ซ้อนทับจะแสดงที่ด้านบนของแผนที่ฐานที่แนบอยู่ ตามลำดับที่ปรากฏในอาร์เรย์ overlayMapTypes (การวางซ้อนที่มีค่าดัชนีสูงกว่าจะแสดงข้างหน้าโฆษณาซ้อนทับที่มีค่าดัชนีต่ำกว่า)
fitBounds
fitBounds(bounds[, padding])
พารามิเตอร์: 
  • boundsLatLngBounds|LatLngBoundsLiteral ขอบเขตที่จะแสดง
  • paddingnumber|Padding optional ระยะห่างจากขอบเป็นพิกเซล ขอบเขตนี้จะพอดีกับส่วนของแผนที่ที่เหลืออยู่หลังจากนำระยะห่างจากขอบออกแล้ว ค่าตัวเลขจะมีระยะห่างจากขอบเท่ากันทั้ง 4 ด้าน ใส่ 0 ที่นี่เพื่อทําให้เป็นรหัส fitBounds ของผลลัพธ์ของ getBounds
ผลลัพธ์: ไม่มี
ตั้งค่าวิวพอร์ตให้มีขอบเขตที่กำหนด
หมายเหตุ: เมื่อตั้งค่าแผนที่เป็น display: none ฟังก์ชัน fitBounds จะอ่านขนาดของแผนที่เป็น 0x0 และจะไม่ดำเนินการใดๆ หากต้องการเปลี่ยนวิวพอร์ตขณะที่แผนที่ซ่อนอยู่ ให้ตั้งค่าแผนที่เป็น visibility: hidden เพื่อให้ div ของแผนที่มีขนาดจริง สำหรับแผนที่เวกเตอร์ เมธอดนี้ตั้งค่าการเอียงและทิศทางของแผนที่เป็นค่าเริ่มต้น 0 การเรียกใช้วิธีการนี้อาจทำให้เกิดภาพเคลื่อนไหวที่ลื่นไหลเมื่อแผนที่เลื่อนและซูมให้พอดีกับขอบเขต วิธีการนี้จะเคลื่อนไหวหรือไม่นั้นขึ้นอยู่กับการเรียนรู้ภายใน
getBounds
getBounds()
พารามิเตอร์: ไม่มี
ผลลัพธ์:  LatLngBounds|undefined ขอบเขตละติจูด/ลองจิจูดของวิวพอร์ตปัจจุบัน
แสดงขอบเขตละติจูด/ลองจิจูดของวิวพอร์ตปัจจุบัน หากสามารถมองเห็นสำเนาโลกได้มากกว่า 1 ฉบับ ขอบเขตในลองจิจูดตั้งแต่ -180 ถึง 180 องศา (รวม -180 ถึง 180 องศา) หากแผนที่ยังไม่ได้เริ่มต้นหรือตั้งค่ากึ่งกลางและไม่ได้ตั้งการซูม ผลลัพธ์จะเป็น undefined สำหรับแผนที่เวกเตอร์ที่มีการเอียงหรือทิศทางที่ไม่ใช่ 0 ขอบเขตละติจูด/ลองจิจูดที่แสดงคือกรอบล้อมรอบที่เล็กที่สุดซึ่งรวมพื้นที่ที่มองเห็นได้ของวิวพอร์ตของแผนที่ ดู MapCanvasProjection.getVisibleRegion เพื่อให้ทราบภูมิภาคที่มองเห็นได้ชัดเจนของวิวพอร์ตแผนที่
getCenter
getCenter()
พารามิเตอร์: ไม่มี
ค่าที่ส่งคืน:  LatLng|undefined
แสดงตำแหน่งที่อยู่กึ่งกลางของแผนที่ โปรดทราบว่าออบเจ็กต์ LatLng นี้ไม่ได้รวมอยู่ ดูข้อมูลเพิ่มเติมได้ที่ LatLng หากไม่ได้กำหนดจุดศูนย์กลางหรือขอบเขตไว้ ผลลัพธ์จะเป็น undefined
getClickableIcons
getClickableIcons()
พารามิเตอร์: ไม่มี
ค่าที่ส่งคืน:  boolean|undefined
แสดงความสามารถในการคลิกของไอคอนแผนที่ ไอคอนแผนที่แสดงจุดสนใจ หรือที่เรียกว่าจุดที่น่าสนใจ หากค่าที่แสดงผลคือ true จะคลิกไอคอนบนแผนที่ได้
BetagetDatasetFeatureLayer
getDatasetFeatureLayer(datasetId)
พารามิเตอร์: 
  • datasetIdstring
ค่าที่ส่งคืน:  FeatureLayer
แสดง FeatureLayer สำหรับ datasetId ที่ระบุ ต้องกำหนดค่ารหัสชุดข้อมูลใน Google Cloud Console ถ้ารหัสชุดข้อมูลไม่ได้เชื่อมโยงกับรูปแบบแผนที่ หรือหากไม่มีการจัดรูปแบบตามข้อมูล (ไม่มีรหัสแผนที่ ไม่มีชิ้นส่วนเวกเตอร์ ไม่มีเลเยอร์ของฟีเจอร์การจัดรูปแบบที่เป็นไปตามข้อมูล หรือชุดข้อมูลที่กำหนดค่าในรูปแบบแผนที่) ระบบจะบันทึกข้อผิดพลาด และ FeatureLayer.isAvailable ที่ได้จะเป็นเท็จ
getDiv
getDiv()
พารามิเตอร์: ไม่มี
ผลลัพธ์:  HTMLElement MapDiv ของแผนที่
getFeatureLayer
getFeatureLayer(featureType)
พารามิเตอร์: 
ค่าที่ส่งคืน:  FeatureLayer
แสดง FeatureLayer ของ FeatureType ที่เจาะจง ต้องเปิดใช้ FeatureLayer ใน Google Cloud Console หากไม่มี FeatureLayer ของ FeatureType ที่ระบุบนแผนที่นี้ หรือหากไม่มีการจัดรูปแบบจากข้อมูล (ไม่มีรหัสแผนที่ ไม่มีชิ้นส่วนเวกเตอร์ และไม่ได้เปิดใช้งาน FeatureLayer ในรูปแบบแผนที่) ข้อมูลนี้จะบันทึกข้อผิดพลาด และ FeatureLayer.isAvailable ที่ได้จะเป็นเท็จ
getHeading
getHeading()
พารามิเตอร์: ไม่มี
ค่าที่ส่งคืน:  number|undefined
แสดงทิศทางเข็มทิศของแผนที่ ค่าส่วนหัวจะวัดเป็นองศา (ตามเข็มนาฬิกา) จากทิศเหนือคาร์ดินัล หากแผนที่ยังไม่เริ่มทำงาน ผลลัพธ์จะเป็น undefined
getHeadingInteractionEnabled
getHeadingInteractionEnabled()
พารามิเตอร์: ไม่มี
ค่าที่ส่งคืน:  boolean|null
แสดงผลว่ามีการเปิดใช้การโต้ตอบกับส่วนหัวหรือไม่ ตัวเลือกนี้จะมีผลเมื่อแผนที่เป็นแผนที่เวกเตอร์เท่านั้น หากไม่ได้กำหนดเป็นโค้ด ระบบจะใช้การกำหนดค่าระบบคลาวด์สำหรับรหัสแผนที่ (หากมี)
getMapCapabilities
getMapCapabilities()
พารามิเตอร์: ไม่มี
ค่าที่ส่งคืน:  MapCapabilities
แจ้งให้ผู้โทรทราบถึงความสามารถในปัจจุบันที่มีในแผนที่ โดยดูจากรหัสแผนที่ที่ให้ไว้
getMapTypeId
getMapTypeId()
พารามิเตอร์: ไม่มี
ค่าที่ส่งคืน:  MapTypeId|string|undefined
getProjection
getProjection()
พารามิเตอร์: ไม่มี
ค่าที่ส่งคืน:  Projection|undefined
แสดง Projection ปัจจุบัน หากแผนที่ยังไม่เริ่มทำงาน ผลลัพธ์จะเป็น undefined ฟังเหตุการณ์ projection_changed และตรวจสอบค่าว่าไม่ใช่ undefined
getRenderingType
getRenderingType()
พารามิเตอร์: ไม่มี
ค่าที่ส่งคืน:  RenderingType
แสดง RenderingType ปัจจุบันของแผนที่
getStreetView
getStreetView()
พารามิเตอร์: ไม่มี
ผลลัพธ์:  StreetViewPanorama ภาพพาโนรามาที่ผูกกับแผนที่
แสดง StreetViewPanorama เริ่มต้นที่ผูกกับแผนที่ ซึ่งอาจเป็นภาพพาโนรามาเริ่มต้นที่ฝังอยู่ในแผนที่ หรือตั้งค่าพาโนรามาโดยใช้ setStreetView() การเปลี่ยนแปลง streetViewControl ของแผนที่จะแสดงในภาพพาโนรามาที่ผูกไว้ดังกล่าวด้วย
getTilt
getTilt()
พารามิเตอร์: ไม่มี
ค่าที่ส่งคืน:  number|undefined
แสดงผลมุมปัจจุบันของอุบัติการณ์ของแผนที่เป็นองศาจากระนาบวิวพอร์ตไปยังระนาบแผนที่ สำหรับแผนที่แรสเตอร์ ผลลัพธ์จะเป็น 0 สำหรับภาพที่ถ่ายจากมุมสูงโดยตรง หรือ 45 สำหรับภาพ 45° เมธอดนี้จะไม่แสดงค่าที่ setTilt ตั้งไว้ ดูรายละเอียดได้ที่ setTilt
getTiltInteractionEnabled
getTiltInteractionEnabled()
พารามิเตอร์: ไม่มี
ค่าที่ส่งคืน:  boolean|null
แสดงผลว่ามีการเปิดใช้การโต้ตอบการเอียงหรือไม่ ตัวเลือกนี้จะมีผลเมื่อแผนที่เป็นแผนที่เวกเตอร์เท่านั้น หากไม่ได้กำหนดเป็นโค้ด ระบบจะใช้การกำหนดค่าระบบคลาวด์สำหรับรหัสแผนที่ (หากมี)
getZoom
getZoom()
พารามิเตอร์: ไม่มี
ค่าที่ส่งคืน:  number|undefined
แสดงการซูมของแผนที่ หากยังไม่ได้ตั้งค่าการซูม ผลลัพธ์จะเป็น undefined
moveCamera
moveCamera(cameraOptions)
พารามิเตอร์: 
ผลลัพธ์: ไม่มี
ตั้งค่ากล้องของแผนที่ไปที่ตัวเลือกกล้องเป้าหมายทันที โดยไม่มีภาพเคลื่อนไหว
panBy
panBy(x, y)
พารามิเตอร์: 
  • xnumber จำนวนพิกเซลที่จะย้ายแผนที่ไปในทิศทาง x
  • ynumber จำนวนพิกเซลที่จะย้ายแผนที่ไปในทิศทาง y
ผลลัพธ์: ไม่มี
เปลี่ยนศูนย์กลางของแผนที่ตามระยะทางที่ระบุเป็นพิกเซล ถ้าระยะทางน้อยกว่าความกว้างและความสูงของแผนที่ การเปลี่ยนจะเป็นภาพเคลื่อนไหวอย่างราบรื่น โปรดทราบว่าระบบพิกัดแผนที่เพิ่มขึ้นจากตะวันตกไปยังตะวันออก (สำหรับค่า x) และจากเหนือไปใต้ (สำหรับค่า y)
panTo
panTo(latLng)
พารามิเตอร์: 
  • latLngLatLng|LatLngLiteral ละติจูด/ลองจิจูดศูนย์กลางใหม่ของแผนที่
ผลลัพธ์: ไม่มี
เปลี่ยนศูนย์กลางของแผนที่เป็น LatLng ที่ระบุ ถ้าการเปลี่ยนแปลงมีค่าน้อยกว่าทั้งความกว้างและความสูงของแผนที่ การเปลี่ยนจะเป็นภาพเคลื่อนไหวอย่างราบรื่น
panToBounds
panToBounds(latLngBounds[, padding])
พารามิเตอร์: 
  • latLngBoundsLatLngBounds|LatLngBoundsLiteral ขอบเขตที่ต้องเลื่อนแผนที่ไป
  • paddingnumber|Padding optional ระยะห่างจากขอบเป็นพิกเซล ค่าตัวเลขจะมีระยะห่างจากขอบเท่ากันทั้ง 4 ด้าน ค่าเริ่มต้นคือ 0
ผลลัพธ์: ไม่มี
เลื่อนแผนที่ตามจำนวนขั้นต่ำที่จำเป็นสำหรับมี LatLngBounds ที่ระบุ ทำให้ไม่สามารถรับประกันตำแหน่งบนแผนที่ ยกเว้นว่าจะมีการเลื่อนแผนที่เพื่อแสดงขอบเขตภายใน {currentMapSizeInPx} - {padding} ให้ได้มากที่สุด สำหรับทั้งแผนที่แรสเตอร์และแผนที่เวกเตอร์ การซูม การเอียง และทิศทางของแผนที่จะไม่เปลี่ยนแปลง
setCenter
setCenter(latlng)
พารามิเตอร์: 
ผลลัพธ์: ไม่มี
setClickableIcons
setClickableIcons(value)
พารามิเตอร์: 
  • valueboolean
ผลลัพธ์: ไม่มี
ควบคุมว่าไอคอนแผนที่จะคลิกได้หรือไม่ ไอคอนแผนที่แสดงจุดสนใจ หรือที่เรียกว่าจุดที่น่าสนใจ หากต้องการปิดใช้ความสามารถในการคลิกได้ของไอคอนแผนที่ ให้ส่งค่า false ไปยังเมธอดนี้
setHeading
setHeading(heading)
พารามิเตอร์: 
  • headingnumber
ผลลัพธ์: ไม่มี
ตั้งทิศทางของเข็มทิศสำหรับแผนที่โดยวัดเป็นองศาจากทิศเหนือทิศเหนือ สำหรับแผนที่แรสเตอร์ วิธีการนี้ใช้กับภาพถ่ายทางอากาศเท่านั้น
setHeadingInteractionEnabled
setHeadingInteractionEnabled(headingInteractionEnabled)
พารามิเตอร์: 
  • headingInteractionEnabledboolean
ผลลัพธ์: ไม่มี
ตั้งค่าว่าจะเปิดใช้การโต้ตอบกับส่วนหัวหรือไม่ ตัวเลือกนี้จะมีผลเมื่อแผนที่เป็นแผนที่เวกเตอร์เท่านั้น หากไม่ได้กำหนดเป็นโค้ด ระบบจะใช้การกำหนดค่าระบบคลาวด์สำหรับรหัสแผนที่ (หากมี)
setMapTypeId
setMapTypeId(mapTypeId)
พารามิเตอร์: 
ผลลัพธ์: ไม่มี
setOptions
setOptions(options)
พารามิเตอร์: 
ผลลัพธ์: ไม่มี
setRenderingType
setRenderingType(renderingType)
พารามิเตอร์: 
ผลลัพธ์: ไม่มี
ตั้งค่า RenderingType ปัจจุบันของแผนที่
setStreetView
setStreetView(panorama)
พารามิเตอร์: 
  • panoramaStreetViewPanorama optional ภาพพาโนรามาที่จะเชื่อมโยงกับแผนที่
ผลลัพธ์: ไม่มี
เชื่อมโยง StreetViewPanorama กับแผนที่ ภาพพาโนรามานี้จะลบล้าง StreetViewPanorama เริ่มต้น ทำให้แผนที่เชื่อมโยงกับภาพพาโนรามาภายนอกที่อยู่นอกแผนที่ได้ การตั้งค่าภาพพาโนรามาเป็น null จะเชื่อมโยงภาพพาโนรามาเริ่มต้นที่ฝังกลับไปเป็นแผนที่
setTilt
setTilt(tilt)
พารามิเตอร์: 
  • tiltnumber
ผลลัพธ์: ไม่มี
สำหรับแผนที่เวกเตอร์ ให้กำหนดมุมของเหตุการณ์ของแผนที่ ค่าที่อนุญาตจะถูกจำกัดตามระดับการซูมของแผนที่

สำหรับแผนที่แรสเตอร์ ให้ควบคุมลักษณะการเปลี่ยนอัตโนมัติสำหรับมุมของเหตุการณ์ของแผนที่ ค่าที่อนุญาตมีเพียง 0 และ 45 เท่านั้น setTilt(0) ทำให้แผนที่ใช้มุมมองจากมุมสูง 0° เสมอ โดยไม่คำนึงถึงระดับการซูมและวิวพอร์ต setTilt(45) จะทำให้มุมเอียงสลับเป็น 45 โดยอัตโนมัติเมื่อใดก็ตามที่ภาพ 45° พร้อมใช้งานสำหรับระดับการซูมและวิวพอร์ตปัจจุบัน และสลับกลับไปเป็น 0 เมื่อไม่มีภาพ 45° (นี่คือลักษณะการทำงานเริ่มต้น) ภาพ 45° มีให้บริการสำหรับแผนที่ประเภท satellite และ hybrid เท่านั้น ภายในสถานที่บางแห่งและที่การซูมบางระดับ หมายเหตุ: getTilt จะแสดงผลมุมเอียงปัจจุบัน ไม่ใช่ค่าที่ setTilt ตั้งไว้ เนื่องจาก getTilt และ setTilt อ้างอิงถึงสิ่งที่แตกต่างกัน โปรดอย่า bind() พร็อพเพอร์ตี้ tilt การทำเช่นนั้นอาจให้ผลลัพธ์ที่คาดเดาไม่ได้
setTiltInteractionEnabled
setTiltInteractionEnabled(tiltInteractionEnabled)
พารามิเตอร์: 
  • tiltInteractionEnabledboolean
ผลลัพธ์: ไม่มี
ตั้งค่าว่าจะเปิดใช้งานการโต้ตอบการเอียงหรือไม่ ตัวเลือกนี้จะมีผลเมื่อแผนที่เป็นแผนที่เวกเตอร์เท่านั้น หากไม่ได้กำหนดเป็นโค้ด ระบบจะใช้การกำหนดค่าระบบคลาวด์สำหรับรหัสแผนที่ (หากมี)
setZoom
setZoom(zoom)
พารามิเตอร์: 
  • zoomnumber ค่าการซูมที่ใหญ่ขึ้นสอดคล้องกับความละเอียดที่สูงขึ้น
ผลลัพธ์: ไม่มี
ตั้งค่าการซูมของแผนที่
รับค่าเดิม: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll
bounds_changed
function()
อาร์กิวเมนต์: ไม่มี
เหตุการณ์นี้จะเริ่มทำงานเมื่อขอบเขตของวิวพอร์ตมีการเปลี่ยนแปลง
center_changed
function()
อาร์กิวเมนต์: ไม่มี
เหตุการณ์นี้จะเกิดขึ้นเมื่อคุณสมบัติศูนย์กลางของแผนที่มีการเปลี่ยนแปลง
click
function(event)
อาร์กิวเมนต์: 
เหตุการณ์นี้จะเกิดขึ้นเมื่อผู้ใช้คลิกบนแผนที่ ระบบจะแสดงผล MapMouseEvent พร้อมพร็อพเพอร์ตี้สำหรับตำแหน่งที่คลิกเว้นแต่จะมีการคลิกไอคอนสถานที่ ซึ่งในกรณีนี้ระบบจะส่งคืน IconMouseEvent ที่มีรหัสสถานที่ IconMouseEvent และ MapMouseEvent เหมือนกัน ยกเว้นว่า IconMouseEvent มีช่องรหัสสถานที่ กิจกรรมดังกล่าวถือเป็นกิจกรรม MapMouseEvent ได้เสมอ ในกรณีที่รหัสสถานที่ไม่สำคัญ กิจกรรมการคลิกจะไม่เริ่มทำงานหากมีการคลิกเครื่องหมายหรือหน้าต่างข้อมูล
contextmenu
function(event)
อาร์กิวเมนต์: 
เหตุการณ์นี้จะเกิดขึ้นเมื่อเหตุการณ์เมนูตามบริบทของ DOM เริ่มทำงานในคอนเทนเนอร์แผนที่
dblclick
function(event)
อาร์กิวเมนต์: 
เหตุการณ์นี้จะเกิดขึ้นเมื่อผู้ใช้ดับเบิลคลิกบนแผนที่ โปรดทราบว่าบางครั้งเหตุการณ์การคลิกจะเริ่มทำงาน 1 ครั้งและบางครั้งก็ 2 ครั้งก่อนหน้ารายการนี้
drag
function()
อาร์กิวเมนต์: ไม่มี
เหตุการณ์นี้เกิดขึ้นซ้ำๆ ขณะที่ผู้ใช้ลากแผนที่
dragend
function()
อาร์กิวเมนต์: ไม่มี
เหตุการณ์นี้จะเกิดขึ้นเมื่อผู้ใช้หยุดลากแผนที่
dragstart
function()
อาร์กิวเมนต์: ไม่มี
เหตุการณ์นี้จะเกิดขึ้นเมื่อผู้ใช้เริ่มลากแผนที่
heading_changed
function()
อาร์กิวเมนต์: ไม่มี
เหตุการณ์นี้จะเริ่มทำงานเมื่อพร็อพเพอร์ตี้ส่วนหัวของแผนที่เปลี่ยนแปลง
idle
function()
อาร์กิวเมนต์: ไม่มี
เหตุการณ์นี้จะเกิดขึ้นเมื่อแผนที่ไม่มีความเคลื่อนไหวหลังจากเลื่อนหรือซูม
isfractionalzoomenabled_changed
function()
อาร์กิวเมนต์: ไม่มี
เหตุการณ์นี้จะเริ่มทำงานเมื่อคุณสมบัติ isFractionalZoomEnabled มีการเปลี่ยนแปลง
mapcapabilities_changed
function()
อาร์กิวเมนต์: ไม่มี
เหตุการณ์นี้จะเกิดขึ้นเมื่อความสามารถของแผนที่มีการเปลี่ยนแปลง
maptypeid_changed
function()
อาร์กิวเมนต์: ไม่มี
เหตุการณ์นี้จะเกิดขึ้นเมื่อพร็อพเพอร์ตี้ MapTypeId มีการเปลี่ยนแปลง
mousemove
function(event)
อาร์กิวเมนต์: 
เหตุการณ์นี้จะเริ่มทำงานเมื่อใดก็ตามที่เมาส์ของผู้ใช้เลื่อนผ่านคอนเทนเนอร์แผนที่
mouseout
function(event)
อาร์กิวเมนต์: 
เหตุการณ์นี้จะเกิดขึ้นเมื่อเมาส์ของผู้ใช้ออกจากคอนเทนเนอร์แผนที่
mouseover
function(event)
อาร์กิวเมนต์: 
เหตุการณ์นี้จะเริ่มทำงานเมื่อเมาส์ของผู้ใช้เข้าสู่คอนเทนเนอร์แผนที่
projection_changed
function()
อาร์กิวเมนต์: ไม่มี
เหตุการณ์นี้จะเริ่มทำงานเมื่อการฉายภาพมีการเปลี่ยนแปลง
renderingtype_changed
function()
อาร์กิวเมนต์: ไม่มี
เหตุการณ์นี้จะเริ่มทำงานเมื่อ generateType มีการเปลี่ยนแปลง
tilesloaded
function()
อาร์กิวเมนต์: ไม่มี
เหตุการณ์นี้จะเริ่มทำงานเมื่อการ์ดที่มองเห็นได้โหลดเสร็จแล้ว
tilt_changed
function()
อาร์กิวเมนต์: ไม่มี
เหตุการณ์นี้จะเกิดขึ้นเมื่อคุณสมบัติการเอียงแผนที่มีการเปลี่ยนแปลง
zoom_changed
function()
อาร์กิวเมนต์: ไม่มี
เหตุการณ์นี้จะเกิดขึ้นเมื่อคุณสมบัติการซูมแผนที่มีการเปลี่ยนแปลง
rightclick
function(event)
อาร์กิวเมนต์: 
เหตุการณ์นี้จะเกิดขึ้นเมื่อผู้ใช้คลิกขวาบนแผนที่

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

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

ออบเจ็กต์ MapOptions ที่ใช้กำหนดคุณสมบัติที่สามารถตั้งค่าบนแผนที่

backgroundColor optional
ประเภท:  string optional
สีที่ใช้สำหรับพื้นหลังของ div ของแผนที่ สีนี้จะแสดงให้เห็นเมื่อยังไม่มีการโหลดชิ้นส่วนภาพเมื่อผู้ใช้เลื่อน ตัวเลือกนี้จะตั้งค่าได้ต่อเมื่อเริ่มใช้แผนที่แล้วเท่านั้น
center optional
ประเภท:  LatLng|LatLngLiteral optional
ศูนย์แผนที่เริ่มต้น
clickableIcons optional
ประเภท:  boolean optional
ค่าเริ่มต้น: true
เมื่อ false ไอคอนแผนที่จะไม่สามารถคลิกได้ ไอคอนแผนที่แสดงจุดสนใจ หรือที่เรียกว่าจุดที่น่าสนใจ
controlSize optional
ประเภท:  number optional
ขนาดเป็นพิกเซลของตัวควบคุมที่ปรากฏในแผนที่ ต้องระบุค่านี้โดยตรงเมื่อสร้างแผนที่ การอัปเดตค่านี้ในภายหลังอาจทำให้การควบคุมมีสถานะ undefined มีผลกับการควบคุมที่ตัว Maps API สร้างขึ้นเท่านั้น ไม่ปรับขนาดการควบคุมที่กำหนดเองที่นักพัฒนาแอปสร้างขึ้น
disableDefaultUI optional
ประเภท:  boolean optional
เปิด/ปิดใช้ปุ่ม UI เริ่มต้นทั้งหมด อาจถูกลบล้างทีละรายการ ไม่ปิดใช้การควบคุมแป้นพิมพ์ซึ่งควบคุมโดยตัวเลือก MapOptions.keyboardShortcuts แยกกัน ไม่ปิดใช้การควบคุมด้วยท่าทางสัมผัส ซึ่งควบคุมแยกกันโดยตัวเลือก MapOptions.gestureHandling
disableDoubleClickZoom optional
ประเภท:  boolean optional
เปิด/ปิดใช้งานการซูมและจัดกึ่งกลางเมื่อดับเบิลคลิก เปิดใช้โดยค่าเริ่มต้น

หมายเหตุ: ไม่แนะนำพร็อพเพอร์ตี้นี้ หากต้องการปิดการซูมเมื่อดับเบิลคลิก คุณสามารถใช้คุณสมบัติ gestureHandling และตั้งค่าเป็น "none"

draggable optional
ประเภท:  boolean optional
หากเป็น false จะป้องกันไม่ให้แผนที่ถูกลาก การลากจะเปิดใช้งานโดยค่าเริ่มต้น
draggableCursor optional
ประเภท:  string optional
ชื่อหรือ URL ของเคอร์เซอร์ที่จะแสดงเมื่อวางเมาส์เหนือแผนที่ที่ลากได้ พร็อพเพอร์ตี้นี้ใช้แอตทริบิวต์ cursor ของ CSS เพื่อเปลี่ยนไอคอน คุณต้องระบุเคอร์เซอร์สำรองอย่างน้อย 1 ตัวที่ไม่ใช่ URL เช่นเดียวกับในพร็อพเพอร์ตี้ CSS เช่น draggableCursor: 'url(http://www.example.com/icon.png), auto;'
draggingCursor optional
ประเภท:  string optional
ชื่อหรือ URL ของเคอร์เซอร์ที่จะแสดงเมื่อมีการลากแผนที่ พร็อพเพอร์ตี้นี้ใช้แอตทริบิวต์ cursor ของ CSS เพื่อเปลี่ยนไอคอน คุณต้องระบุเคอร์เซอร์สำรองอย่างน้อย 1 ตัวที่ไม่ใช่ URL เช่นเดียวกับในพร็อพเพอร์ตี้ CSS เช่น draggingCursor: 'url(http://www.example.com/icon.png), auto;'
fullscreenControl optional
ประเภท:  boolean optional
สถานะเปิด/ปิดใช้ของตัวควบคุมแบบเต็มหน้าจอ
fullscreenControlOptions optional
ประเภท:  FullscreenControlOptions optional
ตัวเลือกการแสดงผลสำหรับการควบคุมแบบเต็มหน้าจอ
gestureHandling optional
ประเภท:  string optional
การตั้งค่านี้ควบคุมวิธีที่ API จัดการท่าทางสัมผัสบนแผนที่ ค่าที่อนุญาต:
  • "cooperative": เลื่อนกิจกรรมและใช้ 1 นิ้วแตะท่าทางสัมผัสเพื่อเลื่อนหน้าเว็บ และอย่าซูมหรือเลื่อนแผนที่ ใช้ 2 นิ้วแตะท่าทางสัมผัสเพื่อเลื่อนและซูมแผนที่ เลื่อนเหตุการณ์ด้วยแป้น Ctrl หรือแป้น ⌘ เพื่อซูมแผนที่
    ในโหมดนี้ แผนที่จะร่วมมือกับหน้าเว็บ
  • "greedy": ท่าทางสัมผัสด้วยการสัมผัสและการเลื่อนทั้งหมดจะเลื่อนหรือซูมแผนที่
  • "none": ไม่สามารถเลื่อนหรือซูมแผนที่ด้วยท่าทางสัมผัสของผู้ใช้
  • "auto": (ค่าเริ่มต้น) การจัดการด้วยท่าทางสัมผัสอาจเป็นแบบทำงานร่วมกันหรือแบบกลืนๆ ขึ้นอยู่กับว่าหน้านั้นสามารถเลื่อนได้หรือใน iframe
heading optional
ประเภท:  number optional
ทิศทางของภาพถ่ายทางอากาศในหน่วยองศาที่วัดตามเข็มนาฬิกาจากทิศเหนือทิศเหนือ จัดส่วนหัวให้อยู่ในมุมที่ใกล้เคียงที่สุดที่มีภาพให้
headingInteractionEnabled optional
ประเภท:  boolean optional
ค่าเริ่มต้น: false
แผนที่ควรอนุญาตให้ผู้ใช้ควบคุมทิศทางของกล้อง (การหมุน) ได้หรือไม่ ตัวเลือกนี้จะมีผลเมื่อแผนที่เป็นแผนที่เวกเตอร์เท่านั้น หากไม่ได้กำหนดเป็นโค้ด ระบบจะใช้การกำหนดค่าระบบคลาวด์สำหรับรหัสแผนที่ (หากมี)
isFractionalZoomEnabled optional
ประเภท:  boolean optional
ค่าเริ่มต้น: true สำหรับแผนที่เวกเตอร์และ false สำหรับแผนที่แรสเตอร์
แผนที่ควรอนุญาตให้ใช้ระดับการซูมส่วนย่อยหรือไม่ ฟัง isfractionalzoomenabled_changed เพื่อให้ทราบเมื่อตั้งค่าค่าเริ่มต้นไว้
keyboardShortcuts optional
ประเภท:  boolean optional
หาก false ป้องกันไม่ให้แป้นพิมพ์ควบคุมแผนที่ แป้นพิมพ์ลัดจะเปิดใช้โดยค่าเริ่มต้น
mapId optional
ประเภท:  string optional
รหัสแผนที่ของแผนที่ ไม่สามารถตั้งค่าหรือเปลี่ยนแปลงพารามิเตอร์นี้หลังจากสร้างอินสแตนซ์แล้ว คุณสามารถใช้ Map.DEMO_MAP_ID เพื่อลองใช้ฟีเจอร์ที่ต้องใช้รหัสแผนที่ แต่ไม่จําเป็นต้องเปิดใช้งานระบบคลาวด์
mapTypeControl optional
ประเภท:  boolean optional
สถานะเปิด/ปิดใช้เริ่มต้นของตัวควบคุมประเภทแผนที่
mapTypeControlOptions optional
ประเภท:  MapTypeControlOptions optional
ตัวเลือกการแสดงผลเริ่มต้นสำหรับการควบคุมประเภทแผนที่
mapTypeId optional
ประเภท:  MapTypeId|string optional
แผนที่ประเภทรหัสเริ่มต้น ค่าเริ่มต้นคือ ROADMAP
maxZoom optional
ประเภท:  number optional
ระดับการซูมสูงสุดที่จะแสดงบนแผนที่ หากละเว้นหรือตั้งค่าเป็น null จะมีการใช้การซูมสูงสุดจากประเภทแผนที่ปัจจุบันแทน ค่าการซูมที่ถูกต้องคือตัวเลขตั้งแต่ 0 ไปจนถึงระดับการซูมสูงสุดที่รองรับ
minZoom optional
ประเภท:  number optional
ระดับการซูมขั้นต่ำที่จะแสดงบนแผนที่ หากละเว้นหรือตั้งค่าเป็น null จะมีการใช้การซูมขั้นต่ำจากประเภทแผนที่ปัจจุบันแทน ค่าการซูมที่ถูกต้องคือตัวเลขตั้งแต่ 0 ไปจนถึงระดับการซูมสูงสุดที่รองรับ
noClear optional
ประเภท:  boolean optional
หากเป็น true โปรดอย่าล้างเนื้อหาของ div ของแผนที่
panControl optional
ประเภท:  boolean optional
สถานะเปิด/ปิดใช้ของการควบคุมการเลื่อน

panControlOptions optional
ประเภท:  PanControlOptions optional
ตัวเลือกการแสดงผลสำหรับการควบคุมการเลื่อน

renderingType optional
ประเภท:  RenderingType optional
ค่าเริ่มต้น: RenderingType.RASTER
ระบุว่าแผนที่ควรจะเป็นแผนที่แรสเตอร์หรือเวกเตอร์ ไม่สามารถตั้งค่าหรือเปลี่ยนแปลงพารามิเตอร์นี้หลังจากสร้างอินสแตนซ์แล้ว หากไม่ได้ตั้งค่า การกำหนดค่าระบบคลาวด์สำหรับรหัสแผนที่จะเป็นตัวกำหนดประเภทการแสดงผล (หากมี) โปรดทราบว่าแผนที่เวกเตอร์อาจใช้ไม่ได้กับอุปกรณ์และเบราว์เซอร์บางประเภท และแผนที่จะกลับไปเป็นแผนที่แรสเตอร์ตามความจำเป็น
restriction optional
ประเภท:  MapRestriction optional
กำหนดขอบเขตซึ่งจะจำกัดพื้นที่ของแผนที่ที่ผู้ใช้เข้าถึงได้ เมื่อตั้งค่า ผู้ใช้จะเลื่อนและซูมได้ต่อเมื่อมุมมองกล้องอยู่ภายในขอบเขตของขอบเขตเท่านั้น
rotateControl optional
ประเภท:  boolean optional
สถานะเปิด/ปิดใช้ของตัวควบคุมการหมุน
rotateControlOptions optional
ประเภท:  RotateControlOptions optional
ตัวเลือกการแสดงผลสำหรับการควบคุมการหมุน
scaleControl optional
ประเภท:  boolean optional
สถานะเปิด/ปิดใช้เริ่มต้นของการควบคุมการปรับขนาด
scaleControlOptions optional
ประเภท:  ScaleControlOptions optional
ตัวเลือกการแสดงผลเริ่มต้นสำหรับการควบคุมการปรับขนาด
scrollwheel optional
ประเภท:  boolean optional
หาก false ให้ปิดการซูมบนแผนที่โดยใช้ล้อเลื่อนของเมาส์ ล้อเลื่อนจะถูกเปิดใช้งานโดยค่าเริ่มต้น

หมายเหตุ: ไม่แนะนำพร็อพเพอร์ตี้นี้ หากต้องการปิดการซูมโดยใช้ล้อเลื่อน คุณสามารถใช้คุณสมบัติ gestureHandling และตั้งค่าเป็น "cooperative" หรือ "none"

streetView optional
ประเภท:  StreetViewPanorama optional
StreetViewPanorama เพื่อแสดงเมื่อมีการวางเพ็กแมน Street View ลงบนแผนที่ หากไม่ได้ระบุพาโนรามา ระบบจะใช้ StreetViewPanorama เริ่มต้นใน div ของแผนที่เมื่อมีการวางเพ็กแมน
streetViewControl optional
ประเภท:  boolean optional
สถานะเปิด/ปิดใช้เริ่มต้นของการควบคุมเพ็กแมนของ Street View ส่วนควบคุมนี้เป็นส่วนหนึ่งของ UI เริ่มต้น และควรตั้งค่าเป็น false เมื่อแสดงประเภทแผนที่ที่ถนน Street View ไม่ควรแสดง (เช่น แผนที่ประเภทที่ไม่ใช่ Earth)
streetViewControlOptions optional
ประเภท:  StreetViewControlOptions optional
ตัวเลือกการแสดงผลเริ่มต้นสำหรับการควบคุมเพ็กแมนของ Street View
styles optional
ประเภท:  Array<MapTypeStyle> optional
รูปแบบที่จะใช้กับแผนที่เริ่มต้นแต่ละประเภท โปรดทราบว่าสำหรับโหมด satellite/hybrid และ terrain รูปแบบเหล่านี้จะใช้กับป้ายกำกับและเรขาคณิตเท่านั้น คุณลักษณะนี้ไม่สามารถใช้ได้เมื่อใช้รหัสแผนที่หรือเมื่อใช้แผนที่เวกเตอร์ (ใช้การจัดรูปแบบแผนที่ในระบบคลาวด์แทน)
tilt optional
ประเภท:  number optional
สำหรับแผนที่เวกเตอร์ ให้กำหนดมุมของเหตุการณ์ของแผนที่ ค่าที่อนุญาตจะถูกจำกัดตามระดับการซูมของแผนที่ สำหรับแผนที่แรสเตอร์ ให้ควบคุมลักษณะการสลับอัตโนมัติสำหรับมุมของเหตุการณ์ของแผนที่ ค่าที่อนุญาตมีเพียง 0 และ 45 เท่านั้น ค่า 0 จะทำให้แผนที่ใช้มุมมองจากมุมสูง 0° เสมอ โดยไม่คำนึงถึงระดับการซูมและวิวพอร์ต ค่า 45 จะทำให้มุมเอียงสลับเป็น 45 โดยอัตโนมัติเมื่อใดก็ตามที่ภาพ 45° พร้อมใช้งานสำหรับระดับการซูมและวิวพอร์ตปัจจุบัน และสลับกลับไปเป็น 0 เมื่อไม่มีภาพ 45° (นี่คือลักษณะการทำงานเริ่มต้น) ภาพ 45° มีให้บริการสำหรับแผนที่ประเภท satellite และ hybrid เท่านั้น ภายในสถานที่บางแห่งและที่การซูมบางระดับ หมายเหตุ: getTilt จะแสดงผลมุมเอียงปัจจุบัน ไม่ใช่ค่าที่ตัวเลือกนี้ระบุ เนื่องจาก getTilt และตัวเลือกนี้อ้างอิงถึงสิ่งที่แตกต่างกัน โปรดอย่าbind()พร็อพเพอร์ตี้ tilt เพราะอาจทําให้เกิดผลลัพธ์ที่คาดเดาไม่ได้
tiltInteractionEnabled optional
ประเภท:  boolean optional
ค่าเริ่มต้น: false
แผนที่ควรอนุญาตให้ผู้ใช้ควบคุมการเอียงกล้องหรือไม่ ตัวเลือกนี้จะมีผลเมื่อแผนที่เป็นแผนที่เวกเตอร์เท่านั้น หากไม่ได้กำหนดเป็นโค้ด ระบบจะใช้การกำหนดค่าระบบคลาวด์สำหรับรหัสแผนที่ (หากมี)
zoom optional
ประเภท:  number optional
ระดับการซูมแผนที่เริ่มต้น ค่าการซูมที่ถูกต้องคือตัวเลขตั้งแต่ 0 ไปจนถึงระดับการซูมสูงสุดที่รองรับ ค่าการซูมที่ใหญ่ขึ้นจะสอดคล้องกับความละเอียดที่สูงขึ้น
zoomControl optional
ประเภท:  boolean optional
สถานะเปิด/ปิดใช้ของตัวควบคุมการซูม
zoomControlOptions optional
ประเภท:  ZoomControlOptions optional
ตัวเลือกการแสดงผลสำหรับการควบคุมการซูม

คลาส MapElement

google.maps.MapElement ชั้นเรียน

MapElement เป็นคลาสย่อย HTMLElement สำหรับการแสดงผลแผนที่ หลังจากโหลดไลบรารี maps คุณจะสร้างแผนที่ใน HTML ได้ ตัวอย่างเช่น

<gmp-map center="37.4220656,-122.0840897" zoom="10" map-id="DEMO_MAP_ID">
  <button slot="control-block-start-inline-end">Custom Control</button>
</gmp-map>

ภายในจะใช้ Map ซึ่งเข้าถึงได้ด้วยพร็อพเพอร์ตี้ innerMap

องค์ประกอบที่กำหนดเอง:
<gmp-map center="lat,lng" heading-interaction-disabled map-id="string" rendering-type="vector" tilt-interaction-disabled zoom="number"></gmp-map>

ชั้นเรียนนี้ขยายระยะเวลาถึง HTMLElement

ชั้นเรียนนี้ใช้ MapElementOptions

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

MapElement
MapElement([options])
พารามิเตอร์: 
center
ประเภท:  LatLng|LatLngLiteral optional
ละติจูด/ลองจิจูดกึ่งกลางของแผนที่
แอตทริบิวต์ HTML:
  • <gmp-map center="lat,lng"></gmp-map>
headingInteractionDisabled
ประเภท:  boolean optional
ค่าเริ่มต้น: false
แผนที่ควรอนุญาตให้ผู้ใช้ควบคุมทิศทางของกล้อง (การหมุน) ได้หรือไม่ ตัวเลือกนี้จะมีผลเมื่อแผนที่เป็นแผนที่เวกเตอร์เท่านั้น หากไม่ได้กำหนดเป็นโค้ด ระบบจะใช้การกำหนดค่าระบบคลาวด์สำหรับรหัสแผนที่ (หากมี)
แอตทริบิวต์ HTML:
  • <gmp-map heading-interaction-disabled></gmp-map>
innerMap
ประเภท:  Map
การอ้างอิงไปยัง Map ที่ MapElement ใช้ภายใน
mapId
ประเภท:  string optional
รหัสแผนที่ของแผนที่ ไม่สามารถตั้งค่าหรือเปลี่ยนแปลงพารามิเตอร์นี้หลังจากสร้างอินสแตนซ์แล้ว คุณสามารถใช้ Map.DEMO_MAP_ID เพื่อลองใช้ฟีเจอร์ที่ต้องใช้รหัสแผนที่ แต่ไม่จําเป็นต้องเปิดใช้งานระบบคลาวด์
แอตทริบิวต์ HTML:
  • <gmp-map map-id="string"></gmp-map>
renderingType
ประเภท:  RenderingType optional
ค่าเริ่มต้น: RenderingType.VECTOR
ระบุว่าแผนที่ควรจะเป็นแผนที่แรสเตอร์หรือเวกเตอร์ ไม่สามารถตั้งค่าหรือเปลี่ยนแปลงพารามิเตอร์นี้หลังจากสร้างอินสแตนซ์แล้ว หากไม่ได้ตั้งค่า การกำหนดค่าระบบคลาวด์สำหรับรหัสแผนที่จะเป็นตัวกำหนดประเภทการแสดงผล (หากมี) โปรดทราบว่าแผนที่เวกเตอร์อาจใช้ไม่ได้กับอุปกรณ์และเบราว์เซอร์บางประเภท และแผนที่จะกลับไปเป็นแผนที่แรสเตอร์ตามความจำเป็น
แอตทริบิวต์ HTML:
  • <gmp-map rendering-type="vector"></gmp-map>
  • <gmp-map rendering-type="raster"></gmp-map>
tiltInteractionDisabled
ประเภท:  boolean optional
ค่าเริ่มต้น: false
แผนที่ควรอนุญาตให้ผู้ใช้ควบคุมการเอียงกล้องหรือไม่ ตัวเลือกนี้จะมีผลเมื่อแผนที่เป็นแผนที่เวกเตอร์เท่านั้น หากไม่ได้กำหนดเป็นโค้ด ระบบจะใช้การกำหนดค่าระบบคลาวด์สำหรับรหัสแผนที่ (หากมี)
แอตทริบิวต์ HTML:
  • <gmp-map tilt-interaction-disabled></gmp-map>
zoom
ประเภท:  number optional
ระดับการซูมของแผนที่ ค่าการซูมที่ถูกต้องคือตัวเลขตั้งแต่ 0 ไปจนถึงระดับการซูมสูงสุดที่รองรับ ค่าการซูมที่ใหญ่ขึ้นจะสอดคล้องกับความละเอียดที่สูงขึ้น
แอตทริบิวต์ HTML:
  • <gmp-map zoom="number"></gmp-map>
control-block-end-inline-center
วางองค์ประกอบที่เป็นแบบช่องไว้ในตำแหน่ง ControlPosition.BLOCK_END_INLINE_CENTER
control-block-end-inline-end
วางองค์ประกอบที่เป็นแบบช่องไว้ในตำแหน่ง ControlPosition.BLOCK_END_INLINE_END
control-block-end-inline-start
วางองค์ประกอบที่เป็นแบบช่องไว้ในตำแหน่ง ControlPosition.BLOCK_END_INLINE_START
control-block-start-inline-center
วางองค์ประกอบที่เป็นแบบช่องไว้ในตำแหน่ง ControlPosition.BLOCK_START_INLINE_CENTER
control-block-start-inline-end
วางองค์ประกอบที่เป็นแบบช่องไว้ในตำแหน่ง ControlPosition.BLOCK_START_INLINE_END
control-block-start-inline-start
วางองค์ประกอบที่เป็นแบบช่องไว้ในตำแหน่ง ControlPosition.BLOCK_START_INLINE_START
control-inline-end-block-center
วางองค์ประกอบที่เป็นแบบช่องไว้ในตำแหน่ง ControlPosition.INLINE_END_BLOCK_CENTER
control-inline-end-block-end
วางองค์ประกอบที่เป็นแบบช่องไว้ในตำแหน่ง ControlPosition.INLINE_END_BLOCK_END
control-inline-end-block-start
วางองค์ประกอบที่เป็นแบบช่องไว้ในตำแหน่ง ControlPosition.INLINE_END_BLOCK_START
control-inline-start-block-center
วางองค์ประกอบที่เป็นแบบช่องไว้ในตำแหน่ง ControlPosition.INLINE_START_BLOCK_CENTER
control-inline-start-block-end
วางองค์ประกอบที่เป็นแบบช่องไว้ในตำแหน่ง ControlPosition.INLINE_START_BLOCK_END
control-inline-start-block-start
วางองค์ประกอบที่เป็นแบบช่องไว้ในตำแหน่ง ControlPosition.INLINE_START_BLOCK_START
default
คุณจะสร้างคอมโพเนนต์ที่ใช้ซ้ำได้รอบๆ คอมโพเนนต์เว็บ JavaScript ของ Maps เช่น AdvancedMarkerElement ได้โดยใช้องค์ประกอบที่กำหนดเอง โดยค่าเริ่มต้น องค์ประกอบที่กำหนดเองใดๆ ที่เพิ่มลงใน MapElement โดยตรงจะได้รับการแบ่งช่องและแสดงผลใน MapPanes.overlayMouseTarget อย่างไรก็ตาม คอมโพเนนต์เว็บ Maps JavaScript API สามารถใส่ลงในช่องภายในของ MapElement อีกครั้งได้
BetaaddEventListener
addEventListener(type, listener[, options])
พารามิเตอร์: 
  • typestring สตริงที่ตรงตามตัวพิมพ์เล็กและตัวพิมพ์ใหญ่ซึ่งแสดงประเภทเหตุการณ์ที่ต้องการรับ
  • listenerEventListener|EventListenerObject ออบเจ็กต์ที่ได้รับการแจ้งเตือน ต้องเป็นฟังก์ชันหรือออบเจ็กต์ที่มีเมธอด ManageEvent
  • optionsboolean|AddEventListenerOptions optional ดูตัวเลือก เหตุการณ์ที่กำหนดเองรองรับเฉพาะ capture และ passive เท่านั้น
ค่าที่ส่งคืน:  void
ตั้งค่าฟังก์ชันที่จะถูกเรียกเมื่อใดก็ตามที่มีการส่งเหตุการณ์ที่ระบุไปยังเป้าหมาย โปรดดู addEventListener
BetaremoveEventListener
removeEventListener(type, listener[, options])
พารามิเตอร์: 
  • typestring สตริงที่ระบุประเภทของเหตุการณ์ที่จะนำ Listener เหตุการณ์ออก
  • listenerEventListener|EventListenerObject Listener เหตุการณ์ของตัวแฮนเดิลเหตุการณ์ที่จะนำออกจากเป้าหมายเหตุการณ์
  • optionsboolean|EventListenerOptions optional ดูตัวเลือก
ค่าที่ส่งคืน:  void
นำ Listener เหตุการณ์ที่ลงทะเบียนกับ addEventListener ก่อนหน้านี้ออกจากเป้าหมาย โปรดดู removeEventListener
gmp-zoomchange
function(event)
อาร์กิวเมนต์: 
เหตุการณ์นี้จะเกิดขึ้นเมื่อคุณสมบัติการซูมแผนที่มีการเปลี่ยนแปลง

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

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

ออบเจ็กต์ MapElementOptions ซึ่งใช้กำหนดคุณสมบัติที่สามารถตั้งค่าใน MapElement

center optional
ประเภท:  LatLng|LatLngLiteral optional
headingInteractionDisabled optional
ประเภท:  boolean optional
mapId optional
ประเภท:  string optional
renderingType optional
ประเภท:  RenderingType optional
tiltInteractionDisabled optional
ประเภท:  boolean optional
zoom optional
ประเภท:  number optional

คลาส ZoomChangeEvent

google.maps.ZoomChangeEvent ชั้นเรียน

เหตุการณ์นี้สร้างขึ้นจากการตรวจสอบการเปลี่ยนแปลงการซูม

ชั้นเรียนนี้ขยายระยะเวลาถึง Event

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

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

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

MapTypeStyle เป็นชุดตัวเลือกและเครื่องมือจัดสไตล์ที่กำหนดวิธีจัดรูปแบบแผนที่ ตัวเลือกจะระบุคุณลักษณะแผนที่และ/หรือองค์ประกอบที่ควรได้รับผลกระทบ และการจัดรูปแบบจะระบุวิธีการแก้ไขคุณลักษณะและองค์ประกอบเหล่านั้น โปรดดูรายละเอียดที่ข้อมูลอ้างอิงของรูปแบบ

stylers
ประเภท:  Array<Object>
กฎของรูปแบบที่จะนำไปใช้กับฟีเจอร์และองค์ประกอบแผนที่ที่เลือกไว้ จะมีการใช้กฎตามลำดับที่คุณระบุในอาร์เรย์นี้ ดูหลักเกณฑ์เกี่ยวกับการใช้งานและค่าที่อนุญาตได้ที่ข้อมูลอ้างอิงรูปแบบ
elementType optional
ประเภท:  string optional
องค์ประกอบที่ควรใช้การจัดสไตล์ องค์ประกอบคือภาพของจุดสนใจบนแผนที่ ตัวอย่าง: ป้ายกำกับ ไอคอน เส้น หรือการเติมสีที่ใช้กับเรขาคณิต และอื่นๆ ไม่บังคับ หากไม่ได้ระบุ elementType ระบบจะถือว่าค่านี้เป็น 'all' โปรดดูรายละเอียดการใช้งานและค่าที่อนุญาตที่ข้อมูลอ้างอิงรูปแบบ
featureType optional
ประเภท:  string optional
ฟีเจอร์หรือกลุ่มฟีเจอร์ที่ควรใช้การจัดสไตล์ ไม่บังคับ หากไม่ได้ระบุ featureType ระบบจะถือว่าค่านี้เป็น 'all' โปรดดูรายละเอียดการใช้งานและค่าที่อนุญาตที่ข้อมูลอ้างอิงรูปแบบ

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

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

ออบเจ็กต์นี้จะถูกส่งคืนจากเหตุการณ์ต่างๆ เกี่ยวกับเมาส์บนแผนที่และการวางซ้อน และประกอบด้วยฟิลด์ทั้งหมดที่แสดงด้านล่าง

domEvent
เหตุการณ์ DOM ดั้งเดิมที่เกี่ยวข้อง นักพัฒนาแอปไม่ควรเชื่อถือพร็อพเพอร์ตี้ target, currentTarget, relatedTarget และ path ที่กำหนดไว้และสอดคล้องกัน นักพัฒนาซอฟต์แวร์ไม่ควรอาศัยโครงสร้าง DOM ของการใช้งานภายในของ Maps API ด้วย เนื่องจากการแมปเหตุการณ์ภายใน domEvent อาจมีความหมายต่างจาก MapMouseEvent (เช่น "การคลิก" ของ MapMouseEvent อาจมี domEvent ประเภท KeyboardEvent)
latLng optional
ประเภท:  LatLng optional
ละติจูด/ลองจิจูดที่ต่ำกว่าเคอร์เซอร์เมื่อเกิดเหตุการณ์ขึ้น
stop
stop()
พารามิเตอร์: ไม่มี
ค่าที่ส่งคืน:  void
ป้องกันไม่ให้เหตุการณ์นี้เผยแพร่ต่อไป

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

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

ระบบจะส่งออบเจ็กต์นี้ในเหตุการณ์เมื่อผู้ใช้คลิกไอคอนบนแผนที่ รหัสสถานที่ของสถานที่นี้จะจัดเก็บอยู่ในสมาชิก PlaceId เพื่อป้องกันไม่ให้หน้าต่างข้อมูลเริ่มต้นปรากฏขึ้น ให้เรียกใช้เมธอด Stop() ในเหตุการณ์นี้เพื่อป้องกันไม่ให้มีการเผยแพร่ ดูข้อมูลเพิ่มเติมเกี่ยวกับรหัสสถานที่ในคู่มือนักพัฒนาซอฟต์แวร์ Places API

อินเทอร์เฟซนี้ขยายไปถึง MapMouseEvent

placeId optional
ประเภท:  string optional
รหัสของสถานที่ที่มีการคลิก โดยรหัสสถานที่นี้สามารถใช้เพื่อค้นหาข้อมูลเพิ่มเติมเกี่ยวกับองค์ประกอบที่มีการคลิก

ดูข้อมูลเพิ่มเติมเกี่ยวกับรหัสสถานที่ในคู่มือนักพัฒนาซอฟต์แวร์ Places API

รับค่าเดิม: domEvent, latLng
รับค่าเดิม: stop

ค่าคงที่ MapTypeId

ค่าคงที่ google.maps.MapTypeId

ตัวระบุสำหรับ MapType ทั่วไป ระบุรายการเหล่านี้ตามค่า หรือใช้ชื่อค่าคงที่ เช่น 'satellite' หรือ google.maps.MapTypeId.SATELLITE

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

HYBRID แผนที่ประเภทนี้แสดงเลเยอร์ถนนสายหลักแบบโปร่งใสบนภาพถ่ายจากดาวเทียม
ROADMAP แผนที่ประเภทนี้แสดงแผนที่ถนนตามปกติ
SATELLITE แผนที่ประเภทนี้จะแสดงภาพถ่ายจากดาวเทียม
TERRAIN แผนที่ประเภทนี้แสดงแผนที่ที่มีลักษณะทางกายภาพ เช่น ภูมิประเทศและพืชพรรณ

คลาส MapTypeRegistry

google.maps.MapTypeRegistry ชั้นเรียน

รีจิสทรีสำหรับอินสแตนซ์ MapType ซึ่งคีย์ด้วยรหัส MapType

ชั้นเรียนนี้ขยายระยะเวลาถึง MVCObject

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

MapTypeRegistry
MapTypeRegistry()
พารามิเตอร์: ไม่มี
MapTypeRegistry เก็บคอลเล็กชันประเภทแผนที่ที่กำหนดเองซึ่งแผนที่ใช้งานได้ เช่น API จะปรึกษารีจิสทรีนี้เมื่อระบุรายการประเภทแผนที่ที่ใช้ได้ภายในการควบคุม เป็นต้น
set
set(id, mapType)
พารามิเตอร์: 
  • idstring ตัวระบุของ MapType ที่จะเพิ่มลงในรีจิสทรี
  • mapTypeMapType|* ออบเจ็กต์ MapType ที่จะเพิ่มลงในรีจิสทรี
ผลลัพธ์: ไม่มี
ตั้งค่ารีจิสทรีเพื่อเชื่อมโยงตัวระบุสตริงที่ส่งผ่านกับ MapType ที่ส่งผ่าน
รับค่าเดิม: addListener, bindTo, get, notify, setValues, unbind, unbindAll

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

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

ข้อจำกัดที่นำไปใช้กับแผนที่ได้ วิวพอร์ตของแผนที่จะไม่เกินข้อจำกัดเหล่านี้

latLngBounds
ประเภท:  LatLngBounds|LatLngBoundsLiteral
เมื่อตั้งค่าแล้ว ผู้ใช้จะเลื่อนและซูมได้ภายในขอบเขตที่กําหนดเท่านั้น ขอบเขตสามารถจำกัดทั้งลองจิจูดและละติจูด หรือจำกัดละติจูดเท่านั้นก็ได้ สำหรับขอบเขตละติจูดเท่านั้น ให้ใช้ลองจิจูดตะวันตกและตะวันออกที่ -180 และ 180 ตามลำดับ เช่น latLngBounds: {north: northLat, south: southLat, west: -180, east: 180}
strictBounds optional
ประเภท:  boolean optional
คุณกำหนดขอบเขตได้มากขึ้นโดยการตั้งค่าแฟล็ก strictBounds เป็น true ซึ่งช่วยลดระยะห่างที่ผู้ใช้ซูมออกได้ เพื่อให้มั่นใจว่าทุกอย่างที่อยู่นอกขอบเขตที่จำกัดจะยังคงซ่อนอยู่ ค่าเริ่มต้นคือ false ซึ่งหมายความว่าผู้ใช้จะซูมออกได้จนกว่าพื้นที่ที่จํากัดทั้งหมดจะอยู่ในมุมมอง ซึ่งอาจรวมพื้นที่นอกพื้นที่ที่จํากัดด้วย

คลาส TrafficLayer

google.maps.TrafficLayer ชั้นเรียน

เลเยอร์การจราจร

ชั้นเรียนนี้ขยายระยะเวลาถึง MVCObject

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

TrafficLayer
TrafficLayer([opts])
พารามิเตอร์: 
เลเยอร์ที่แสดงการจราจรบนท้องถนนในปัจจุบัน
getMap
getMap()
พารามิเตอร์: ไม่มี
ค่าที่ส่งคืน:  Map
แสดงผลแผนที่ที่แสดงเลเยอร์นี้
setMap
setMap(map)
พารามิเตอร์: 
ผลลัพธ์: ไม่มี
แสดงผลเลเยอร์บนแผนที่ที่ระบุ หากแผนที่ได้รับการตั้งค่าเป็น null เลเยอร์จะถูกลบออก
setOptions
setOptions(options)
พารามิเตอร์: 
ผลลัพธ์: ไม่มี
รับค่าเดิม: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll

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

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

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

autoRefresh optional
ประเภท:  boolean optional
ค่าเริ่มต้น: true
เลเยอร์การจราจรจะรีเฟรชด้วยข้อมูลที่อัปเดตโดยอัตโนมัติหรือไม่
map optional
ประเภท:  Map optional
แผนที่ที่จะแสดงเลเยอร์การจราจร

คลาส TransitLayer

google.maps.TransitLayer ชั้นเรียน

เลเยอร์การเดินทาง

ชั้นเรียนนี้ขยายระยะเวลาถึง MVCObject

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

TransitLayer
TransitLayer()
พารามิเตอร์: ไม่มี
เลเยอร์ที่แสดงเส้นทางขนส่งสาธารณะ
getMap
getMap()
พารามิเตอร์: ไม่มี
ค่าที่ส่งคืน:  Map
แสดงผลแผนที่ที่แสดงเลเยอร์นี้
setMap
setMap(map)
พารามิเตอร์: 
ผลลัพธ์: ไม่มี
แสดงผลเลเยอร์บนแผนที่ที่ระบุ หากแผนที่ได้รับการตั้งค่าเป็น null เลเยอร์จะถูกลบออก
รับค่าเดิม: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll

คลาส BicyclingLayer

google.maps.BicyclingLayer ชั้นเรียน

เลเยอร์แสดงเลนจักรยานและเส้นทาง

ชั้นเรียนนี้ขยายระยะเวลาถึง MVCObject

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

BicyclingLayer
BicyclingLayer()
พารามิเตอร์: ไม่มี
เลเยอร์ที่แสดงเลนจักรยานและเส้นทาง ตลอดจนลดระดับถนนขนาดใหญ่
getMap
getMap()
พารามิเตอร์: ไม่มี
ค่าที่ส่งคืน:  Map
แสดงผลแผนที่ที่แสดงเลเยอร์นี้
setMap
setMap(map)
พารามิเตอร์: 
ผลลัพธ์: ไม่มี
แสดงผลเลเยอร์บนแผนที่ที่ระบุ หากแผนที่ได้รับการตั้งค่าเป็น null เลเยอร์จะถูกลบออก
รับค่าเดิม: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll

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

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

ใช้สำหรับตั้งค่าตัวเลือกกล้องของแผนที่

center optional
ประเภท:  LatLngLiteral|LatLng optional
heading optional
ประเภท:  number optional
tilt optional
ประเภท:  number optional
zoom optional
ประเภท:  number optional

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

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

มีจุด 4 จุดที่ระบุรูปหลายเหลี่ยม 4 ด้านซึ่งเป็นพื้นที่ที่มองเห็นได้ของแผนที่ บนแผนที่เวกเตอร์ รูปหลายเหลี่ยมนี้อาจเป็นสี่เหลี่ยมคางหมูแทนสี่เหลี่ยมผืนผ้า เมื่อแผนที่เวกเตอร์มีการเอียง

farLeft
ประเภท:  LatLng
farRight
ประเภท:  LatLng
latLngBounds
ประเภท:  LatLngBounds
กรอบล้อมรอบที่เล็กที่สุดที่รวมพื้นที่ที่มองเห็นได้
nearLeft
ประเภท:  LatLng
nearRight
ประเภท:  LatLng

ค่าคงที่ RenderingType

ค่าคงที่ google.maps.RenderingType

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

RASTER ระบุว่าแผนที่เป็นแผนที่แรสเตอร์
UNINITIALIZED ระบุว่ายังไม่รู้จักแผนที่ว่าเป็นเวกเตอร์หรือแรสเตอร์ เนื่องจากแผนที่ยังเริ่มต้นไม่เสร็จ
VECTOR ระบุว่าแผนที่นั้นเป็นแผนที่เวกเตอร์

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

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

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

isAdvancedMarkersAvailable optional
ประเภท:  boolean optional
หากเป็น "จริง" แผนที่นี้ได้รับการกำหนดค่าอย่างเหมาะสมเพื่อให้สามารถใช้เครื่องหมายขั้นสูงได้ โปรดทราบว่าคุณยังคงต้องนำเข้าไลบรารี marker เพื่อใช้เครื่องหมายขั้นสูง ดูข้อมูลเพิ่มเติมได้ที่ https://goo.gle/gmp-isAdvancedMarkersAvailable
isDataDrivenStylingAvailable optional
ประเภท:  boolean optional
หาก "จริง" ระบบจะกำหนดค่าแผนที่นี้อย่างเหมาะสมเพื่อให้ใช้การจัดรูปแบบจากข้อมูลสำหรับ FeatureLayer ได้อย่างน้อย 1 เลเยอร์ ดูข้อมูลเพิ่มเติมได้ที่ https://goo.gle/gmp-data-driven-styling และ https://goo.gle/gmp-FeatureLayerIsAvailable
isWebGLOverlayViewAvailable optional
ประเภท:  boolean optional
หากจริง แผนที่นี้มีการกำหนดค่าอย่างถูกต้องเพื่ออนุญาตให้ใช้ WebGLOverlayView