Google Maps

คลาสสุดท้ายสาธารณะ GoogleMap ขยายออบเจ็กต์

นี่เป็นคลาสหลักของ Google Maps SDK สำหรับ Android และเป็นจุดแรกเข้าของทุกเมธอดที่เกี่ยวข้องกับแผนที่ คุณจะสร้างอินสแตนซ์ GoogleMap โดยตรงไม่ได้ แต่ต้องรับออบเจ็กต์จากเมธอด getMapAsync() ใน MapFragment หรือ MapView ที่คุณเพิ่มลงในแอปพลิเคชัน

หมายเหตุ: คล้ายกับออบเจ็กต์ View ตรงที่จะอ่านและแก้ไข GoogleMap ได้จากเธรด UI ของ Android เท่านั้น การเรียกใช้เมธอด GoogleMap จากชุดข้อความอื่นจะทำให้ระบบได้รับข้อยกเว้น

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

คู่มือนักพัฒนา

เริ่มต้นใช้งานโดยอ่านคู่มือนักพัฒนาซอฟต์แวร์ Google Maps SDK สำหรับ Android

สรุปข้อมูลชั้นเรียนที่ซ้อนกัน

ที่ปรับปรุงใหม่ GoogleMap.CancelableCallback อินเทอร์เฟซการติดต่อกลับสำหรับการรายงานเมื่องานเสร็จสมบูรณ์หรือยกเลิก
ที่ปรับปรุงใหม่ GoogleMap.InfoWindowAdapter ให้มุมมองสำหรับการแสดงผลที่กำหนดเองของหน้าต่างข้อมูล
ที่ปรับปรุงใหม่ GoogleMap.OnCameraChangeListener อินเทอร์เฟซนี้เลิกใช้งานแล้ว แทนที่โดย GoogleMap.OnCameraMoveStartedListener, GoogleMap.OnCameraMoveListener และ GoogleMap.OnCameraIdleListener ไม่มีการกำหนดลำดับการเรียกใช้เมธอด onCameraChange ที่เลิกใช้งานแล้วซึ่งสัมพันธ์กับเมธอดใน Listener การเปลี่ยนแปลงกล้องใหม่  
ที่ปรับปรุงใหม่ GoogleMap.OnCameraIdleListener อินเทอร์เฟซเรียกกลับสำหรับเวลาที่การเคลื่อนที่ของกล้องสิ้นสุด
ที่ปรับปรุงใหม่ GoogleMap.OnCameraMoveCanceledListener อินเทอร์เฟซเรียกกลับสำหรับเวลาที่การเคลื่อนไหวของกล้องหยุดลงหรือเมื่อกล้องเริ่มเคลื่อนที่ด้วยเหตุผลใหม่
ที่ปรับปรุงใหม่ GoogleMap.OnCameraMoveListener อินเทอร์เฟซการโทรกลับสำหรับกรณีที่กล้องเปลี่ยนตำแหน่ง
ที่ปรับปรุงใหม่ GoogleMap.OnCameraMoveStartedListener อินเทอร์เฟซการติดต่อกลับเมื่อการเคลื่อนไหวของกล้องเริ่มขึ้น
ที่ปรับปรุงใหม่ GoogleMap.OnCircleClickListener อินเทอร์เฟซการติดต่อกลับเมื่อมีการคลิกแวดวง
ที่ปรับปรุงใหม่ GoogleMap.OnGroundOverlayClickListener อินเทอร์เฟซการติดต่อกลับเมื่อมีการคลิกการวางซ้อนพื้นที่
ที่ปรับปรุงใหม่ GoogleMap.OnIndoorStateChangeListener Listener เมื่อสถานะภายในอาคารมีการเปลี่ยนแปลง
ที่ปรับปรุงใหม่ GoogleMap.OnInfoWindowClickListener อินเทอร์เฟซเรียกกลับสำหรับเหตุการณ์การคลิก/แตะในหน้าต่างข้อมูลของเครื่องหมาย
ที่ปรับปรุงใหม่ GoogleMap.OnInfoWindowCloseListener อินเทอร์เฟซเรียกกลับสำหรับเหตุการณ์ปิดในหน้าต่างข้อมูลของเครื่องหมาย
ที่ปรับปรุงใหม่ GoogleMap.OnInfoWindowLongClickListener อินเทอร์เฟซเรียกกลับสำหรับเมื่อผู้ใช้กดหน้าต่างข้อมูลของเครื่องหมายค้างไว้
ที่ปรับปรุงใหม่ GoogleMap.OnMapClickListener อินเทอร์เฟซการติดต่อกลับสำหรับเมื่อผู้ใช้แตะบนแผนที่
ที่ปรับปรุงใหม่ GoogleMap.OnMapLoadedCallback อินเทอร์เฟซการติดต่อกลับเมื่อแผนที่แสดงผลเสร็จแล้ว
ที่ปรับปรุงใหม่ GoogleMap.OnMapLongClickListener อินเทอร์เฟซเรียกกลับสำหรับกรณีที่ผู้ใช้กดค้างบนแผนที่
ที่ปรับปรุงใหม่ GoogleMap.OnMarkerClickListener กำหนดลายเซ็นสำหรับเมธอดที่เรียกใช้เมื่อมีการคลิกหรือแตะเครื่องหมาย
ที่ปรับปรุงใหม่ GoogleMap.OnMarkerDragListener อินเทอร์เฟซเรียกกลับสำหรับเหตุการณ์การลากบนตัวทำเครื่องหมาย
ที่ปรับปรุงใหม่ GoogleMap.OnMyLocationButtonClickListener อินเทอร์เฟซการติดต่อกลับเมื่อมีการคลิกปุ่ม "ตำแหน่งของฉัน"
ที่ปรับปรุงใหม่ GoogleMap.OnMyLocationChangeListener อินเทอร์เฟซนี้เลิกใช้งานแล้ว โปรดใช้ com.google.android.gms.location.FusedLocationProviderApi แทน FusedLocationProviderApi จะแสดงการค้นหาตำแหน่งและปริมาณการใช้พลังงานที่ได้รับการปรับปรุง และจุดสีน้ำเงิน "ตำแหน่งของฉัน" ก็นำมาใช้ ดู บทแนะนำเกี่ยวกับ "เลือกสถานที่ปัจจุบัน" ซึ่งใช้ FusedLocationProviderApi หรือคู่มือนักพัฒนาซอฟต์แวร์เกี่ยวกับตำแหน่ง  
ที่ปรับปรุงใหม่ GoogleMap.OnMyLocationClickListener อินเทอร์เฟซเรียกกลับเมื่อมีการคลิกจุด "ตำแหน่งของฉัน" (ซึ่งหมายถึงตำแหน่งของผู้ใช้)
ที่ปรับปรุงใหม่ GoogleMap.OnPoiClickListener Listener การแตะจุดที่น่าสนใจ
ที่ปรับปรุงใหม่ GoogleMap.OnPolygonClickListener อินเทอร์เฟซเรียกกลับเมื่อมีการคลิกรูปหลายเหลี่ยม
ที่ปรับปรุงใหม่ GoogleMap.OnPolylineClickListener อินเทอร์เฟซการติดต่อกลับเมื่อมีการคลิกโพลีไลน์
ที่ปรับปรุงใหม่ GoogleMap.SnapshotReadyCallback อินเทอร์เฟซติดต่อกลับสำหรับแจ้งเตือนเมื่อมีการบันทึกสแนปชอตแล้ว

สรุปแบบคงที่

