Maps

MapElement class

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 ซึ่งเข้าถึงได้ด้วยพร็อพเพอร์ตี้ MapElement.innerMap

องค์ประกอบที่กำหนดเอง:
<gmp-map center="lat,lng" heading-interaction-disabled internal-usage-attribution-ids="id1 id2" 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 ใช้ภายใน
internalUsageAttributionIds
ประเภท:  Iterable<string> optional
ค่าเริ่มต้น: null
เพิ่มรหัสการระบุแหล่งที่มาของการใช้งานลงในตัวเริ่มต้น ซึ่งจะช่วยให้ Google เข้าใจว่าไลบรารีและตัวอย่างใดมีประโยชน์ต่อนักพัฒนาแอป เช่น การใช้งานไลบรารีการจัดกลุ่มเครื่องหมาย หากต้องการเลือกไม่ส่งรหัสการระบุแหล่งที่มาของการใช้งาน คุณสามารถลบพร็อพเพอร์ตี้นี้หรือแทนที่ค่าด้วยสตริงว่างได้ ระบบจะส่งเฉพาะค่าที่ไม่ซ้ำกัน ระบบอาจไม่สนใจการเปลี่ยนแปลงค่านี้หลังจากสร้างอินสแตนซ์
แอตทริบิวต์ HTML:
  • <gmp-map internal-usage-attribution-ids="id1 id2"></gmp-map>
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 โดยใช้ Custom Elements โดยค่าเริ่มต้น องค์ประกอบที่กำหนดเองซึ่งเพิ่มลงใน MapElement โดยตรงจะได้รับการจัดช่องและแสดงผลใน MapPanes.overlayMouseTarget อย่างไรก็ตาม คุณอาจเปลี่ยนช่องของคอมโพเนนต์เว็บของ Maps JavaScript API ไปยังช่องภายในของ MapElement ได้
BetaaddEventListener
addEventListener(type, listener[, options])
พารามิเตอร์: 
  • type:  string สตริงที่คำนึงถึงตัวพิมพ์เล็กและตัวพิมพ์ใหญ่ซึ่งแสดงถึงประเภทเหตุการณ์ที่จะรับฟัง
  • listener:  EventListener|EventListenerObject ออบเจ็กต์ที่ได้รับการแจ้งเตือน ซึ่งต้องเป็นฟังก์ชันหรือออบเจ็กต์ที่มีเมธอด handleEvent
  • options:  boolean|AddEventListenerOptions optional ดูตัวเลือก เหตุการณ์ที่กำหนดเองรองรับเฉพาะ capture และ passive
ค่าที่ส่งคืน:  void
ตั้งค่าฟังก์ชันที่จะเรียกใช้เมื่อใดก็ตามที่มีการส่งเหตุการณ์ที่ระบุไปยังเป้าหมาย ดู addEventListener
BetaremoveEventListener
removeEventListener(type, listener[, options])
พารามิเตอร์: 
  • type:  string สตริงที่ระบุประเภทของเหตุการณ์ที่จะนำเครื่องมือฟังเหตุการณ์ออก
  • listener:  EventListener|EventListenerObject Listener เหตุการณ์ของตัวแฮนเดิลเหตุการณ์ที่จะนำออกจากเป้าหมายเหตุการณ์
  • options:  boolean|EventListenerOptions optional ดูตัวเลือก
ค่าที่ส่งคืน:  void
นำ Listener เหตุการณ์ที่ลงทะเบียนไว้ก่อนหน้านี้ด้วย addEventListener ออกจากเป้าหมาย ดู removeEventListener
gmp-zoomchange
function(event)
อาร์กิวเมนต์: 
เหตุการณ์นี้จะเริ่มทำงานเมื่อพร็อพเพอร์ตี้การซูมแผนที่เปลี่ยนแปลง

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

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

ออบเจ็กต์ MapElementOptions ที่ใช้กำหนดพร็อพเพอร์ตี้ที่ตั้งค่าใน MapElement ได้
center optional
ประเภท:  LatLng|LatLngLiteral optional
ดูMapElement.center
headingInteractionDisabled optional
ประเภท:  boolean optional
ดูMapElement.headingInteractionDisabled
internalUsageAttributionIds optional
ประเภท:  Iterable<string> optional
ดูMapElement.internalUsageAttributionIds
mapId optional
ประเภท:  string optional
ดูMapElement.mapId
renderingType optional
ประเภท:  RenderingType optional
ดูMapElement.renderingType
tiltInteractionDisabled optional
ประเภท:  boolean optional
ดูMapElement.tiltInteractionDisabled
zoom optional
ประเภท:  number optional
ดูMapElement.zoom