int MAP_TYPE_HYBRID แผนที่ดาวเทียมที่มีเลเยอร์โปร่งใสของถนนสายหลัก
int MAP_TYPE_NONE ไม่มีชิ้นส่วนแผนที่ฐาน
int MAP_TYPE_NORMAL แผนที่พื้นฐาน
int MAP_TYPE_SATELLITE แผนที่ดาวเทียมที่ไม่มีป้ายกำกับ
int MAP_TYPE_TERRAIN แผนที่ภูมิประเทศ

สรุปวิธีการสาธารณะ

วงกลม
addCircle(ตัวเลือก CircleOptions)
เพิ่มวงกลมลงในแผนที่นี้
GroundOverlay
addGroundOverlay(ตัวเลือก GroundOverlayOptions)
เพิ่มรูปภาพลงในแผนที่นี้
เครื่องหมาย
addMarker(ตัวเลือก MarkerOptions)
เพิ่มเครื่องหมายลงในแผนที่นี้
รูปหลายเหลี่ยม
addPolygon(ตัวเลือก PolygonOptions)
เพิ่มรูปหลายเหลี่ยมให้แผนที่นี้
โพลีไลน์
addPolyline(ตัวเลือก PolylineOptions)
เพิ่มเส้นประกอบในแผนที่นี้
TileOverlay
addTileOverlay(ตัวเลือก TileOverlayOptions)
เพิ่มการวางซ้อนของชิ้นส่วนแผนที่นี้
void
animateCamera(อัปเดต CameraUpdate)
ทำให้การเคลื่อนไหวของกล้องจากตำแหน่งปัจจุบันไปยังตำแหน่งที่กำหนดไว้ในการอัปเดต
void
animateCamera(อัปเดต CameraUpdate, โค้ดเรียกกลับ GoogleMap.CancelableCallback)
สร้างการเคลื่อนไหวของกล้องจากตำแหน่งปัจจุบันไปยังตำแหน่งที่กำหนดไว้ในการอัปเดตและเรียกใช้โค้ดเรียกกลับเมื่อเสร็จสมบูรณ์
void
animateCamera(อัปเดต CameraUpdate, int periodMs, GoogleMap.CancelableCallback ในโค้ดเรียกกลับ)
เลื่อนแผนที่ตามการอัปเดตที่มีภาพเคลื่อนไหวในระยะเวลาที่ระบุ และเรียกใช้การเรียกกลับแบบไม่บังคับเมื่อเสร็จสิ้น
void
clear()
ลบเครื่องหมาย โพลีไลน์ รูปหลายเหลี่ยม ภาพซ้อน ฯลฯ ทั้งหมดออกจากแผนที่
CameraPosition
getCameraPosition()
ดึงตำแหน่งปัจจุบันของกล้อง
IndoorBuilding
getFocusedBuilding()
รับอาคารที่โฟกัสอยู่ในปัจจุบัน
int
getMapType()
รับประเภทแผนที่ที่กำลังแสดงอยู่
float
getMaxZoomLevel()
แสดงระดับการซูมสูงสุดสำหรับตำแหน่งกล้องปัจจุบัน
float
getMinZoomLevel()
แสดงระดับการซูมต่ำสุด
ตำแหน่ง
getMyLocation()
วิธีนี้เลิกใช้งานแล้ว use com.google.android.gms.location.FusedLocationProviderApi instead. FusedLocationProviderApi จะแสดงการค้นหาตำแหน่งและปริมาณการใช้พลังงานที่ได้รับการปรับปรุง และจุดสีน้ำเงิน "ตำแหน่งของฉัน" ก็นำมาใช้ ดูตัวอย่างโค้ดได้ที่ MyLocationDemoActivity ในโฟลเดอร์แอปพลิเคชันตัวอย่าง หรือคู่มือตำแหน่งสำหรับนักพัฒนาซอฟต์แวร์
การฉายภาพ
getProjection()
แสดงผลวัตถุ Projection ที่ใช้แปลงพิกัดหน้าจอและพิกัดละติจูด/ลองจิจูดได้
UiSettings
getUiSettings()
รับการตั้งค่าอินเทอร์เฟซผู้ใช้สำหรับแผนที่
boolean
isBuildingsEnabled()
แสดงผลว่ามีการเปิดใช้เลเยอร์สิ่งปลูกสร้าง 3 มิติหรือไม่
boolean
isIndoorEnabled()
รับข้อมูลว่าแผนที่ในอาคารเปิดใช้งานอยู่หรือไม่
boolean
isMyLocationEnabled()
รับสถานะของเลเยอร์ตำแหน่งของฉัน
boolean
isTrafficEnabled()
ตรวจสอบว่าแผนที่ดึงข้อมูลการจราจรหรือไม่
void
moveCamera(อัปเดต CameraUpdate)
เปลี่ยนตำแหน่งกล้องตามคำแนะนำที่ระบุไว้ในการอัปเดต
void
resetMinMaxZoomPreference()
นำขอบเขตการซูมบนและล่างที่ระบุไว้ก่อนหน้านี้ออก
void
setBuildingsEnabled(เปิดใช้บูลีน)
เปิดหรือปิดเลเยอร์สิ่งปลูกสร้าง 3 มิติ
void
setContentDescription(คำอธิบายสตริง)
ตั้งค่าคำอธิบายเนื้อหาสำหรับแผนที่
boolean
setIndoorEnabled(เปิดใช้บูลีน)
ตั้งค่าว่าควรเปิดใช้แผนที่ในอาคารหรือไม่
void
setInfoWindowAdapter(อะแดปเตอร์ GoogleMap.InfoWindowAdapter)
ตั้งค่าตัวแสดงผลที่กำหนดเองสำหรับเนื้อหาของหน้าต่างข้อมูล
void
setLatLngBoundsForCameraTarget(ขอบเขต LatLngBounds)
ระบุ LatLngBounds เพื่อบังคับเป้าหมายของกล้อง เพื่อให้ผู้ใช้เลื่อนและเลื่อนแผนที่ เป้าหมายของกล้องจะไม่ออกนอกขอบเขตเหล่านี้
void
setLocationSource(แหล่งที่มา LocationSource)
แทนที่ต้นทางตำแหน่งของเลเยอร์ตำแหน่งของฉัน
boolean
setMapStyle(รูปแบบ MapStyleOptions)
ตั้งค่าการจัดรูปแบบของแผนที่ฐาน
void
setMapType(ประเภท int)
ตั้งค่าประเภทของชิ้นส่วนแผนที่ที่จะแสดง
void
setMaxZoomPreference(FlomaxZoomPreference)
ตั้งค่าขอบเขตบนที่ต้องการสำหรับการซูมของกล้อง
void
setMinZoomPreference(Flo minZoomPreference)
ตั้งค่าขอบเขตล่างที่ต้องการสำหรับการซูมของกล้อง
void
setMyLocationEnabled(เปิดใช้บูลีน)
เปิดหรือปิดการใช้งานเลเยอร์ตำแหน่งของฉัน
void
setOnCameraChangeListener(Listener GoogleMap.OnCameraChangeListener)
วิธีนี้เลิกใช้งานแล้ว แทนที่โดย setOnCameraMoveStartedListener(GoogleMap.OnCameraMoveStartedListener), setOnCameraMoveListener(GoogleMap.OnCameraMoveListener), setOnCameraMoveCanceledListener(GoogleMap.OnCameraMoveCanceledListener) และ setOnCameraIdleListener(GoogleMap.OnCameraIdleListener)
void
setOnCameraIdleListener(Listener GoogleMap.OnCameraIdleListener)
ตั้งค่าโค้ดเรียกกลับที่เรียกใช้เมื่อการเคลื่อนที่ของกล้องสิ้นสุด
void
setOnCameraMoveCanceledListener(Listener GoogleMap.OnCameraMoveCanceledListener)
ตั้งค่าโค้ดเรียกกลับที่เรียกให้แสดงเมื่อการเคลื่อนไหวของกล้องหยุดลงหรือขัดจังหวะโดยภาพเคลื่อนไหวประเภทใหม่
void
setOnCameraMoveListener(Listener GoogleMap.OnCameraMoveListener)
ตั้งค่าโค้ดเรียกกลับที่มีการเรียกซ้ำๆ ขณะที่กล้องกำลังเคลื่อนที่
void
setOnCameraMoveStartedListener(Listener GoogleMap.OnCameraMoveStartedListener)
ตั้งค่าโค้ดเรียกกลับที่ถูกเรียกให้แสดงเมื่อกล้องเริ่มเคลื่อนไหวหรือมีการเปลี่ยนแปลงเหตุผลในการเคลื่อนไหวของกล้อง
void
setOnCircleClickListener(Listener GoogleMap.OnCircleClickListener)
ตั้งค่าโค้ดเรียกกลับที่เรียกใช้เมื่อมีการคลิกแวดวง
void
setOnGroundOverlayClickListener(Listener GoogleMap.OnGroundOverlayClickListener)
ตั้งค่าโค้ดเรียกกลับที่เรียกใช้เมื่อมีการคลิกการวางซ้อนพื้นที่
void
setOnIndoorStateChangeListener(Listener GoogleMap.OnIndoorStateChangeListener)
ตั้งค่าหรือล้างผู้ฟังสำหรับกิจกรรมในอาคาร
void
setOnInfoWindowClickListener(Listener GoogleMap.OnInfoWindowClickListener)
ตั้งค่าโค้ดเรียกกลับที่เรียกใช้เมื่อมีการคลิกหน้าต่างข้อมูลเครื่องหมาย
void
setOnInfoWindowCloseListener(Listener GoogleMap.OnInfoWindowCloseListener)
ตั้งค่าโค้ดเรียกกลับที่เรียกใช้เมื่อปิดหน้าต่างข้อมูลของเครื่องหมาย
void
setOnInfoWindowLongClickListener(Listener GoogleMap.OnInfoWindowLongClickListener)
ตั้งค่าโค้ดเรียกกลับที่เรียกใช้เมื่อกดหน้าต่างข้อมูลของเครื่องหมายค้างไว้
void
setOnMapClickListener(Listener GoogleMap.OnMapClickListener)
ตั้งค่าโค้ดเรียกกลับที่เรียกใช้เมื่อแตะแผนที่
void
setOnMapLoadedCallback(โค้ดเรียกกลับ GoogleMap.OnMapLoadedCallback)
ตั้งค่าโค้ดเรียกกลับที่เรียกใช้เมื่อแผนที่นี้แสดงผลเสร็จแล้ว
void
setOnMapLongClickListener(Listener GoogleMap.OnMapLongClickListener)
ตั้งค่าโค้ดเรียกกลับที่เรียกใช้เมื่อกดแผนที่ค้างไว้
void
setOnMarkerClickListener(Listener GoogleMap.OnMarkerClickListener)
ตั้งค่าโค้ดเรียกกลับที่เรียกใช้เมื่อมีการคลิกตัวทำเครื่องหมาย
void
setOnMarkerDragListener(Listener GoogleMap.OnMarkerDragListener)
ตั้งค่าโค้ดเรียกกลับที่เรียกใช้เมื่อมีการลากเครื่องหมาย
void
setOnMyLocationButtonClickListener(Listener GoogleMap.OnMyLocationButtonClickListener)
ตั้งค่าโค้ดเรียกกลับที่เรียกใช้เมื่อมีการคลิกปุ่มตำแหน่งของฉัน
void
setOnMyLocationChangeListener(Listener GoogleMap.OnMyLocationChangeListener)
วิธีนี้เลิกใช้งานแล้ว use com.google.android.gms.location.FusedLocationProviderApi instead. FusedLocationProviderApi จะแสดงการค้นหาตำแหน่งและปริมาณการใช้พลังงานที่ได้รับการปรับปรุง และจุดสีน้ำเงิน "ตำแหน่งของฉัน" ก็นำมาใช้ ดูตัวอย่างโค้ดได้ที่ MyLocationDemoActivity ในโฟลเดอร์แอปพลิเคชันตัวอย่าง หรือคู่มือตำแหน่งสำหรับนักพัฒนาซอฟต์แวร์
void
setOnMyLocationClickListener(Listener GoogleMap.OnMyLocationClickListener)
ตั้งค่าโค้ดเรียกกลับที่เรียกใช้เมื่อมีการคลิกจุด "ตำแหน่งของฉัน" (ซึ่งหมายถึงตำแหน่งของผู้ใช้)
void
setOnPoiClickListener(Listener GoogleMap.OnPoiClickListener)
ตั้งค่า Listener ที่จะถูกทริกเกอร์เมื่อมีการคลิกหรือแตะจุดที่น่าสนใจ
void
setOnPolygonClickListener(Listener GoogleMap.OnPolygonClickListener)
ตั้งค่าโค้ดเรียกกลับที่เรียกใช้เมื่อมีการคลิกรูปหลายเหลี่ยม
void
setOnPolylineClickListener(Listener GoogleMap.OnPolylineClickListener)
ตั้งค่าโค้ดเรียกกลับที่เรียกใช้เมื่อมีการคลิกโพลีไลน์
void
setPadding(int left, int top, int right, int bottom)
ตั้งค่าระยะห่างจากขอบบนแผนที่
void
setTrafficEnabled(เปิดใช้บูลีน)
เปิดหรือปิดเลเยอร์การจราจร
void
snapshot(โค้ดเรียกกลับ GoogleMap.SnapshotReadyCallback)
ถ่ายภาพของแผนที่
void
snapshot(โค้ดเรียกกลับ GoogleMap.SnapshotReadyCallback, บิตแมปของบิตแมป)
ถ่ายภาพของแผนที่
void
stopAnimation()
หยุดภาพเคลื่อนไหวของกล้อง หากมีภาพใดกำลังดำเนินอยู่

ข้อมูลสรุปของเมธอดที่รับช่วงมา

ค่าคงที่

สาธารณะ แบบคงที่ สุดท้าย MAP_TYPE_HYBRID

แผนที่ดาวเทียมที่มีเลเยอร์โปร่งใสของถนนสายหลัก

มูลค่าคงที่: 4

สาธารณะ แบบคงที่ สถานะสุดท้าย MAP_TYPE_NONE

ไม่มีชิ้นส่วนแผนที่ฐาน

มูลค่าคงที่: 0

สาธารณะ แบบคงที่ สุดท้าย int MAP_TYPE_NORMAL

แผนที่พื้นฐาน

มูลค่าคงที่: 1

สาธารณะ คงที่ สุดท้าย int MAP_TYPE_SATELLITE

แผนที่ดาวเทียมที่ไม่มีป้ายกำกับ

มูลค่าคงที่: 2

สาธารณะ ค่าคงที่ Final int MAP_TYPE_TERRAIN

แผนที่ภูมิประเทศ

มูลค่าคงที่: 3

วิธีการสาธารณะ

สาธารณะ แวดวง addCircle (CircleOptions ตัวเลือก)

เพิ่มวงกลมลงในแผนที่นี้

พารามิเตอร์
ตัวเลือก วัตถุตัวเลือกวงกลมที่กำหนดวิธีแสดงผลแวดวง
การคืนสินค้า
  • วัตถุ Circle ที่เพิ่มลงในแผนที่

สาธารณะ GroundOverlay addGroundOverlay (GroundOverlayOptions)

เพิ่มรูปภาพลงในแผนที่นี้