ZoomChangeEvent class

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

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

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

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

Map class

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

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

เข้าถึงได้โดยโทรไปที่ const {Map} = await google.maps.importLibrary("maps")
ดูไลบรารีใน Maps JavaScript API
Map
Map(mapDiv[, opts])
พารามิเตอร์: 
  • mapDiv:  HTMLElement แผนที่จะแสดงผลเพื่อเติมองค์ประกอบนี้
  • opts:  MapOptions optional ตัวเลือก
สร้างแผนที่ใหม่ภายในคอนเทนเนอร์ HTML ที่ระบุ ซึ่งโดยปกติจะเป็นองค์ประกอบ DIV
DEMO_MAP_ID รหัสแผนที่ที่ใช้กับตัวอย่างโค้ดที่ต้องใช้รหัสแผนที่ได้ รหัสแผนที่นี้ไม่ได้มีไว้สำหรับการใช้งานในแอปพลิเคชันที่ใช้งานจริง และใช้กับฟีเจอร์ที่ต้องมีการกำหนดค่าในระบบคลาวด์ไม่ได้ (เช่น การจัดรูปแบบ Cloud)
controls
ประเภท:  Array<MVCArray<HTMLElement>>
ตัวควบคุมเพิ่มเติมที่จะแนบกับแผนที่ หากต้องการเพิ่มตัวควบคุมลงในแผนที่ ให้เพิ่ม <div> ของตัวควบคุมลงใน MVCArray ที่สอดคล้องกับ ControlPosition ที่ควรแสดง
data
ประเภท:  Data
อินสแตนซ์ของ Data ที่เชื่อมโยงกับแผนที่ เพิ่มฟีเจอร์ลงในDataออบเจ็กต์นี้เพื่อแสดงฟีเจอร์เหล่านั้นในแผนที่นี้อย่างสะดวก
mapTypes
ประเภท:  MapTypeRegistry
รีจิสทรีของอินสแตนซ์ MapType ตามรหัสสตริง
overlayMapTypes
ประเภท:  MVCArray<MapType optional>
ประเภทแผนที่เพิ่มเติมที่จะซ้อนทับ ประเภทแผนที่ซ้อนทับจะแสดงอยู่เหนือแผนที่ฐานที่แนบไว้ ตามลำดับที่ปรากฏในอาร์เรย์ overlayMapTypes (การซ้อนทับที่มีค่าดัชนีสูงกว่าจะแสดงอยู่หน้าการซ้อนทับที่มีค่าดัชนีต่ำกว่า)
fitBounds
fitBounds(bounds[, padding])
พารามิเตอร์: 
  • bounds:  LatLngBounds|LatLngBoundsLiteral ขอบเขตที่จะแสดง
  • padding:  number|Padding optional ระยะห่างในหน่วยพิกเซล ขอบเขตจะพอดีกับส่วนของแผนที่ที่เหลืออยู่หลังจากนำระยะขอบออก ค่าตัวเลขจะทำให้เกิดระยะห่างจากขอบเท่ากันทั้ง 4 ด้าน ระบุ 0 ที่นี่เพื่อให้ fitBounds เป็น Idempotent ในผลลัพธ์ของ getBounds