พารามิเตอร์
ตัวเลือก ออบเจ็กต์ตัวเลือกการวางซ้อนพื้นที่กำหนดวิธีแสดงผลการวางซ้อน ตัวเลือกจะต้องมีอิมเมจ (AnchoredBitmap) และระบุตำแหน่ง
การคืนสินค้า
  • GroundOverlay ที่เพิ่มลงในแผนที่
การขว้าง
IllegalArgumentException หากไม่ได้ระบุรูปภาพหรือตำแหน่งในตัวเลือก

สาธารณะ Marker addMarker (MarkerOptions ตัวเลือก)

เพิ่มเครื่องหมายลงในแผนที่นี้

ไอคอนของเครื่องหมายจะแสดงผลบนแผนที่ที่ตำแหน่ง Marker.position การคลิกที่เครื่องหมาย จะทําให้กล้องอยู่ตรงกลางของเครื่องหมายนั้น หากมีการกำหนด Mark.title ไว้ แผนที่จะแสดงกล่องข้อมูลพร้อมด้วยชื่อและตัวอย่างข้อมูลของเครื่องหมาย หากลากเครื่องหมายได้ ให้คลิกยาวแล้วลากเครื่องหมายจะเป็นการย้ายเครื่องหมาย

พารามิเตอร์
ตัวเลือก ออบเจ็กต์ตัวเลือกของตัวทำเครื่องหมายที่กำหนดวิธีแสดงผลตัวทำเครื่องหมาย
การคืนสินค้า
  • Marker ที่เพิ่มลงในแผนที่

สาธารณะ Polygon addPolygon (PolygonOptions ตัวเลือก)

เพิ่มรูปหลายเหลี่ยมให้แผนที่นี้

พารามิเตอร์
ตัวเลือก วัตถุตัวเลือกรูปหลายเหลี่ยมที่กำหนดวิธีแสดงผลรูปหลายเหลี่ยม
การคืนสินค้า
  • วัตถุ Polygon ที่เพิ่มลงในแผนที่

สาธารณะ Polyline addPolyline (PolylineOptions ตัวเลือก)

เพิ่มเส้นประกอบในแผนที่นี้

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

สาธารณะ TileOverlay addTileOverlay (TileOverlayOptions ตัวเลือก)

เพิ่มการวางซ้อนของชิ้นส่วนแผนที่นี้ ดูข้อมูลเพิ่มเติมได้ที่ TileOverlay

โปรดทราบว่าภาพซ้อนทับแบบอื่นๆ จะต่างจากแผนที่ซ้อนทับอื่นๆ ตรงที่แผนที่แบบซ้อนทับจะไม่คืนค่าโดยอัตโนมัติและต้องเพิ่มใหม่ด้วยตนเอง

พารามิเตอร์
ตัวเลือก ออบเจ็กต์ตัวเลือกการวางซ้อนแบบไทล์ที่กำหนดวิธีแสดงผลการวางซ้อน ตัวเลือกต้องระบุ TileProvider มิเช่นนั้นระบบจะส่ง IllegalArgumentException
การคืนสินค้า
  • TileOverlay ที่เพิ่มลงในแผนที่
การขว้าง
IllegalArgumentException หากไม่ได้ระบุ TileProvider ในตัวเลือก

สาธารณะ โมฆะ animateCamera (อัปเดต CameraUpdate)

ทำให้การเคลื่อนไหวของกล้องจากตำแหน่งปัจจุบันไปยังตำแหน่งที่กำหนดไว้ในการอัปเดต ในระหว่างที่ภาพเคลื่อนไหว การเรียกไปยัง getCameraPosition() จะแสดงผลตำแหน่งตรงกลางของกล้อง

ดูข้อมูลเกี่ยวกับชุดการอัปเดตได้ที่ CameraUpdateFactory

พารามิเตอร์
อัปเดต การเปลี่ยนแปลงที่ควรนำไปใช้กับกล้อง

สาธารณะ โมฆะ animateCamera (การอัปเดต CameraUpdate, GoogleMap.CancelableCallback)

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

ในระหว่างที่ภาพเคลื่อนไหว การเรียกไปยัง getCameraPosition() จะแสดงผลตำแหน่งตรงกลางของกล้อง

พารามิเตอร์
อัปเดต การเปลี่ยนแปลงที่ควรนำไปใช้กับกล้อง
โค้ดเรียกกลับ โค้ดเรียกกลับที่จะเรียกใช้จากเธรด UI ของ Android เมื่อภาพเคลื่อนไหวหยุดลง หากภาพเคลื่อนไหวเสร็จสมบูรณ์ตามปกติจะมีการเรียก onFinish() ไม่เช่นนั้นจะมีการเรียก onCancel() อย่าอัปเดตหรือทำให้กล้องเคลื่อนไหวจากภายใน onCancel()

สาธารณะ โมฆะ animateCamera (การอัปเดตCameraUpdate, int periodMs, GoogleMap.CancelableCallback callback)

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

หากมีการเรียก getCameraPosition() ระหว่างที่ภาพเคลื่อนไหว วิดีโอจะแสดงตำแหน่งปัจจุบันของกล้องขณะทำงาน

พารามิเตอร์
อัปเดต
durationMs ระยะเวลาของภาพเคลื่อนไหว หน่วยเป็นมิลลิวินาที โดยต้องเป็นค่าบวกอย่างเคร่งครัด มิฉะนั้นมีการส่ง IllegalArgumentException
โค้ดเรียกกลับ โค้ดเรียกกลับ (ไม่บังคับ) ที่จะได้รับการแจ้งเตือนจากเทรด UI ของ Android เมื่อภาพเคลื่อนไหวหยุดลง หากภาพเคลื่อนไหวหยุดลงเนื่องจากเล่นจนจบตามปกติ ระบบจะแจ้งเตือนการเรียกกลับด้วย onFinish() หากภาพเคลื่อนไหวหยุดลงเนื่องจากการเคลื่อนไหวของกล้องหรือท่าทางสัมผัสของผู้ใช้หยุดชะงัก ระบบจะเรียกใช้ onCancel() โค้ดเรียกกลับไม่ควรพยายามย้ายหรือทำให้กล้องเคลื่อนไหวโดยใช้วิธีการยกเลิก หากไม่จำเป็นต้องเรียกกลับ ให้ปล่อยไว้เป็น null

โมฆะสาธารณะ ล้าง ()

ลบเครื่องหมาย โพลีไลน์ รูปหลายเหลี่ยม ภาพซ้อน ฯลฯ ทั้งหมดออกจากแผนที่

สาธารณะ CameraPosition getCameraPosition ()

ดึงตำแหน่งปัจจุบันของกล้อง

CameraPosition ที่แสดงผลเป็นสแนปชอตของตำแหน่งปัจจุบัน และจะไม่อัปเดตโดยอัตโนมัติเมื่อกล้องขยับ

ดูข้อมูลเพิ่มเติมเกี่ยวกับการเปลี่ยนตำแหน่งของกล้องได้ที่กล้องและมุมมอง

การคืนสินค้า
  • ตำแหน่งปัจจุบันของกล้อง

สาธารณะ IndoorBuilding getFocusedBuilding ()

รับอาคารที่โฟกัสอยู่ในปัจจุบัน

การคืนสินค้า
  • สิ่งปลูกสร้างที่โฟกัสอยู่ในปัจจุบัน หรือ null หากไม่มีโฟกัสสิ่งปลูกสร้าง

สาธารณะ int getMapType ()

รับประเภทแผนที่ที่กำลังแสดงอยู่ ดูค่าที่เป็นไปได้ใน MAP_TYPE_NORMAL, MAP_TYPE_SATELLITE, MAP_TYPE_TERRAIN

การคืนสินค้า
  • ประเภทแผนที่

Float สาธารณะ getMaxZoomLevel ()

แสดงระดับการซูมสูงสุดสำหรับตำแหน่งกล้องปัจจุบัน ซึ่งพิจารณาถึงประเภทแผนที่ที่กำลังใช้งานอยู่ เช่น ดาวเทียมหรือภูมิประเทศอาจมีระดับการซูมสูงสุดต่ำกว่าแผนที่ฐานย่อย

ดูข้อมูลเพิ่มเติมเกี่ยวกับการเปลี่ยนระดับการซูมของกล้องได้ที่กล้องและมุมมอง

การคืนสินค้า
  • ระดับการซูมสูงสุดที่มีในตําแหน่งกล้องปัจจุบัน

ทศนิยมสาธารณะ getMinZoomLevel ()

แสดงระดับการซูมต่ำสุด วิธีนี้เหมือนกันในทุกตำแหน่ง (ต่างจากระดับการซูมสูงสุด) แต่อาจแตกต่างกันไปตามอุปกรณ์และขนาดแผนที่

ดูข้อมูลเพิ่มเติมเกี่ยวกับการเปลี่ยนระดับการซูมของกล้องได้ที่กล้องและมุมมอง

การคืนสินค้า
  • ระดับการซูมขั้นต่ำที่ใช้ได้

สาธารณะ ตำแหน่ง getMyLocation ()

วิธีนี้เลิกใช้งานแล้ว
โปรดใช้ com.google.android.gms.location.FusedLocationProviderApi แทน FusedLocationProviderApi จะแสดงการค้นหาตำแหน่งและปริมาณการใช้พลังงานที่ได้รับการปรับปรุง และจุดสีน้ำเงิน "ตำแหน่งของฉัน" ก็นำมาใช้ ดูตัวอย่างโค้ดที่ MyLocationDemoActivity ในโฟลเดอร์แอปพลิเคชันตัวอย่าง หรือคู่มือนักพัฒนาซอฟต์แวร์ตำแหน่ง

แสดงผลตำแหน่งของผู้ใช้ที่แสดงในปัจจุบัน หรือแสดงผล null หากไม่มีข้อมูลตำแหน่ง

การคืนสินค้า
  • user location ที่แสดงอยู่ในปัจจุบัน
การขว้าง
IllegalStateException หากไม่ได้เปิดใช้เลเยอร์ตำแหน่งของฉัน

สาธารณะ การฉายภาพ getProjection ()

แสดงผลวัตถุ Projection ที่ใช้แปลงพิกัดหน้าจอและพิกัดละติจูด/ลองจิจูดได้

Projection ที่แสดงผลเป็นสแนปชอตของการฉายภาพปัจจุบัน และจะไม่อัปเดตโดยอัตโนมัติเมื่อกล้องเคลื่อนไหว เนื่องจากการดำเนินการนี้มีค่าใช้จ่ายสูง คุณจึงควรรับการฉายภาพเพียงครั้งเดียวต่อหน้าจอ Google Maps ใช้เส้นโครงเมอร์เคเตอร์เพื่อสร้างแผนที่จากข้อมูลทางภูมิศาสตร์และแปลงจุดบนแผนที่เป็นพิกัดทางภูมิศาสตร์

การคืนสินค้า
  • Projection ของแผนที่ในสถานะปัจจุบัน

สาธารณะ UiSettings getUiSettings ()

รับการตั้งค่าอินเทอร์เฟซผู้ใช้สำหรับแผนที่

การคืนสินค้า
  • UiSettings สำหรับแผนที่นี้

บูลีนสาธารณะ isBuildingsEnabled ()

แสดงผลว่ามีการเปิดใช้เลเยอร์สิ่งปลูกสร้าง 3 มิติหรือไม่

การคืนสินค้า
  • true หากเปิดใช้อาคาร มิเช่นนั้นให้ false

บูลีนสาธารณะ isIndoorEnabled ()

รับข้อมูลว่าแผนที่ในอาคารเปิดใช้งานอยู่หรือไม่

การคืนสินค้า
  • true หากเปิดใช้แผนที่ในอาคาร false หากปิดใช้แผนที่ในอาคาร

บูลีนสาธารณะ isMyLocationEnabled ()

รับสถานะของเลเยอร์ตำแหน่งของฉัน

การคืนสินค้า
  • true หากเปิดใช้เลเยอร์ตำแหน่งของฉันไว้ false มิฉะนั้น

บูลีนสาธารณะ isTrafficEnabled ()

ตรวจสอบว่าแผนที่ดึงข้อมูลการจราจรหรือไม่ ซึ่งขึ้นอยู่กับความพร้อมใช้งานของข้อมูลการเข้าชม

การคืนสินค้า
  • true หากเปิดใช้ข้อมูลการเข้าชม หรือ false ในกรณีอื่นๆ

สาธารณะ โมฆะ moveCamera (อัปเดต CameraUpdate)

เปลี่ยนตำแหน่งกล้องตามคำแนะนำที่ระบุไว้ในการอัปเดต การย้ายจะเกิดขึ้นทันทีและ getCameraPosition() ที่ตามมาจะแสดงตำแหน่งใหม่ ดูข้อมูลเกี่ยวกับชุดการอัปเดตได้ที่ CameraUpdateFactory

พารามิเตอร์
อัปเดต การเปลี่ยนแปลงที่ควรนำไปใช้กับกล้อง

สาธารณะ void resetMinMaxZoomPreference ()

นำขอบเขตการซูมบนและล่างที่ระบุไว้ก่อนหน้านี้ออก

โมฆะสาธารณะ setBuildingsEnabled (boolean enabled)

เปิดหรือปิดเลเยอร์สิ่งปลูกสร้าง 3 มิติ

พารามิเตอร์
เปิดใช้อยู่ true เพื่อเปิดใช้เลเยอร์สิ่งปลูกสร้าง 3 มิติ หรือ false เพื่อปิดใช้สิ่งปลูกสร้าง 3 มิติ

Public void setContentDescription (คำอธิบายสตริง)

ตั้งค่าคำอธิบายเนื้อหาสำหรับแผนที่

ซึ่งใช้ในการอธิบายแผนที่ในโหมดการช่วยเหลือพิเศษ ค่าเริ่มต้นคือ "Google Maps"

พารามิเตอร์
คำอธิบาย สตริงเพื่อใช้เป็นคำอธิบาย

บูลีนสาธารณะ setIndoorEnabled (boolean enabled)

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

พารามิเตอร์
เปิดใช้อยู่ true เพื่อพยายามเปิดใช้แผนที่ในอาคาร หรือ false เพื่อปิดใช้งานแผนที่ในอาคาร
การคืนสินค้า
  • เปิดใช้แผนที่ในอาคารได้ไหม

Public void setInfoWindowAdapter (อะแดปเตอร์ GoogleMap.InfoWindowAdapter)

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

สถานะนี้จะไม่เรียงอันดับกับแผนที่ เช่นเดียวกับ Listener เหตุการณ์ของแผนที่ หากมีการสร้างแผนที่อีกครั้ง (เช่น เนื่องจากการเปลี่ยนแปลงการกำหนดค่า) คุณต้องตรวจสอบว่าได้เรียกใช้เมธอดนี้อีกครั้งเพื่อรักษาการกำหนดค่าไว้

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

สาธารณะ void setLatLngBoundsForCameraTarget (LatLngBounds)

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

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

เมื่อ LatLngBounds เปลี่ยน SDK จะปรับการอัปเดตกล้องภายหลังทั้งหมดให้เป็นไปตามขอบเขตเหล่านั้นหากเป็นไปได้ โปรดทราบว่ามีข้อควรพิจารณาทางเทคนิคที่อาจป้องกันไม่ให้ SDK รักษาเป้าหมายของกล้องไว้ในขอบเขตอย่างเคร่งครัด เช่น ข้อผิดพลาดในการปัดเศษทศนิยมของจุดทศนิยมหรือระดับการซูมที่ต่ำมาก