ค่าที่ส่งคืน: ไม่มี
ตั้งค่าวิวพอร์ตให้มีขอบเขตที่ระบุ
หมายเหตุ: เมื่อตั้งค่าแผนที่เป็น display: none ฟังก์ชัน fitBounds จะอ่านขนาดของแผนที่เป็น 0x0 และจึงไม่ดำเนินการใดๆ หากต้องการเปลี่ยนวิวพอร์ตขณะที่ซ่อนแผนที่ ให้ตั้งค่าแผนที่เป็น visibility: hidden เพื่อให้มั่นใจว่า div ของแผนที่มีขนาดจริง สำหรับแผนที่เวกเตอร์ วิธีนี้จะตั้งค่าการเอียงและการวางแนวของแผนที่เป็นค่าเริ่มต้น 0 การเรียกใช้วิธีนี้อาจทำให้เกิดภาพเคลื่อนไหวที่ราบรื่นเมื่อแผนที่เลื่อนและซูมเพื่อให้พอดีกับขอบเขต วิธีการนี้จะเคลื่อนไหวหรือไม่ขึ้นอยู่กับฮิวริสติกภายใน
getBounds
getBounds()
พารามิเตอร์: ไม่มี
ค่าที่ส่งคืน:  LatLngBounds|undefined ขอบเขตละติจูด/ลองจิจูดของวิวพอร์ตปัจจุบัน
แสดงผลขอบเขตละติจูด/ลองจิจูดของวิวพอร์ตปัจจุบัน หากมองเห็นสำเนาของโลกมากกว่า 1 รายการ ขอบเขตจะอยู่ในช่วงลองจิจูดตั้งแต่ -180 ถึง 180 องศา หากยังไม่ได้เริ่มต้นแผนที่ หรือยังไม่ได้ตั้งค่ากึ่งกลางและการซูม ผลลัพธ์จะเป็น undefined สำหรับแผนที่เวกเตอร์ที่มีการเอียงหรือการวางแนวที่ไม่ใช่ 0 ขอบเขตละติจูด/ลองจิจูดที่แสดงผลจะแสดงถึงกรอบล้อมรอบที่เล็กที่สุดซึ่งรวมถึงภูมิภาคที่มองเห็นได้ของวิวพอร์ตของแผนที่ ดู MapCanvasProjection.getVisibleRegion เพื่อรับภูมิภาคที่มองเห็นได้ที่แน่นอนของวิวพอร์ตของแผนที่
getCenter
getCenter()
พารามิเตอร์: ไม่มี
ค่าที่ส่งคืน:  LatLng|undefined
แสดงตำแหน่งที่แสดงที่กึ่งกลางของแผนที่ โปรดทราบว่าLatLngออบเจ็กต์นี้ไม่ได้ห่อหุ้ม ดูข้อมูลเพิ่มเติมได้ที่ LatLng หากไม่ได้ตั้งค่ากึ่งกลางหรือขอบเขต ผลลัพธ์จะเป็น undefined
getClickableIcons
getClickableIcons()
พารามิเตอร์: ไม่มี
ค่าที่ส่งคืน:  boolean|undefined
แสดงผลความสามารถในการคลิกของไอคอนแผนที่ ไอคอนแผนที่แสดงจุดที่น่าสนใจ หรือที่เรียกว่า POI หากค่าที่แสดงคือ true แสดงว่าไอคอนคลิกได้บนแผนที่
BetagetDatasetFeatureLayer
getDatasetFeatureLayer(datasetId)
พารามิเตอร์: 
  • datasetId:  string
ค่าที่ส่งคืน:  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
แสดงว่าได้เปิดใช้การโต้ตอบกับส่วนหัวหรือไม่ ตัวเลือกนี้จะมีผลเมื่อแผนที่เป็นแผนที่เวกเตอร์เท่านั้น หากไม่ได้ตั้งค่าในโค้ด ระบบจะใช้การกำหนดค่าในระบบคลาวด์สำหรับรหัสแผนที่ (หากมี)
getInternalUsageAttributionIds
getInternalUsageAttributionIds()
พารามิเตอร์: ไม่มี
ค่าที่ส่งคืน:  Iterable<string>|null
แสดงรายการรหัสการระบุแหล่งที่มาของการใช้งาน ซึ่งช่วยให้ Google เข้าใจว่าไลบรารีและตัวอย่างใดมีประโยชน์ต่อนักพัฒนาแอป เช่น การใช้งานไลบรารีการจัดกลุ่มเครื่องหมาย
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)
พารามิเตอร์: 
  • x:  number จำนวนพิกเซลที่จะย้ายแผนที่ในทิศทาง x
  • y:  number จำนวนพิกเซลที่จะเลื่อนแผนที่ในทิศทาง y
ค่าที่ส่งคืน: ไม่มี
เปลี่ยนศูนย์กลางของแผนที่ตามระยะทางที่ระบุเป็นพิกเซล หากระยะทางน้อยกว่าทั้งความกว้างและความสูงของแผนที่ การเปลี่ยนจะเคลื่อนไหวอย่างราบรื่น โปรดทราบว่าระบบพิกัดแผนที่จะเพิ่มขึ้นจากตะวันตกไปตะวันออก (สำหรับค่า x) และจากเหนือไปใต้ (สำหรับค่า y)
panTo
panTo(latLng)
พารามิเตอร์: 
  • latLng:  LatLng|LatLngLiteral ละติจูด/ลองจิจูดใหม่ของกึ่งกลางแผนที่
ค่าที่ส่งคืน: ไม่มี
เปลี่ยนจุดกึ่งกลางของแผนที่เป็น LatLng ที่ระบุ หากการเปลี่ยนแปลงน้อยกว่าทั้งความกว้างและความสูงของแผนที่ การเปลี่ยนภาพจะเป็นภาพเคลื่อนไหวที่ราบรื่น
panToBounds
panToBounds(latLngBounds[, padding])
พารามิเตอร์: 
  • latLngBounds:  LatLngBounds|LatLngBoundsLiteral ขอบเขตที่จะเลื่อนแผนที่ไป
  • padding:  number|Padding optional ระยะห่างในหน่วยพิกเซล ค่าตัวเลขจะทำให้เกิดระยะห่างจากขอบเท่ากันทั้ง 4 ด้าน ค่าเริ่มต้นคือ 0
ค่าที่ส่งคืน: ไม่มี
เลื่อนแผนที่ด้วยจำนวนเงินขั้นต่ำที่จำเป็นเพื่อให้มี LatLngBounds ที่ระบุ โดยไม่มีการรับประกันว่าขอบเขตจะอยู่ที่ใดบนแผนที่ ยกเว้นว่าแผนที่จะเลื่อนเพื่อแสดงขอบเขตให้มากที่สุดเท่าที่จะเป็นไปได้ภายใน {currentMapSizeInPx} - {padding} สำหรับทั้งแผนที่แรสเตอร์และเวกเตอร์ ระบบจะไม่เปลี่ยนแปลงการซูม การเอียง และส่วนหัวของแผนที่
setCenter
setCenter(latlng)
พารามิเตอร์: 
ค่าที่ส่งคืน: ไม่มี
setClickableIcons
setClickableIcons(value)
พารามิเตอร์: 
  • value:  boolean
ค่าที่ส่งคืน: ไม่มี
ควบคุมว่าไอคอนแผนที่คลิกได้หรือไม่ ไอคอนแผนที่แสดงจุดที่น่าสนใจ หรือที่เรียกว่า POI หากต้องการปิดใช้การคลิกไอคอนแผนที่ ให้ส่งค่า false ไปยังเมธอดนี้
setHeading
setHeading(heading)
พารามิเตอร์: 
  • heading:  number
ค่าที่ส่งคืน: ไม่มี
ตั้งค่าทิศทางเข็มทิศสำหรับแผนที่ซึ่งวัดเป็นองศาจากทิศเหนือ สำหรับแผนที่แรสเตอร์ วิธีนี้ใช้ได้กับภาพถ่ายทางอากาศเท่านั้น
setHeadingInteractionEnabled
setHeadingInteractionEnabled(headingInteractionEnabled)
พารามิเตอร์: 
  • headingInteractionEnabled:  boolean
ค่าที่ส่งคืน: ไม่มี
ตั้งค่าว่าจะเปิดใช้การโต้ตอบส่วนหัวหรือไม่ ตัวเลือกนี้จะมีผลเมื่อแผนที่เป็นแผนที่เวกเตอร์เท่านั้น หากไม่ได้ตั้งค่าในโค้ด ระบบจะใช้การกำหนดค่าในระบบคลาวด์สำหรับรหัสแผนที่ (หากมี)
setMapTypeId
setMapTypeId(mapTypeId)
พารามิเตอร์: 
ค่าที่ส่งคืน: ไม่มี
setOptions
setOptions(options)
พารามิเตอร์: 
ค่าที่ส่งคืน: ไม่มี
setRenderingType
setRenderingType(renderingType)
พารามิเตอร์: 
ค่าที่ส่งคืน: ไม่มี
กำหนด RenderingType ปัจจุบันของแผนที่
setStreetView
setStreetView(panorama)
พารามิเตอร์: 
  • panorama:  StreetViewPanorama optional พาโนรามาที่จะเชื่อมโยงกับแผนที่