พารามิเตอร์
ขอบเขต ขอบเขตที่จำกัดเป้าหมายของกล้อง

โมฆะสาธารณะ setLocationSource (แหล่งที่มา LocationSource)

แทนที่ต้นทางตำแหน่งของเลเยอร์ตำแหน่งของฉัน

พารามิเตอร์
source ที่มาของตำแหน่งที่จะใช้ในเลเยอร์ตำแหน่งของฉัน โปรดตั้งค่าเป็น null เพื่อใช้ต้นทางของตำแหน่งเริ่มต้น

บูลีน สาธารณะ setMapStyle (รูปแบบ MapStyleOptions)

ตั้งค่าการจัดรูปแบบของแผนที่ฐาน

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

ตั้งค่าเป็น Null เพื่อล้างการจัดรูปแบบที่กำหนดเองก่อนหน้านี้

พารามิเตอร์
รูปแบบ
การคืนสินค้า
  • true หากแยกวิเคราะห์สไตล์สำเร็จ false หากตรวจพบปัญหาเกี่ยวกับ MapStyleOptions ซึ่งรวมถึง JSON การจัดรูปแบบที่แยกวิเคราะห์ไม่ได้ ประเภทฟีเจอร์ที่ไม่รู้จัก ประเภทองค์ประกอบที่ไม่รู้จัก หรือคีย์ตัวจัดสไตล์ที่ไม่ถูกต้อง หากค่าผลลัพธ์คือ false สไตล์ปัจจุบันจะไม่เปลี่ยนแปลง

โมฆะสาธารณะ setMapType (ประเภท int)

ตั้งค่าประเภทของชิ้นส่วนแผนที่ที่จะแสดง ค่าที่อนุญาตมีดังนี้

พารามิเตอร์
ประเภท ประเภทแผนที่ที่จะแสดง

สาธารณะ void setMaxZoomPreference (float maxZoomPreference)

ตั้งค่าขอบเขตบนที่ต้องการสำหรับการซูมของกล้อง

เมื่อการซูมสูงสุดมีการเปลี่ยนแปลง SDK จะปรับการอัปเดตกล้องในภายหลังทั้งหมดให้สอดคล้องกับค่าสูงสุดดังกล่าว หากเป็นไปได้ โปรดทราบว่ามีข้อควรพิจารณาทางเทคนิคที่อาจทำให้ SDK อนุญาตให้ผู้ใช้ซูมแผนที่ลึกเกินไป เช่น ดาวเทียมหรือภูมิประเทศอาจมีการซูมสูงสุดต่ำกว่าชิ้นส่วนแผนที่ฐาน

SDK จะแก้ไขความขัดแย้งในค่าต่ำสุดและสูงสุด หากคุณตั้งค่าระดับการซูมขั้นต่ำให้เป็นระดับการซูมสูงสุดในปัจจุบัน SDK จะใช้ค่าต่ำสุดใหม่สำหรับทั้งค่าต่ำสุดและค่าสูงสุด หากคุณตั้งค่าระดับการซูมสูงสุดให้ต่ำกว่าค่าต่ำสุด SDK จะใช้ค่าสูงสุดใหม่สำหรับทั้งค่าต่ำสุดและสูงสุด เช่น สมมติว่าการซูมขั้นต่ำในปัจจุบันคือ 8 และสูงสุดคือ 14 จากนั้นตั้งค่าการซูมสูงสุดเป็น 6 SDK ใช้การซูมอย่างน้อย 6 และสูงสุด 6 อักขระ

พารามิเตอร์
maxZoomPreference ขอบเขตบนที่ต้องการ

สาธารณะ void setMinZoomPreference (Flo minZoomPreference)

ตั้งค่าขอบเขตล่างที่ต้องการสำหรับการซูมของกล้อง

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

SDK จะแก้ไขความขัดแย้งในค่าต่ำสุดและสูงสุด หากคุณตั้งค่าระดับการซูมขั้นต่ำให้เป็นระดับการซูมสูงสุดในปัจจุบัน SDK จะใช้ค่าต่ำสุดใหม่สำหรับทั้งค่าต่ำสุดและค่าสูงสุด หากคุณตั้งค่าระดับการซูมสูงสุดให้ต่ำกว่าค่าต่ำสุด SDK จะใช้ค่าสูงสุดใหม่สำหรับทั้งค่าต่ำสุดและสูงสุด เช่น สมมติว่าการซูมขั้นต่ำในปัจจุบันคือ 8 และสูงสุดคือ 14 จากนั้นตั้งค่าการซูมขั้นต่ำเป็น 16 SDK ใช้การซูมขั้นต่ำ 16 และซูมสูงสุด 16 อักขระ

พารามิเตอร์
minZoomPreference ขอบเขตล่างที่ต้องการ

สาธารณะ void setMyLocationEnabled (boolean enabled)

เปิดหรือปิดการใช้งานเลเยอร์ตำแหน่งของฉัน

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

หากต้องการใช้ฟีเจอร์เลเยอร์ตำแหน่งของฉัน คุณต้องขอสิทธิ์สำหรับ ACCESS_COARSE_LOCATION หรือ ACCESS_FINE_LOCATION เว้นแต่ว่าคุณได้ตั้งค่าแหล่งที่มาของตำแหน่งที่กำหนดเอง

หากคุณตั้งค่าแหล่งที่มาของตำแหน่งที่กำหนดเองผ่าน setLocationSource(LocationSource) Google Maps SDK สำหรับ Android จะไม่ตรวจสอบว่ามีการให้สิทธิ์ข้างต้นหรือไม่ อย่างไรก็ตาม คุณยังคงต้องตรวจสอบว่าผู้ใช้ได้ให้สิทธิ์ทั้งหมดที่จำเป็นสำหรับแหล่งที่มาของตำแหน่งที่กำหนดเองแล้ว

พารามิเตอร์
เปิดใช้อยู่ trueเพื่อเปิดใช้ falseเพื่อปิดใช้
การขว้าง
SecurityException หากไม่ได้ให้สิทธิ์เข้าถึงตำแหน่ง

สาธารณะ void setOnCameraChangeListener (ListenerGoogleMap.OnCameraChangeListener)

วิธีนี้เลิกใช้งานแล้ว
แทนที่โดย setOnCameraMoveStartedListener(GoogleMap.OnCameraMoveStartedListener), setOnCameraMoveListener(GoogleMap.OnCameraMoveListener), setOnCameraMoveCanceledListener(GoogleMap.OnCameraMoveCanceledListener) และ setOnCameraIdleListener(GoogleMap.OnCameraIdleListener)

ตั้งค่าโค้ดเรียกกลับที่เรียกใช้เมื่อเปลี่ยนกล้อง

พารามิเตอร์
Listener โค้ดเรียกกลับที่เรียกใช้เมื่อเปลี่ยนกล้อง หากต้องการยกเลิกการเรียกกลับ ให้ใช้ null

สาธารณะ void setOnCameraIdleListener (Listener GoogleMap.OnCameraIdleListener)

ตั้งค่าโค้ดเรียกกลับที่เรียกใช้เมื่อการเคลื่อนที่ของกล้องสิ้นสุด

พารามิเตอร์
Listener โค้ดเรียกกลับที่เรียกใช้ หากต้องการยกเลิกการเรียกกลับ ให้ใช้ null

สาธารณะ void setOnCameraMoveCanceledListener (Listener GoogleMap.OnCameraMoveCanceledListener)