ค่าที่ส่งคืน: ไม่มี
เชื่อมโยง StreetViewPanorama กับแผนที่ ภาพพาโนรามานี้จะลบล้าง StreetViewPanorama เริ่มต้น ทำให้แผนที่เชื่อมโยงกับภาพพาโนรามาภายนอกแผนที่ได้ การตั้งค่าภาพพาโนรามาเป็น null จะเชื่อมโยงภาพพาโนรามาเริ่มต้นที่ฝังไว้กลับไปยังแผนที่
setTilt
setTilt(tilt)
พารามิเตอร์: 
  • tilt:  number
ค่าที่ส่งคืน: ไม่มี
สำหรับแผนที่เวกเตอร์ ให้ตั้งค่ามุมตกกระทบของแผนที่ ค่าที่อนุญาตจะถูกจำกัดตามระดับการซูมของแผนที่

สำหรับแผนที่แรสเตอร์ จะควบคุมลักษณะการสลับอัตโนมัติสำหรับมุมตกกระทบของแผนที่ ค่าที่อนุญาตคือ 0 และ 45 เท่านั้น setTilt(0) ทำให้แผนที่ใช้มุมมองจากด้านบน 0° เสมอ ไม่ว่าระดับการซูมและวิวพอร์ตจะเป็นอย่างไร setTilt(45) ทำให้มุมเอียงเปลี่ยนเป็น 45 โดยอัตโนมัติเมื่อใดก็ตามที่มีภาพมุม 45° สำหรับระดับการซูมและวิวพอร์ตปัจจุบัน และเปลี่ยนกลับเป็น 0 เมื่อใดก็ตามที่ไม่มีภาพมุม 45° (นี่คือลักษณะการทำงานเริ่มต้น) ภาพมุม 45° ใช้ได้กับแผนที่ประเภท satellite และ hybrid ในบางพื้นที่และที่ระดับการซูมบางระดับเท่านั้น หมายเหตุ: getTilt จะแสดงมุมเอียงปัจจุบัน ไม่ใช่ค่าที่ตั้งค่าโดย setTilt เนื่องจาก getTilt และ setTilt หมายถึงสิ่งต่างๆ ที่แตกต่างกัน จึงไม่ควรbind()พร็อพเพอร์ตี้ tilt การทำเช่นนี้อาจส่งผลที่ไม่คาดคิด
setTiltInteractionEnabled
setTiltInteractionEnabled(tiltInteractionEnabled)
พารามิเตอร์: 
  • tiltInteractionEnabled:  boolean
ค่าที่ส่งคืน: ไม่มี
ตั้งค่าว่าจะเปิดใช้การโต้ตอบด้วยการเอียงหรือไม่ ตัวเลือกนี้จะมีผลเมื่อแผนที่เป็นแผนที่เวกเตอร์เท่านั้น หากไม่ได้ตั้งค่าในโค้ด ระบบจะใช้การกำหนดค่าในระบบคลาวด์สำหรับรหัสแผนที่ (หากมี)
setZoom
setZoom(zoom)
พารามิเตอร์: 
  • zoom:  number ค่าการซูมที่สูงขึ้นจะสอดคล้องกับความละเอียดที่สูงขึ้น
ค่าที่ส่งคืน: ไม่มี
กำหนดการซูมของแผนที่
สืบทอด: 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)
อาร์กิวเมนต์: 
เหตุการณ์นี้จะเริ่มทำงานเมื่อเหตุการณ์ contextmenu ของ DOM เริ่มทำงานในคอนเทนเนอร์แผนที่
dblclick
function(event)
อาร์กิวเมนต์: 
เหตุการณ์นี้จะเริ่มทำงานเมื่อผู้ใช้ดับเบิลคลิกบนแผนที่ โปรดทราบว่าบางครั้งเหตุการณ์คลิกจะทํางาน 1 ครั้ง และบางครั้งจะทํางาน 2 ครั้งก่อนเหตุการณ์นี้
drag
function()
อาร์กิวเมนต์: ไม่มี
ระบบจะทริกเกอร์เหตุการณ์นี้ซ้ำๆ ขณะที่ผู้ใช้ลากแผนที่
dragend
function()
อาร์กิวเมนต์: ไม่มี
เหตุการณ์นี้จะเริ่มทำงานเมื่อผู้ใช้หยุดลากแผนที่ หมายเหตุ: เหตุการณ์ dragend จะไม่เริ่มทำงานเมื่อผู้ใช้หยุดเลื่อนแผนที่โดยใช้แป้นพิมพ์ โปรดใช้เหตุการณ์ Map.idle แทนเพื่อพิจารณาว่าเมื่อใดที่ผู้ใช้หยุดเลื่อนหรือลากแผนที่
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()
อาร์กิวเมนต์: ไม่มี
เหตุการณ์นี้จะเริ่มทำงานเมื่อมีการเปลี่ยนแปลง renderingType
tilesloaded
function()
อาร์กิวเมนต์: ไม่มี
เหตุการณ์นี้จะเริ่มทำงานเมื่อโหลดไทล์ที่มองเห็นเสร็จแล้ว
tilt_changed
function()
อาร์กิวเมนต์: ไม่มี
ระบบจะทริกเกอร์เหตุการณ์นี้เมื่อพร็อพเพอร์ตี้การเอียงแผนที่เปลี่ยนแปลง
zoom_changed
function()
อาร์กิวเมนต์: ไม่มี
เหตุการณ์นี้จะเริ่มทำงานเมื่อพร็อพเพอร์ตี้การซูมแผนที่เปลี่ยนแปลง
rightclick
function(event)
อาร์กิวเมนต์: 
เหตุการณ์นี้จะทริกเกอร์เมื่อผู้ใช้คลิกขวาบนแผนที่

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

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

ออบเจ็กต์ MapOptions ที่ใช้กำหนดพร็อพเพอร์ตี้ที่ตั้งค่าในแผนที่ได้
backgroundColor optional
ประเภท:  string optional
สีที่ใช้สำหรับพื้นหลังของ Div แผนที่ สีนี้จะปรากฏเมื่อไทล์ยังโหลดไม่เสร็จขณะที่ผู้ใช้เลื่อน คุณจะตั้งค่าตัวเลือกนี้ได้เมื่อเริ่มต้นแผนที่เท่านั้น
cameraControl optional
ประเภท:  boolean optional
สถานะเปิด/ปิดของการควบคุมกล้อง
cameraControlOptions optional
ประเภท:  CameraControlOptions optional
ตัวเลือกการแสดงผลสำหรับการควบคุมกล้อง
center optional
ประเภท:  LatLng|LatLngLiteral optional
จุดศูนย์กลางเริ่มต้นของแผนที่
clickableIcons optional
ประเภท:  boolean optional
ค่าเริ่มต้น: true
เมื่อ false คุณจะคลิกไอคอนแผนที่ไม่ได้ ไอคอนแผนที่แสดงจุดที่น่าสนใจ หรือที่เรียกว่า POI
colorScheme optional
ประเภท:  ColorScheme|string optional
ค่าเริ่มต้น: ColorScheme.LIGHT
รูปแบบสีเริ่มต้นของ Maps คุณจะตั้งค่าตัวเลือกนี้ได้เมื่อเริ่มต้นแผนที่เท่านั้น
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 เพื่อเปลี่ยนไอคอน เช่นเดียวกับพร็อพเพอร์ตี้ CSS คุณต้องระบุเคอร์เซอร์สำรองอย่างน้อย 1 รายการที่ไม่ใช่ URL ตัวอย่างเช่น draggableCursor: 'url(http://www.example.com/icon.png), auto;'
draggingCursor optional
ประเภท:  string optional
ชื่อหรือ URL ของเคอร์เซอร์ที่จะแสดงเมื่อลากแผนที่ พร็อพเพอร์ตี้นี้ใช้แอตทริบิวต์ cursor ของ CSS เพื่อเปลี่ยนไอคอน เช่นเดียวกับพร็อพเพอร์ตี้ CSS คุณต้องระบุเคอร์เซอร์สำรองอย่างน้อย 1 รายการที่ไม่ใช่ URL ตัวอย่างเช่น draggingCursor: 'url(http://www.example.com/icon.png), auto;'
fullscreenControl optional
ประเภท:  boolean optional
สถานะเปิด/ปิดของตัวควบคุมแบบเต็มหน้าจอ
fullscreenControlOptions optional
ประเภท:  FullscreenControlOptions optional
ตัวเลือกการแสดงผลสำหรับตัวควบคุมแบบเต็มหน้าจอ
gestureHandling optional
ประเภท:  string optional
การตั้งค่านี้จะควบคุมวิธีที่ API จัดการท่าทางสัมผัสบนแผนที่ ค่าที่อนุญาต:
  • "cooperative": การเลื่อนเหตุการณ์และท่าทางสัมผัสด้วยนิ้วเดียวจะเลื่อนหน้าเว็บ และจะไม่ซูมหรือเลื่อนแผนที่ ท่าทางสัมผัส 2 นิ้วจะเลื่อนและซูมแผนที่ การเลื่อนกิจกรรมโดยกดปุ่ม Ctrl หรือปุ่ม ⌘ จะซูมแผนที่
    ในโหมดนี้ แผนที่จะทำงานร่วมกันกับหน้าเว็บ
  • "greedy": ท่าทางสัมผัสและเหตุการณ์การเลื่อนทั้งหมดจะเลื่อนหรือซูมแผนที่
  • "none": ผู้ใช้จะเลื่อนหรือซูมแผนที่ด้วยท่าทางสัมผัสไม่ได้
  • "auto": (ค่าเริ่มต้น) การจัดการท่าทางสัมผัสจะเป็นแบบร่วมมือหรือแบบตะกละ ขึ้นอยู่กับว่าหน้าเว็บเลื่อนได้หรือไม่หรืออยู่ใน iframe