ตั้งค่าโค้ดเรียกกลับที่เรียกให้แสดงเมื่อการเคลื่อนไหวของกล้องหยุดลงหรือขัดจังหวะโดยภาพเคลื่อนไหวประเภทใหม่

พารามิเตอร์
Listener โค้ดเรียกกลับที่เรียกใช้ หากต้องการยกเลิกการเรียกกลับ ให้ใช้ null อย่าอัปเดตหรือทำให้กล้องเคลื่อนไหวจากภายใน onCameraMoveCanceled()

โมฆะ สาธารณะ setOnCameraMoveListener (ListenerGoogleMap.OnCameraMoveListener)

ตั้งค่าโค้ดเรียกกลับที่มีการเรียกซ้ำๆ ขณะที่กล้องกำลังเคลื่อนที่ อาจมีการเรียกใช้โค้ดเรียกกลับบ่อยเท่ากับทุกเฟรมและไม่ควรใช้การดำเนินการที่มีค่าใช้จ่ายสูง

พารามิเตอร์
Listener โค้ดเรียกกลับที่เรียกใช้ หากต้องการยกเลิกการเรียกกลับ ให้ใช้ null

โมฆะ สาธารณะ setOnCameraMoveStartedListener (Listener GoogleMap.OnCameraMoveStartedListener)

ตั้งค่าโค้ดเรียกกลับที่ถูกเรียกให้แสดงเมื่อกล้องเริ่มเคลื่อนไหวหรือมีการเปลี่ยนแปลงเหตุผลในการเคลื่อนไหวของกล้อง

พารามิเตอร์
Listener โค้ดเรียกกลับที่เรียกใช้ หากต้องการยกเลิกการเรียกกลับ ให้ใช้ null อย่าอัปเดตหรือทำให้กล้องเคลื่อนไหวจากภายใน onCameraMoveStarted()

โมฆะสาธารณะ setOnCircleClickListener (ListenerGoogleMap.OnCircleClickListener)

ตั้งค่าโค้ดเรียกกลับที่เรียกใช้เมื่อมีการคลิกแวดวง

พารามิเตอร์
Listener การเรียกกลับที่เรียกใช้เมื่อมีการคลิกแวดวง หากต้องการยกเลิกการเรียกกลับ ให้ใช้ null

โมฆะสาธารณะ setOnGroundOverlayClickListener (ListenerGoogleMap.OnGroundOverlayClickListener)

ตั้งค่าโค้ดเรียกกลับที่เรียกใช้เมื่อมีการคลิกการวางซ้อนพื้นที่

พารามิเตอร์
Listener โค้ดเรียกกลับที่เกิดขึ้นเมื่อมีการคลิกการวางซ้อนพื้นที่ หากต้องการยกเลิกการเรียกกลับ ให้ใช้ null

โมฆะสาธารณะ setOnIndoorStateChangeListener (ListenerGoogleMap.OnIndoorStateChangeListener)

ตั้งค่าหรือล้างผู้ฟังสำหรับกิจกรรมในอาคาร ตั้งค่า Listener ได้เพียง 1 คนเท่านั้น การตั้งค่า Listener ใหม่จะนำ Listener ก่อนหน้าออก

พารามิเตอร์
Listener Listener สำหรับกิจกรรมในอาคารหากไม่ใช่ค่า Null มิเช่นนั้น ให้ล้าง Listener

โมฆะสาธารณะ setOnInfoWindowClickListener (Listener GoogleMap.OnInfoWindowClickListener)

ตั้งค่าโค้ดเรียกกลับที่เรียกใช้เมื่อมีการคลิกหน้าต่างข้อมูลเครื่องหมาย

พารามิเตอร์
Listener โค้ดเรียกกลับที่เรียกใช้เมื่อมีการคลิกหน้าต่างข้อมูลเครื่องหมาย หากต้องการยกเลิกการเรียกกลับ ให้ใช้ null

โมฆะ สาธารณะ setOnInfoWindowCloseListener (Listener GoogleMap.OnInfoWindowCloseListener)

ตั้งค่าโค้ดเรียกกลับที่เรียกใช้เมื่อปิดหน้าต่างข้อมูลของเครื่องหมาย

พารามิเตอร์
Listener การเรียกกลับที่เรียกใช้เมื่อหน้าต่างข้อมูลของเครื่องหมายปิด หากต้องการยกเลิกการเรียกกลับ ให้ใช้ null

โมฆะ สาธารณะ setOnInfoWindowLongClickListener (ListenerGoogleMap.OnInfoWindowLongClickListener)

ตั้งค่าโค้ดเรียกกลับที่เรียกใช้เมื่อกดหน้าต่างข้อมูลของเครื่องหมายค้างไว้

พารามิเตอร์
Listener โค้ดเรียกกลับที่เกิดขึ้นเมื่อกดหน้าต่างข้อมูลของเครื่องหมายค้างไว้ หากต้องการยกเลิกการเรียกกลับ ให้ใช้ null

โมฆะสาธารณะ setOnMapClickListener (Listener GoogleMap.OnMapClickListener)

ตั้งค่าโค้ดเรียกกลับที่เรียกใช้เมื่อแตะแผนที่

พารามิเตอร์
Listener โค้ดเรียกกลับที่เรียกใช้เมื่อแตะแผนที่ หากต้องการยกเลิกการเรียกกลับ ให้ใช้ null

โมฆะสาธารณะ setOnMapLoadedCallback (โค้ดเรียกกลับ GoogleMap.OnMapLoadedCallback)

ตั้งค่าโค้ดเรียกกลับที่เรียกใช้เมื่อแผนที่นี้แสดงผลเสร็จแล้ว ระบบจะเรียกใช้โค้ดเรียกกลับเพียงครั้งเดียว

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

พารามิเตอร์
โค้ดเรียกกลับ ระบบจะเรียกกลับเมื่อแผนที่แสดงผลเสร็จแล้ว หากต้องการยกเลิกการเรียกกลับ ให้ใช้ null

โมฆะสาธารณะ setOnMapLongClickListener (ListenerGoogleMap.OnMapLongClickListener)

ตั้งค่าโค้ดเรียกกลับที่เรียกใช้เมื่อกดแผนที่ค้างไว้

พารามิเตอร์
Listener การเรียกกลับที่เกิดขึ้นเมื่อกดแผนที่ค้างไว้ หากต้องการยกเลิกการเรียกกลับ ให้ใช้ null

โมฆะสาธารณะ setOnMarkerClickListener (Listener GoogleMap.OnMarkerClickListener)

ตั้งค่าโค้ดเรียกกลับที่เรียกใช้เมื่อมีการคลิกตัวทำเครื่องหมาย

พารามิเตอร์
Listener โค้ดเรียกกลับที่เรียกใช้เมื่อมีการคลิกตัวทำเครื่องหมาย หากต้องการยกเลิกการเรียกกลับ ให้ใช้ null

โมฆะสาธารณะ setOnMarkerDragListener (ListenerGoogleMap.OnMarkerDragListener)

ตั้งค่าโค้ดเรียกกลับที่เรียกใช้เมื่อมีการลากเครื่องหมาย

พารามิเตอร์
Listener โค้ดเรียกกลับที่ถูกเรียกใช้ในเหตุการณ์การลากเครื่องหมาย หากต้องการยกเลิกการเรียกกลับ ให้ใช้ null

โมฆะ สาธารณะ setOnMyLocationButtonClickListener (ListenerGoogleMap.OnMyLocationButtonClickListener)

ตั้งค่าโค้ดเรียกกลับที่เรียกใช้เมื่อมีการคลิกปุ่มตำแหน่งของฉัน

หาก listener แสดงผล true ระบบจะใช้เหตุการณ์และลักษณะการทำงานเริ่มต้นจะไม่เกิดขึ้น หากแสดงผล false การทำงานเริ่มต้นจะเกิดขึ้น (เช่น กล้องจะเคลื่อนไหวโดยให้กล้องอยู่ตรงกลางตำแหน่งของผู้ใช้)

พารามิเตอร์
Listener การเรียกกลับที่เกิดขึ้นเมื่อคลิกปุ่ม "ตำแหน่งของฉัน"

โมฆะสาธารณะ setOnMyLocationChangeListener (ListenerGoogleMap.OnMyLocationChangeListener)

วิธีนี้เลิกใช้งานแล้ว
โปรดใช้ com.google.android.gms.location.FusedLocationProviderApi แทน FusedLocationProviderApi จะแสดงการค้นหาตำแหน่งและปริมาณการใช้พลังงานที่ได้รับการปรับปรุง และจุดสีน้ำเงิน "ตำแหน่งของฉัน" ก็นำมาใช้ ดูตัวอย่างโค้ดที่ MyLocationDemoActivity ในโฟลเดอร์แอปพลิเคชันตัวอย่าง หรือคู่มือนักพัฒนาซอฟต์แวร์ตำแหน่ง

ตั้งค่าการเรียกกลับที่เรียกใช้เมื่อจุด ตำแหน่งของฉัน เปลี่ยนตำแหน่ง

พารามิเตอร์
Listener การเรียกกลับที่เกิดขึ้นเมื่อจุดตำแหน่งของฉันเปลี่ยนแปลง

โมฆะสาธารณะ setOnMyLocationClickListener (ListenerGoogleMap.OnMyLocationClickListener)

ตั้งค่าโค้ดเรียกกลับที่เรียกใช้เมื่อมีการคลิกจุด "ตำแหน่งของฉัน" (ซึ่งหมายถึงตำแหน่งของผู้ใช้)

พารามิเตอร์
Listener การเรียกกลับที่เรียกให้แสดงเมื่อมีการคลิกที่จุด "ตำแหน่งของฉัน"

โมฆะสาธารณะ setOnPoiClickListener (Listener GoogleMap.OnPoiClickListener)

ตั้งค่า Listener ที่จะถูกทริกเกอร์เมื่อมีการคลิกหรือแตะจุดที่น่าสนใจ

ผ่าน null เพื่อล้างผู้ฟัง

พารามิเตอร์
Listener

โมฆะสาธารณะ setOnPolygonClickListener (Listener GoogleMap.OnPolygonClickListener)

ตั้งค่าโค้ดเรียกกลับที่เรียกใช้เมื่อมีการคลิกรูปหลายเหลี่ยม

พารามิเตอร์
Listener โค้ดเรียกกลับที่ถูกเรียกใช้เมื่อมีการคลิกรูปหลายเหลี่ยม หากต้องการยกเลิกการเรียกกลับ ให้ใช้ null

โมฆะสาธารณะ setOnPolylineClickListener (Listener GoogleMap.OnPolylineClickListener)

ตั้งค่าโค้ดเรียกกลับที่เรียกใช้เมื่อมีการคลิกโพลีไลน์

พารามิเตอร์
Listener โค้ดเรียกกลับที่ถูกเรียกใช้เมื่อมีการคลิกโพลีไลน์ หากต้องการยกเลิกการเรียกกลับ ให้ใช้ null

Public void setPadding (int left, int top, int right, int below)

ตั้งค่าระยะห่างจากขอบบนแผนที่

วิธีนี้จะช่วยให้คุณกําหนดพื้นที่ที่มองเห็นได้บนแผนที่ เพื่อส่งสัญญาณให้แผนที่ทราบว่าบางส่วนของแผนที่รอบขอบอาจบดบัง โดยกําหนดระยะห่างจากขอบทั้ง 4 ด้านของแผนที่ ระบบจะปรับฟังก์ชันแผนที่ให้เข้ากับระยะห่างจากขอบ ตัวอย่างเช่น ตัวควบคุมการซูม เข็มทิศ ประกาศเกี่ยวกับลิขสิทธิ์ และโลโก้ Google จะย้ายไปให้พอดีกับพื้นที่ที่กำหนดไว้ การเคลื่อนที่ของกล้องจะสัมพันธ์กับจุดกึ่งกลางของส่วนที่มองเห็น เป็นต้น

พารามิเตอร์
ฝั่งซ้าย จำนวนพิกเซลของระยะห่างจากขอบที่จะเพิ่มทางด้านซ้ายของแผนที่
ครึ่งแรกของอินนิ่ง จำนวนพิกเซลของระยะห่างจากขอบที่จะเพิ่มที่ด้านบนของแผนที่
ฝั่งขวา จำนวนพิกเซลของระยะห่างจากขอบที่จะเพิ่มที่ด้านขวาของแผนที่
ครึ่งหลังของอินนิ่ง จำนวนพิกเซลของระยะห่างจากขอบที่จะเพิ่มที่ด้านล่างของแผนที่

โมฆะสาธารณะ setTrafficEnabled (boolean enabled)

เปิดหรือปิดเลเยอร์การจราจร

พารามิเตอร์
เปิดใช้อยู่

โมฆะสาธารณะ สแนปชอต (โค้ดเรียกกลับGoogleMap.SnapshotReadyCallback)

ถ่ายภาพของแผนที่

คุณสามารถใช้สแนปชอตภายในแอปพลิเคชันได้เมื่อแผนที่แบบอินเทอร์แอกทีฟใช้งานได้ยากหรือใช้ไม่ได้ เช่น รูปภาพที่สร้างขึ้นด้วยเมธอด snapshot() สามารถใช้เพื่อแสดงภาพขนาดย่อของแผนที่ในแอป หรือสแนปชอตในศูนย์การแจ้งเตือนได้

หมายเหตุ: ห้ามส่งรูปภาพของแผนที่ไปยังเซิร์ฟเวอร์ของคุณหรือใช้ภายนอกแอปพลิเคชัน หากคุณต้องการส่งแผนที่ไปยังแอปพลิเคชันหรือผู้ใช้อื่น ให้ส่งข้อมูลที่ช่วยให้ผู้ใช้เหล่านั้นสร้างแผนที่สำหรับผู้ใช้ใหม่แทนสแนปชอตได้

พารามิเตอร์
โค้ดเรียกกลับ มีการเรียกใช้เมธอดโค้ดเรียกกลับเมื่อมีการบันทึกสแนปชอต

โมฆะสาธารณะ snapshot (GoogleMap.SnapshotReadyCallback โค้ดเรียกกลับ, บิตแมปบิตแมป)

ถ่ายภาพของแผนที่

วิธีการนี้เทียบเท่ากับ snapshot(SnapshotReadyCallback) แต่คุณจะระบุ Bitmap ที่จัดสรรไว้ล่วงหน้าได้ หากบิตแมปไม่ตรงกับมิติข้อมูลปัจจุบันของแผนที่ ระบบจะจัดสรรบิตแมปอีกรายการหนึ่งที่พอดีกับขนาดของแผนที่

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

พารามิเตอร์
โค้ดเรียกกลับ มีการเรียกใช้เมธอดโค้ดเรียกกลับเมื่อมีการบันทึกสแนปชอต
บิตแมป บิตแมปที่จัดสรรไว้ล่วงหน้า หากเป็น null จะทำงานเหมือน snapshot(SnapshotReadyCallback)

โมฆะสาธารณะ stopAnimation ()

หยุดภาพเคลื่อนไหวของกล้อง หากมีภาพใดกำลังดำเนินอยู่ เมื่อมีการเรียกใช้เมธอด กล้องจะหยุดเคลื่อนที่ทันทีและจะยังคงอยู่ในตำแหน่งนั้น