heading optional
ประเภท:  number optional
ส่วนหัวสำหรับภาพถ่ายทางอากาศในหน่วยองศาที่วัดตามเข็มนาฬิกาจากทิศเหนือ โดยระบบจะสแนปส่วนหัวไปยังมุมที่ใกล้ที่สุดซึ่งมีภาพ
headingInteractionEnabled optional
ประเภท:  boolean optional
ค่าเริ่มต้น: false
แผนที่ควรอนุญาตให้ผู้ใช้ควบคุมส่วนหัวของกล้อง (การหมุน) หรือไม่ ตัวเลือกนี้จะมีผลเมื่อแผนที่เป็นแผนที่เวกเตอร์เท่านั้น หากไม่ได้ตั้งค่าในโค้ด ระบบจะใช้การกำหนดค่าในระบบคลาวด์สำหรับรหัสแผนที่ (หากมี)
internalUsageAttributionIds optional
ประเภท:  Iterable<string> optional
ค่าเริ่มต้น: null
เพิ่มรหัสการระบุแหล่งที่มาของการใช้งานลงในตัวเริ่มต้น ซึ่งจะช่วยให้ Google เข้าใจว่าไลบรารีและตัวอย่างใดมีประโยชน์ต่อนักพัฒนาแอป เช่น การใช้งานไลบรารีการจัดกลุ่มเครื่องหมาย หากต้องการเลือกไม่ส่งรหัสการระบุแหล่งที่มาของการใช้งาน คุณสามารถลบพร็อพเพอร์ตี้นี้หรือแทนที่ค่าด้วยสตริงว่างได้ ระบบจะส่งเฉพาะค่าที่ไม่ซ้ำกัน ระบบอาจไม่สนใจการเปลี่ยนแปลงค่านี้หลังจากสร้างอินสแตนซ์
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
mapTypeId เริ่มต้นของแผนที่ ค่าเริ่มต้นคือ ROADMAP
maxZoom optional
ประเภท:  number optional
ระดับการซูมสูงสุดที่จะแสดงบนแผนที่ หากเว้นไว้หรือตั้งค่าเป็น null ระบบจะใช้การซูมสูงสุดจากประเภทแผนที่ปัจจุบันแทน ค่าการซูมที่ถูกต้องคือตัวเลขตั้งแต่ 0 จนถึงระดับการซูมสูงสุดที่รองรับ
minZoom optional
ประเภท:  number optional
ระดับการซูมขั้นต่ำที่จะแสดงบนแผนที่ หากเว้นไว้หรือตั้งค่าเป็น null ระบบจะใช้ระดับการซูมขั้นต่ำจากประเภทแผนที่ปัจจุบันแทน ค่าการซูมที่ถูกต้องคือตัวเลขตั้งแต่ 0 จนถึงระดับการซูมสูงสุดที่รองรับ
noClear optional
ประเภท:  boolean optional
If true, do not clear the contents of the Map 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
ตัวเลือกการแสดงผลสำหรับตัวควบคุมการซูม

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

ColorScheme ค่าคงที่

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

ตัวระบุสำหรับรูปแบบสีของแผนที่ ระบุค่าเหล่านี้ตามค่าหรือโดยใช้ชื่อของค่าคงที่ เช่น 'FOLLOW_SYSTEM' หรือ google.maps.ColorScheme.FOLLOW_SYSTEM

เข้าถึงได้โดยโทรไปที่ const {ColorScheme} = await google.maps.importLibrary("core")
ดูไลบรารีใน Maps JavaScript API
DARK รูปแบบสีเข้มสำหรับแผนที่
FOLLOW_SYSTEM ระบบจะเลือกรูปแบบสีตามค่ากำหนดของระบบ
LIGHT รูปแบบสีอ่อนสำหรับแผนที่ ค่าเริ่มต้นสำหรับ Maps JS เวอร์ชันเดิม

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 class

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

รีจิสทรีสำหรับอินสแตนซ์ MapType ซึ่งมีคีย์เป็นรหัส MapType

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

เข้าถึงได้โดยโทรไปที่ const {MapTypeRegistry} = await google.maps.importLibrary("maps")
ดูไลบรารีใน Maps JavaScript API
MapTypeRegistry
MapTypeRegistry()
พารามิเตอร์: ไม่มี
MapTypeRegistry มีคอลเล็กชันของประเภทแผนที่ที่กำหนดเองซึ่งพร้อมให้แผนที่ใช้งาน API จะอ้างอิงรีจิสทรีนี้เมื่อแสดงรายการประเภทแผนที่ที่ใช้ได้ภายในตัวควบคุม เช่น
set
set(id, mapType)
พารามิเตอร์: 
  • id:  string ตัวระบุของ MapType ที่จะเพิ่มลงในรีจิสทรี
  • mapType:  ออบเจ็กต์ MapType|? 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 class

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

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

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

เข้าถึงได้โดยโทรไปที่ const {TrafficLayer} = await google.maps.importLibrary("maps")
ดูไลบรารีใน Maps JavaScript API
TrafficLayer
TrafficLayer([opts])
พารามิเตอร์: 
เลเยอร์ที่แสดงการจราจรบนถนนในปัจจุบัน
getMap
getMap()
พารามิเตอร์: ไม่มี
ค่าที่ส่งคืน:  Map|null
แสดงผลแผนที่ที่เลเยอร์นี้แสดงอยู่
setMap
setMap(map)
พารามิเตอร์: 
  • map:  Map optional
ค่าที่ส่งคืน: ไม่มี
แสดงเลเยอร์บนแผนที่ที่ระบุ หากตั้งค่าแผนที่เป็น 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 class

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

เลเยอร์ขนส่งสาธารณะ

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

เข้าถึงได้โดยโทรไปที่ const {TransitLayer} = await google.maps.importLibrary("maps")
ดูไลบรารีใน Maps JavaScript API
TransitLayer
TransitLayer()
พารามิเตอร์: ไม่มี
เลเยอร์ที่แสดงเส้นทางขนส่งสาธารณะ
getMap
getMap()
พารามิเตอร์: ไม่มี
ค่าที่ส่งคืน:  Map|null
แสดงผลแผนที่ที่เลเยอร์นี้แสดงอยู่
setMap
setMap(map)
พารามิเตอร์: 
  • map:  Map optional
ค่าที่ส่งคืน:  void
แสดงเลเยอร์บนแผนที่ที่ระบุ หากตั้งค่าแผนที่เป็น null ระบบจะนำเลเยอร์ออก
สืบทอด: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll

BicyclingLayer class

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

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

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

เข้าถึงได้โดยโทรไปที่ const {BicyclingLayer} = await google.maps.importLibrary("maps")
ดูไลบรารีใน Maps JavaScript API
BicyclingLayer
BicyclingLayer()
พารามิเตอร์: ไม่มี
เลเยอร์ที่แสดงเลนและเส้นทางจักรยาน รวมถึงลดระดับถนนขนาดใหญ่
getMap
getMap()
พารามิเตอร์: ไม่มี
ค่าที่ส่งคืน:  Map|null
แสดงผลแผนที่ที่เลเยอร์นี้แสดงอยู่
setMap
setMap(map)
พารามิเตอร์: 
  • map:  Map optional
ค่าที่ส่งคืน:  void
แสดงเลเยอร์บนแผนที่ที่ระบุ หากตั้งค่าแผนที่เป็น 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 ได้