นี่คือคลาสหลักของ Google Maps SDK สําหรับ Android และเป็นจุดเริ่มต้นสําหรับเมธอดทั้งหมดที่เกี่ยวข้องกับแผนที่ คุณสร้างอินสแตนซ์ GoogleMap
โดยตรงไม่ได้ แต่ต้องรับค่าจากเมธอด getMapAsync()
ใน MapFragment
หรือ MapView
ที่เพิ่มลงในแอปพลิเคชัน
หมายเหตุ: อ่าน GoogleMap
จากเธรด UI ของ Android ได้เท่านั้นเหมือนกับออบเจ็กต์ View
การเรียกใช้เมธอด GoogleMap
รายการจากเทรดอื่นจะทําให้ได้รับข้อยกเว้น
คุณสามารถปรับมุมมองของแผนที่ได้โดยการเปลี่ยนตําแหน่งของกล้อง (ตรงกันข้ามกับการย้ายแผนที่) คุณใช้กล้องของแผนที่เพื่อตั้งค่าพารามิเตอร์ได้ เช่น ตําแหน่ง ระดับการซูม มุมเอียง และทิศทาง ดูข้อมูลเพิ่มเติมได้ที่กล้องและมุมมอง
คู่มือนักพัฒนา
ในการเริ่มต้นใช้งาน ให้อ่านคู่มือนักพัฒนาซอฟต์แวร์ Google Maps SDK สําหรับ Android
สรุปชั้นเรียนที่ฝังไว้
ที่ปรับปรุงใหม่ | GoogleMap.Cancelable Callback | อินเทอร์เฟซการโทรกลับสําหรับการรายงานเมื่องานเสร็จสิ้นหรือถูกยกเลิก | |
ที่ปรับปรุงใหม่ | GoogleMap.InfoWindowAdapter | ให้การแสดงผลสําหรับการแสดงผลหน้าต่างข้อมูลที่กําหนดเอง | |
ที่ปรับปรุงใหม่ | GoogleMap.OnCameraChangeListener |
อินเทอร์เฟซนี้เลิกใช้งานแล้ว
แทนที่โดย GoogleMap.OnCameraMoveStartedListener , GoogleMap.OnCameraMoveListener และ GoogleMap.OnCameraIdleListener ไม่มีการกําหนดลําดับคําสั่งเมธอด onCameraChange ที่เลิกใช้งานแล้วที่เกี่ยวข้องกับเมธอดใน Listener การเปลี่ยนแปลงกล้องใหม่
|
|
ที่ปรับปรุงใหม่ | GoogleMap.OnCameraIdleListener | อินเทอร์เฟซสําหรับโทรกลับเมื่อการเคลื่อนไหวของกล้องสิ้นสุดลง | |
ที่ปรับปรุงใหม่ | GoogleMap.OnCameraMoveCanceledListener | อินเทอร์เฟซสําหรับเรียกกลับสําหรับกรณีที่กล้องหยุดทํางานหรือเมื่อกล้องเริ่มเคลื่อนไหวด้วยเหตุผลใหม่ | |
ที่ปรับปรุงใหม่ | GoogleMap.OnCameraMoveListener | อินเทอร์เฟซสําหรับเรียกกลับสําหรับกรณีที่กล้องเปลี่ยนตําแหน่ง | |
ที่ปรับปรุงใหม่ | GoogleMap.OnCameraMoveStartedListener | อินเทอร์เฟซเรียกกลับสําหรับเวลาเริ่มการเคลื่อนไหวกล้อง | |
ที่ปรับปรุงใหม่ | GoogleMap.OnCircleClickListener | อินเทอร์เฟซสําหรับเรียกกลับเมื่อมีการคลิกวงกลม | |
ที่ปรับปรุงใหม่ | GoogleMaps.OnGroundโฆษณาซ้อนทับสําหรับ ClickListener | อินเทอร์เฟซเรียกกลับเมื่อมีการคลิกการวางซ้อนพื้น | |
ที่ปรับปรุงใหม่ | GoogleMap.OnIndoorStateChangeListener | ผู้ฟังเมื่อสถานะภายในอาคารเปลี่ยนไป | |
ที่ปรับปรุงใหม่ | GoogleMap.OnInfoWindowClickListener | อินเทอร์เฟซเรียกกลับสําหรับเหตุการณ์คลิก/แตะบนหน้าต่างข้อมูลของตัวทําเครื่องหมาย #39 | |
ที่ปรับปรุงใหม่ | GoogleMap.OnInfoWindowCloseListener | อินเทอร์เฟซโค้ดเรียกกลับสําหรับเหตุการณ์ปิดในหน้าต่างข้อมูลของเครื่องหมาย #39 | |
ที่ปรับปรุงใหม่ | GoogleMap.OnInfoWindowLengthClickListener | โค้ดเรียกกลับสําหรับกรณีที่ผู้ใช้กดค้างที่หน้าต่างเครื่องหมายเครื่องหมาย #39 | |
ที่ปรับปรุงใหม่ | GoogleMap.On MapClickListener | อินเทอร์เฟซสําหรับโทรกลับเมื่อผู้ใช้แตะบนแผนที่ | |
ที่ปรับปรุงใหม่ | GoogleMap.OnMapLoadedCallback | โค้ดเรียกกลับสําหรับกรณีที่แผนที่แสดงผลเสร็จแล้ว | |
ที่ปรับปรุงใหม่ | GoogleMap.OnMapLengthClickListener | โค้ดเรียกกลับสําหรับกรณีที่ผู้ใช้กดค้างบนแผนที่ | |
ที่ปรับปรุงใหม่ | GoogleMap.OnMarkerClickListener | กําหนดลายเซ็นสําหรับวิธีที่เรียกใช้เมื่อมีการคลิกหรือแตะที่ตัวทําเครื่องหมาย | |
ที่ปรับปรุงใหม่ | GoogleMap.OnMarkerลากListener | อินเทอร์เฟซเรียกกลับสําหรับเหตุการณ์ลากบนตัวทําเครื่องหมาย | |
ที่ปรับปรุงใหม่ | GoogleMap.OnMyLocationButtonClickListener | อินเทอร์เฟซสําหรับเรียกกลับเมื่อมีการคลิกปุ่ม "ตําแหน่งของฉัน" | |
ที่ปรับปรุงใหม่ | GoogleMap.OnMyLocationChangeListener | อินเทอร์เฟซนี้เลิกใช้งานแล้ว ใช้ com.google.android.gms.location.FusedLocationProviderApi แทน FusedLocationProviderApi ปรับปรุงการค้นหาตําแหน่งและการใช้พลังงานให้ดียิ่งขึ้น โดยใช้ จุด "My Location" สีน้ําเงิน ดูบทแนะนําการเลือกสถานที่ปัจจุบัน ซึ่งใช้ FusedLocationProviderApi หรือคู่มือนักพัฒนาซอฟต์แวร์ตําแหน่ง | |
ที่ปรับปรุงใหม่ | GoogleMap.OnMyLocationClickListener | อินเทอร์เฟซเรียกกลับเมื่อมีการคลิกจุด "ตําแหน่งของฉัน" (ซึ่งแสดงตําแหน่งของผู้ใช้) | |
ที่ปรับปรุงใหม่ | GoogleMaps.OnPoiClickListener | ผู้ฟังสําหรับแตะจุดที่น่าสนใจ | |
ที่ปรับปรุงใหม่ | GoogleMap.OnPolygonClickListener | อินเทอร์เฟซเรียกกลับเมื่อมีการคลิกรูปหลายเหลี่ยม | |
ที่ปรับปรุงใหม่ | GoogleMap.OnPolylineClickListener | อินเทอร์เฟซเรียกกลับเมื่อมีการคลิกโพลีไลน์ | |
ที่ปรับปรุงใหม่ | GoogleMaps.SnapshotReadyCallback | อินเทอร์เฟซเรียกกลับเพื่อแจ้งเตือนเมื่อถ่ายภาพสแนปชอต |
สรุปแบบคงที่
int | MAP_TYPE_HBRBR | แผนที่ดาวเทียมที่มีเลเยอร์ถนนสายหลักแบบโปร่งใส |
int | ประเภทแผนที่ [ONE_TYPE_NONE] | ไม่มีแผนที่ย่อยพื้นฐาน |
int | ประเภทแผนที่ [RMA_TYPE] | แผนที่พื้นฐาน |
int | MAP_TYPE_ดาวเทียม | แผนที่ดาวเทียมที่ไม่มีป้ายกํากับ |
int | MAP_TYPE_TERRAIN | แผนที่ภูมิประเทศ |
สรุปเมธอดสาธารณะ
วงกลม | |
Groundground | |
เครื่องหมาย | |
รูปหลายเหลี่ยม | |
เส้นประกอบ | |
การวางซ้อนภาพแทน | |
เป็นโมฆะ |
animateCamera(อัปเดต CameraUpdate)
เคลื่อนไหวกล้องจากตําแหน่งปัจจุบันไปยังตําแหน่งที่กําหนดไว้ในการอัปเดต
|
เป็นโมฆะ |
animateCamera(การอัปเดต CameraUpdate, GoogleMaps.CancelableCallback (การเรียกกลับ)
สร้างภาพเคลื่อนไหวให้กล้องเคลื่อนไหวจากตําแหน่งปัจจุบันไปยังตําแหน่งที่ระบุไว้ในการอัปเดต และเรียกโค้ดเรียกกลับที่ไม่บังคับ
|
เป็นโมฆะ |
animatecamera(การอัปเดต CameraCamera, int ระยะเวลาMs, GoogleMaps.CancelableCallback)
ย้ายแผนที่ตามการอัปเดตด้วยภาพเคลื่อนไหวตามระยะเวลาที่ระบุ และเรียกโค้ดเรียกกลับที่ไม่บังคับเมื่อเสร็จสมบูรณ์
|
เป็นโมฆะ |
ล้าง()
นําเครื่องหมาย เส้นประกอบ รูปหลายเหลี่ยม การวางซ้อน ทั้งหมดออกจากแผนที่
|
ตําแหน่งกล้อง |
getCameraPosition()
รับตําแหน่งปัจจุบันของกล้อง
|
อาคารในอาคาร |
getโฟกัสedอาคาร()
รับสิ่งปลูกสร้างที่โฟกัสในปัจจุบัน
|
int |
getMapType()
เรียกดูประเภทแผนที่ที่แสดงอยู่ในปัจจุบัน
|
จำนวนลอยตัว |
getMaxZoomLevel()
แสดงผลระดับการซูมสูงสุดสําหรับตําแหน่งกล้องปัจจุบัน
|
จำนวนลอยตัว |
getMinZoomLevel()
แสดงระดับการซูมขั้นต่ํา
|
ประเทศ |
getMyLocation()
วิธีการนี้เลิกใช้งานแล้ว
ใช้ com.google.android.gms.location.FusedLocationProviderApi แทน
FusedLocationProviderApi ปรับปรุงการค้นหาตําแหน่งและการใช้พลังงานให้ดียิ่งขึ้น โดยใช้
จุด "My Location" สีน้ําเงิน ดู MyLocationDemoActivity ในโฟลเดอร์ตัวอย่างแอปพลิเคชัน หรือดูตัวอย่างได้ในคู่มือนักพัฒนาซอฟต์แวร์ตําแหน่ง
|
การคาดคะเน |
getProjection()
แสดงผลออบเจ็กต์
Projection ที่คุณสามารถใช้เพื่อแปลงระหว่างพิกัดหน้าจอและพิกัดละติจูดและลองจิจูด |
การตั้งค่า UI |
getUiSettings()
รับการตั้งค่าอินเทอร์เฟซผู้ใช้สําหรับแผนที่
|
บูลีน |
isBuildingsEnabled()
แสดงผลเลือกว่าจะเปิดใช้งานเลเยอร์สิ่งปลูกสร้าง 3 มิติหรือไม่
|
บูลีน |
isIndoorEnabled()
รับที่ระบุว่าแผนที่ในอาคารเปิดใช้อยู่หรือไม่
|
บูลีน |
isMyLocationEnabled()
รับสถานะของเลเยอร์ตําแหน่งของฉัน
|
บูลีน |
isTrafficEnabled()
ตรวจสอบว่าแผนที่กําลังดึงข้อมูลการจราจรหรือไม่
|
เป็นโมฆะ | |
เป็นโมฆะ |
resetMinMaxZoomPreferences()
นําขอบเขตการซูมด้านบนและด้านล่างที่ระบุไว้ก่อนหน้านี้ออก
|
เป็นโมฆะ |
setbuildingsEnabled(เปิดใช้บูลีน)
เปิดหรือปิดเลเยอร์สิ่งปลูกสร้าง 3 มิติ
|
เป็นโมฆะ |
setContentDescription(คําอธิบายสตริง)
ตั้งค่า contentDescription สําหรับแผนที่
|
บูลีน |
setIndoorEnabled(เปิดใช้บูลีน)
ตั้งค่าว่าควรเปิดใช้แผนที่ในอาคารหรือไม่
|
เป็นโมฆะ |
setInfoWindowAdapter(GoogleMap.InfoWindowAdapterอะแดปเตอร์)
ตั้งค่าตัวแสดงผลที่กําหนดเองสําหรับเนื้อหาของหน้าต่างข้อมูล
|
เป็นโมฆะ |
setLatLngBoundsForCameraTarget(ขอบเขต LatLngBounds)
ระบุ LatLngBounds เพื่อจํากัดเป้าหมายของกล้อง ดังนั้นเมื่อผู้ใช้เลื่อนและเลื่อนแผนที่ เป้าหมายของกล้องจะไม่เคลื่อนที่ออกนอกขอบเขตเหล่านี้
|
เป็นโมฆะ | |
บูลีน | |
เป็นโมฆะ |
setMapType(ประเภท int)
กําหนดประเภทของชิ้นส่วนแผนที่ที่ควรแสดง
|
เป็นโมฆะ |
setMaxZoomPreferences(ลําดับ maxZoomPreferences)
ตั้งค่าขอบเขตบนที่ต้องการสําหรับการซูมของกล้อง
|
เป็นโมฆะ |
setMinZoomPreferences(ทศนิยมขั้นต่ําการซูม)
ตั้งค่าขอบเขตด้านล่างที่ต้องการสําหรับการซูมของกล้อง
|
เป็นโมฆะ |
setMyLocationEnabled(เปิดใช้บูลีน)
เปิดหรือปิดใช้เลเยอร์ตําแหน่งของฉัน
|
เป็นโมฆะ | |
เป็นโมฆะ |
setOnCameraIdleListener(Listener ของ GoogleMap.OnCameraIdleListener)
ตั้งค่าโค้ดเรียกกลับที่เรียกใช้เมื่อการเคลื่อนไหวของกล้องสิ้นสุดลง
|
เป็นโมฆะ |
setOnCameraMoveCanceledListener(ผู้ฟัง GoogleMap.OnCameraMoveCanceledListener)
ตั้งค่าโค้ดเรียกกลับที่จะเรียกใช้เมื่อภาพเคลื่อนไหวของกล้องหยุดหรือถูกขัดจังหวะโดยภาพเคลื่อนไหวประเภทใหม่
|
เป็นโมฆะ |
setOnCameraMoveListener (ผู้ฟัง GoogleMap.OnCameraMoveListener)
ตั้งค่าโค้ดเรียกกลับที่เรียกใช้ซ้ําๆ ขณะที่กล้องกําลังเคลื่อนไหว
|
เป็นโมฆะ |
setOnCameraMoveStartedListener (ผู้ฟัง GoogleMap.OnCameraMoveStartedListener)
ตั้งค่าโค้ดเรียกกลับที่มีการเรียกใช้เมื่อกล้องเริ่มเคลื่อนไหวหรือสาเหตุที่การเคลื่อนไหวของกล้องมีการเปลี่ยนแปลง
|
เป็นโมฆะ |
setOnCircleClickListener (ผู้ฟัง GoogleMap.OnCircleClickListener)
ตั้งค่าโค้ดเรียกกลับที่จะเรียกใช้เมื่อมีการคลิกวงกลม
|
เป็นโมฆะ |
setOnGroundโฆษณาซ้อนทับสําหรับ ClickListener (Listener ของ GoogleMap.OnGroundโฆษณาซ้อนทับสําหรับ ClickListener)
ตั้งค่าโค้ดเรียกกลับที่มีการเรียกใช้เมื่อมีการคลิกการวางซ้อนพื้น
|
เป็นโมฆะ |
setOnIndoorStateChangeListener(ผู้ฟัง GoogleMap.OnIndoorStateChangeListener)
ตั้งค่าหรือล้าง Listener สําหรับเหตุการณ์ในร่ม
|
เป็นโมฆะ |
setOnInfoWindowClickListener(Listener ของ GoogleMap.OnInfoWindowClickListener)
ตั้งค่าโค้ดเรียกกลับที่เรียกใช้เมื่อมีการคลิกที่หน้าต่างข้อมูลเครื่องหมาย
|
เป็นโมฆะ |
setOnInfoWindowCloseListener(GoogleMaps.OnInfoWindowCloseListener)
ตั้งค่าโค้ดเรียกกลับที่จะเรียกใช้เมื่อหน้าต่างข้อมูลของเครื่องหมายปิดอยู่
|
เป็นโมฆะ |
setOnInfoWindowLengthClickListener(ผู้ฟัง GoogleMap.OnInfoWindowแบบยาวClickListener)
ตั้งค่าโค้ดเรียกกลับที่เรียกใช้เมื่อหน้าต่างข้อมูลของเครื่องหมายถูกกดค้าง
|
เป็นโมฆะ |
setOn MapClickListener(ผู้ฟัง GoogleMap.On MapClickListener)
ตั้งค่าการโทรกลับที่เรียกใช้เมื่อแตะแผนที่
|
เป็นโมฆะ |
setOn MapLoadedCallback(Google Map.On MapLoadedCallback เรียกกลับ)
ตั้งค่าโค้ดเรียกกลับที่เรียกใช้เมื่อแผนที่นี้แสดงภาพเสร็จแล้ว
|
เป็นโมฆะ |
setOnMapLengthClickListener(ผู้ฟัง GoogleMap.On MaplongClickListener)
ตั้งค่าโค้ดเรียกกลับที่เรียกใช้เมื่อมีการกดแผนที่ค้างไว้
|
เป็นโมฆะ |
setOnMarkerClickListener(Listener ของ GoogleMap.OnMarkerClickListener)
ตั้งค่าโค้ดเรียกกลับที่มีการเรียกใช้เมื่อมีการคลิกเครื่องหมาย
|
เป็นโมฆะ |
setOnMarkerลากListener (ผู้ฟัง GoogleMap.OnMarker DragListener)
ตั้งค่าโค้ดเรียกกลับที่มีการเรียกใช้เมื่อมีการลากเครื่องหมาย
|
เป็นโมฆะ |
setOnMyLocationButtonClickListener(ผู้ฟัง GoogleMap.OnMyLocationButtonClickListener)
ตั้งค่าโค้ดเรียกกลับที่มีการเรียกใช้เมื่อมีการคลิกปุ่มตําแหน่งของฉัน
|
เป็นโมฆะ |
setOnMyLocationChangeListener(ผู้ฟัง GoogleMap.OnMyLocationChangeListener)
วิธีการนี้เลิกใช้งานแล้ว
ใช้ com.google.android.gms.location.FusedLocationProviderApi แทน
FusedLocationProviderApi ปรับปรุงการค้นหาตําแหน่งและการใช้พลังงานให้ดียิ่งขึ้น โดยใช้
จุด "My Location" สีน้ําเงิน ดู MyLocationDemoActivity ในโฟลเดอร์ตัวอย่างแอปพลิเคชัน หรือดูตัวอย่างได้ในคู่มือนักพัฒนาซอฟต์แวร์ตําแหน่ง
|
เป็นโมฆะ |
setOnMyLocationClickListener(Listener ของ GoogleMap.OnMyLocationClickListener)
ตั้งค่าโค้ดเรียกกลับที่มีการเรียกใช้เมื่อมีการคลิกจุด "ตําแหน่งของฉัน" (ซึ่งหมายถึงตําแหน่งของผู้ใช้)
|
เป็นโมฆะ |
setOnPoiClickListener(Listener ของ GoogleMap.OnPoiClickListener)
กําหนด Listener ที่จะทริกเกอร์เมื่อมีการคลิกหรือแตะจุดที่น่าสนใจ
|
เป็นโมฆะ |
setOnPolygonClickListener(ผู้ฟัง GoogleMap.OnPolygonClickListener)
ตั้งค่าโค้ดเรียกกลับที่มีการเรียกใช้เมื่อมีการคลิกรูปหลายเหลี่ยม
|
เป็นโมฆะ |
setOnPolylineClickListener(ผู้ฟัง GoogleMap.OnPolylineClickListener)
ตั้งค่าโค้ดเรียกกลับที่มีการเรียกใช้เมื่อมีการคลิกโพลีไลน์
|
เป็นโมฆะ |
setPaving(int left, inttop, int right, int down)
กําหนดระยะห่างจากขอบในแผนที่
|
เป็นโมฆะ |
settrafficEnabled(เปิดใช้บูลีน)
เปิดหรือปิดเลเยอร์การจราจร
|
เป็นโมฆะ | |
เป็นโมฆะ | |
เป็นโมฆะ |
stopAnimation()
หยุดภาพเคลื่อนไหวของกล้องหากมีกําลังดําเนินการอยู่
|
สรุปเมธอดที่รับค่ามา
ค่าคงที่
สาธารณะ คงที่ สุดท้าย MAP_TYPE_HYBRID
แผนที่ดาวเทียมที่มีเลเยอร์ถนนสายหลักแบบโปร่งใส
คงที่ สุดท้าย in MAP_TYPE_NONE
ไม่มีแผนที่ย่อยพื้นฐาน
คงที่ สุดท้าย in MAP_TYPE_NORMAL
แผนที่พื้นฐาน
สาธารณะ คงที่ สุดท้าย MAP_TYPE_SATELLITE
แผนที่ดาวเทียมที่ไม่มีป้ายกํากับ
คงที่ สุดท้าย in MAP_TYPE_TERRAIN
แผนที่ภูมิประเทศ
วิธีการสาธารณะ
สาธารณะ วงกลม addCircle (ตัวเลือก วงกลมตัวเลือก)
เพิ่มวงกลมลงในแผนที่นี้
พารามิเตอร์
ตัวเลือก | ออบเจ็กต์ตัวเลือกแวดวงซึ่งกําหนดวิธีแสดงวงกลม |
---|
การคืนสินค้า
- ออบเจ็กต์
Circle
ที่เพิ่มลงในแผนที่แล้ว
สาธารณะ Groundโฆษณาซ้อนทับ addGroundโฆษณาซ้อนทับ (ตัวเลือกการวางซ้อนการวางซ้อน)
เพิ่มรูปภาพลงในแผนที่นี้
พารามิเตอร์
ตัวเลือก | ออบเจ็กต์ตัวเลือกการวางซ้อนแบบกําหนดพื้นซึ่งกําหนดวิธีแสดงผลการวางซ้อน ตัวเลือกต้องมีรูปภาพ (AnchoredBitmap) และตําแหน่ง |
---|
การคืนสินค้า
GroundOverlay
ที่เพิ่มลงในแผนที่แล้ว
ผ้าคลุม
ข้อยกเว้นอาร์กิวเมนต์ไม่ถูกต้อง | หากไม่มีการระบุรูปภาพหรือตําแหน่งในตัวเลือก |
---|
สาธารณะ Marker addMarker (MarkerOptions ตัวเลือก)
เพิ่มเครื่องหมายลงในแผนที่นี้
ไอคอนเครื่องหมายแสดงผลบนแผนที่ที่ตําแหน่ง Mark.position การคลิกที่เครื่องหมายจะวางตําแหน่งกล้องให้อยู่ตรงกลางเครื่องหมาย หากมีการกําหนด Mark.title ไว้ แผนที่จะแสดงกล่องข้อมูลพร้อมด้วยชื่อและตัวอย่างเครื่องหมาย หากหมุดสามารถลากได้ ให้คลิกค้างไว้แล้วลากเครื่องหมายเพื่อย้าย
พารามิเตอร์
ตัวเลือก | ออบเจ็กต์ตัวเลือกเครื่องหมายที่กําหนดวิธีแสดงผลเครื่องหมาย |
---|
การคืนสินค้า
Marker
ที่เพิ่มลงในแผนที่แล้ว
สาธารณะ Polygon addPolygon (ตัวเลือกของ PolygonOptions)
เพิ่มรูปหลายเหลี่ยมลงในแผนที่นี้
พารามิเตอร์
ตัวเลือก | ออบเจ็กต์ตัวเลือกรูปหลายเหลี่ยมที่กําหนดวิธีแสดงผลรูปหลายเหลี่ยม |
---|
การคืนสินค้า
- ออบเจ็กต์
Polygon
ที่เพิ่มลงในแผนที่
สาธารณะ Polyline addPolyline (PolylineOptions ตัวเลือก)
เพิ่มเส้นประกอบในแผนที่นี้
พารามิเตอร์
ตัวเลือก | ออบเจ็กต์ตัวเลือกโพลีไลน์ที่กําหนดวิธีแสดงโพลีไลน์ |
---|
การคืนสินค้า
- ออบเจ็กต์
Polyline
ที่เพิ่มลงในแผนที่แล้ว
สาธารณะ Tileโฆษณาซ้อนทับ addTileโฆษณาซ้อนทับ (ตัวเลือก Tileโฆษณาซ้อนทับตัวเลือก)
เพิ่มการวางซ้อนชิ้นส่วนในแผนที่นี้ ดูข้อมูลเพิ่มเติมที่TileOverlay
โปรดทราบว่าเมื่อสร้างแผนที่ใหม่ ผู้คนจะไม่ได้รับการวางซ้อนโดยอัตโนมัติ และต้องเพิ่มใหม่ด้วยตนเอง ซึ่งต่างจากการวางซ้อนอื่นๆ
พารามิเตอร์
ตัวเลือก | ออบเจ็กต์ตัวเลือกการวางซ้อนแบบชิ้นส่วนซึ่งกําหนดวิธีแสดงผลการวางซ้อน ตัวเลือกต้องมี TileProvider ที่ระบุ มิเช่นนั้น IllegalArgumentException จะถูกโยน |
---|
การคืนสินค้า
TileOverlay
ที่เพิ่มลงในแผนที่แล้ว
ผ้าคลุม
ข้อยกเว้นอาร์กิวเมนต์ไม่ถูกต้อง | หากไม่ได้ระบุ TileProvider ในตัวเลือก
|
---|
สาธารณะ null animateCamera (CameraUpdate อัปเดต)
เคลื่อนไหวกล้องจากตําแหน่งปัจจุบันไปยังตําแหน่งที่กําหนดไว้ในการอัปเดต ในระหว่างภาพเคลื่อนไหว จะมีการเรียก getCameraPosition()
กลับมายังตําแหน่งของกล้อง
ดูCameraUpdateFactory
ชุดการอัปเดต
พารามิเตอร์
อัปเดต | การเปลี่ยนแปลงที่ควรใช้กับกล้อง |
---|
สาธารณะ null animateCamera (CameraUpdate อัปเดต, GoogleMap.CancelableCallback โค้ดเรียกกลับ)
สร้างภาพเคลื่อนไหวให้กล้องเคลื่อนไหวจากตําแหน่งปัจจุบันไปยังตําแหน่งที่ระบุไว้ในการอัปเดต และเรียกโค้ดเรียกกลับที่ไม่บังคับ ดูCameraUpdateFactory
ชุดการอัปเดต
ในระหว่างภาพเคลื่อนไหว จะมีการเรียก getCameraPosition()
กลับมายังตําแหน่งของกล้อง
พารามิเตอร์
อัปเดต | การเปลี่ยนแปลงที่ควรใช้กับกล้อง |
---|---|
โค้ดเรียกกลับ | โค้ดเรียกกลับที่จะเรียกใช้จากชุดข้อความ Android UI เมื่อภาพเคลื่อนไหวหยุดลง หากภาพเคลื่อนไหวเสร็จสมบูรณ์โดยอัตโนมัติ ระบบจะเรียก onFinish() มิเช่นนั้น ระบบจะเรียกใช้ onCancel() อย่าอัปเดตหรือทําให้กล้องเคลื่อนไหวจากภายใน onCancel()
|
สาธารณะ null animateCamera (CameraUpdate อัปเดต, intdurationMs, GoogleMaps.CancelableCallback การติดต่อกลับ)
ย้ายแผนที่ตามการอัปเดตด้วยภาพเคลื่อนไหวตามระยะเวลาที่ระบุ และเรียกโค้ดเรียกกลับที่ไม่บังคับเมื่อเสร็จสมบูรณ์ ดูCameraUpdateFactory
ชุดการอัปเดต
หากมีการเรียก getCameraPosition()
ระหว่างที่ภาพเคลื่อนไหวให้แสดง ระบบจะแสดงตําแหน่งปัจจุบันของกล้อง
พารามิเตอร์
อัปเดต | |
---|---|
ระยะเวลา M | ระยะเวลาของภาพเคลื่อนไหวในหน่วยมิลลิวินาที ต้องเป็นค่าบวกเท่านั้น มิเช่นนั้น IllegalArgumentException จะถูกโยน
|
โค้ดเรียกกลับ | โค้ดเรียกกลับที่ไม่บังคับที่จะได้รับการแจ้งเตือนจากชุดข้อความของ Android UI เมื่อภาพเคลื่อนไหวหยุดลง หากภาพเคลื่อนไหวหยุดลงเนื่องจากการทํางานตามปกติจะแจ้งให้ onFinish() โทรกลับ หากภาพเคลื่อนไหวหยุดลงเพราะการเคลื่อนไหวของกล้องหรือท่าทางสัมผัสของผู้ใช้ภายหลังมีการเรียก onCancel() โค้ดเรียกกลับไม่ควรพยายามย้ายหรือสร้างภาพเคลื่อนไหวของกล้องเมื่อมีการยกเลิก หากไม่จําเป็นต้องใช้โค้ดเรียกกลับ ให้ปล่อยไว้เป็น null |
สาธารณะ null ล้าง ()
นําเครื่องหมาย เส้นประกอบ รูปหลายเหลี่ยม การวางซ้อน ทั้งหมดออกจากแผนที่
สาธารณะ CameraPosition getCameraPosition ()
รับตําแหน่งปัจจุบันของกล้อง
CameraPosition
ที่แสดงกลับมาคือภาพรวมของตําแหน่งปัจจุบัน และจะไม่อัปเดตโดยอัตโนมัติเมื่อกล้องขยับ
ดูข้อมูลเพิ่มเติมเกี่ยวกับการเปลี่ยนตําแหน่งของกล้องได้ที่กล้องและมุมมอง
การคืนสินค้า
- ตําแหน่งปัจจุบันของกล้อง
สาธารณะ ในอาคาร getโฟกัสedBuilding ()
รับสิ่งปลูกสร้างที่โฟกัสในปัจจุบัน
การคืนสินค้า
- อาคารที่โฟกัสอยู่ในตอนนี้หรือ
null
หากอาคารไม่โฟกัส
สาธารณะ in get MapType ()
เรียกดูประเภทแผนที่ที่แสดงอยู่ในปัจจุบัน ดู MAP_TYPE_NORMAL
, MAP_TYPE_SATELLITE
, MAP_TYPE_TERRAIN
สําหรับค่าที่เป็นไปได้
การคืนสินค้า
- ประเภทแผนที่
แบบลอย สาธารณะ getMaxZoomLevel ()
แสดงผลระดับการซูมสูงสุดสําหรับตําแหน่งกล้องปัจจุบัน จะคํานึงถึงประเภทแผนที่ที่กําลังใช้อยู่ เช่น ดาวเทียมหรือภูมิประเทศอาจมีระดับการซูมสูงสุดที่ต่ํากว่าชิ้นส่วนแผนที่ฐาน
สําหรับข้อมูลเพิ่มเติมเกี่ยวกับการเปลี่ยนระดับการซูมของกล้อง โปรดดูกล้องและมุมมอง
การคืนสินค้า
- ระดับการซูมสูงสุดที่ใช้ได้ตรงตําแหน่งกล้องปัจจุบัน
แบบลอย สาธารณะ getMinZoomLevel ()
แสดงระดับการซูมขั้นต่ํา ซึ่งจะเหมือนกันในทุกตําแหน่ง (ซึ่งต่างจากระดับการซูมสูงสุด) แต่อาจแตกต่างกันไปตามอุปกรณ์และขนาดของแผนที่
สําหรับข้อมูลเพิ่มเติมเกี่ยวกับการเปลี่ยนระดับการซูมของกล้อง โปรดดูกล้องและมุมมอง
การคืนสินค้า
- ระดับการซูมขั้นต่ําที่ใช้ได้
สาธารณะ ตําแหน่ง getMyLocation ()
เมธอดนี้เลิกใช้งานแล้ว
ให้ใช้ com.google.android.gms.location.FusedLocationProviderApi แทน
FusedLocationProviderApi ปรับปรุงการค้นหาตําแหน่งและการใช้พลังงานให้ดียิ่งขึ้น โดยใช้
จุด "My Location" สีน้ําเงิน ดู MyLocationDemoActivity ในโฟลเดอร์แอปพลิเคชันตัวอย่างสําหรับโค้ดตัวอย่าง หรือคู่มือนักพัฒนาซอฟต์แวร์ตําแหน่ง
แสดงผลตําแหน่งปัจจุบันของผู้ใช้ หรือ null
หากไม่มีข้อมูลตําแหน่ง
การคืนสินค้า
user location
ที่แสดงอยู่
ผ้าคลุม
ข้อผิดพลาดของรัฐที่ผิดกฎหมาย | หากไม่ได้เปิดใช้ตําแหน่งของฉัน |
---|
สาธารณะ การคาดการณ์ getProjection ()
แสดงผลออบเจ็กต์ Projection
ที่คุณสามารถใช้เพื่อแปลงระหว่างพิกัดหน้าจอและพิกัดละติจูดและลองจิจูด
Projection
ที่แสดงคือภาพรวมของการฉายภาพปัจจุบัน และจะไม่อัปเดตโดยอัตโนมัติเมื่อกล้องขยับ เนื่องจากการดําเนินการนี้มีราคาแพง คุณจึงควรฉายภาพเพียงครั้งเดียวต่อหน้าจอเท่านั้น Google Maps ใช้การฉายภาพของ Mercator เพื่อสร้างแผนที่จากข้อมูลทางภูมิศาสตร์และแปลงจุดต่างๆ บนแผนที่เป็นพิกัดทางภูมิศาสตร์
การคืนสินค้า
Projection
ของแผนที่ในสถานะปัจจุบัน
สาธารณะ UiSettings getUiSettings ()
รับการตั้งค่าอินเทอร์เฟซผู้ใช้สําหรับแผนที่
การคืนสินค้า
UiSettings
สําหรับแผนที่นี้
บูลีน สาธารณะ isBuildingsEnabled ()
แสดงผลเลือกว่าจะเปิดใช้งานเลเยอร์สิ่งปลูกสร้าง 3 มิติหรือไม่
การคืนสินค้า
true
หากเปิดใช้อาคาร โปรดระบุfalse
บูลีน สาธารณะ isIndoorEnabled ()
รับที่ระบุว่าแผนที่ในอาคารเปิดใช้อยู่หรือไม่
การคืนสินค้า
true
หากเปิดใช้แผนที่ในอาคารfalse
หากปิดใช้แผนที่ในอาคาร
บูลีน สาธารณะ isMyLocationEnabled ()
รับสถานะของเลเยอร์ตําแหน่งของฉัน
การคืนสินค้า
true
หากเปิดใช้เลเยอร์ "ตําแหน่งของฉัน" หรือfalse
บูลีน สาธารณะ isTrafficEnabled ()
ตรวจสอบว่าแผนที่กําลังดึงข้อมูลการจราจรหรือไม่ โดยขึ้นอยู่กับความพร้อมใช้งานของข้อมูลการเข้าชม
การคืนสินค้า
true
หากเปิดใช้ข้อมูลการเข้าชม หากไม่ใช่false
สาธารณะ null movecamera (CameraUpdate อัปเดต)
จัดตําแหน่งกล้องอีกครั้งตามวิธีการที่ระบุไว้ในการอัปเดต การย้ายจะมีผลทันทีและ getCameraPosition()
ที่ตามมาจะแสดงตําแหน่งใหม่ ดู
CameraUpdateFactory
สําหรับชุดอัปเดต
พารามิเตอร์
อัปเดต | การเปลี่ยนแปลงที่ควรใช้กับกล้อง |
---|
สาธารณะ null resetMinMaxZoomPreferences ()
นําขอบเขตการซูมด้านบนและด้านล่างที่ระบุไว้ก่อนหน้านี้ออก
โฟลเดอร์สาธารณะ set BuildingsEnabled (เปิดใช้บูลีน)
เปิดหรือปิดเลเยอร์สิ่งปลูกสร้าง 3 มิติ
พารามิเตอร์
เปิดใช้อยู่ | true เพื่อเปิดใช้เลเยอร์สิ่งปลูกสร้าง 3 มิติ false เพื่อปิดใช้สิ่งปลูกสร้าง 3 มิติ
|
---|
สาธารณะ null setContentDescription (คําอธิบายสตริง)
ตั้งค่า contentDescription สําหรับแผนที่
ซึ่งใช้เพื่อระบุคําอธิบายแผนที่ของแผนที่ในโหมดการช่วยเหลือพิเศษ ค่าเริ่มต้นคือ "Google Map"
พารามิเตอร์
คำอธิบาย | สตริงที่จะใช้เป็นคําอธิบาย |
---|
บูลีน สาธารณะ setIndoorEnabled (เปิดใช้บูลีน)
ตั้งค่าว่าควรเปิดใช้แผนที่ในอาคารหรือไม่ ปัจจุบันแผนที่ในอาคารสามารถแสดงในแผนที่ได้ครั้งละ 1 รายการเท่านั้น และโดยค่าเริ่มต้น นี่คือแผนที่แรกที่เพิ่มลงในแอปพลิเคชัน หากต้องการเปิดใช้แผนที่ในอาคารบนแผนที่อื่น คุณต้องปิดใช้แผนที่ในอาคารบนแผนที่เดิมก่อน หากคุณพยายามเปิดใช้แผนที่ในอาคารเมื่อเปิดใช้บนแผนที่อื่น จะไม่มีอะไรเกิดขึ้นและจะส่งคืน false
เมื่อไม่ได้เปิดใช้แผนที่ในอาคาร เมธอดทั้งหมดที่เกี่ยวข้องกับ Indoor จะส่งกลับ null
หรือ false
พารามิเตอร์
เปิดใช้อยู่ | true เพื่อพยายามเปิดใช้แผนที่ในอาคาร false เพื่อปิดใช้งานแผนที่ในอาคาร |
---|
การคืนสินค้า
- เปิดใช้แผนที่ในอาคารได้หรือไม่
สาธารณะ null setInfoWindowAdapter (GoogleMap.InfoWindowAdapter อะแดปเตอร์)
ตั้งค่าตัวแสดงผลที่กําหนดเองสําหรับเนื้อหาของหน้าต่างข้อมูล
สถานะนี้ไม่ต่อเนื่องกับแผนที่ เช่นเดียวกับ Listener เหตุการณ์ของแผนที่ หากมีการสร้างแผนที่ขึ้นใหม่ (เช่น เนื่องจากมีการเปลี่ยนแปลงการกําหนดค่า) คุณต้องเรียกใช้เมธอดนี้อีกครั้งเพื่อรักษาการปรับแต่งไว้
พารามิเตอร์
อะแดปเตอร์ | อะแดปเตอร์ที่จะใช้แสดงเนื้อหาในหน้าต่างข้อมูล หรือ null เพื่อใช้การแสดงเนื้อหาเริ่มต้นในหน้าต่างข้อมูล
|
---|
สาธารณะ null setLatLngBoundsForCameraTarget (ขอบเขต LatLngBounds)
ระบุ LatLngBounds เพื่อจํากัดเป้าหมายของกล้อง ดังนั้นเมื่อผู้ใช้เลื่อนและเลื่อนแผนที่ เป้าหมายของกล้องจะไม่เคลื่อนที่ออกนอกขอบเขตเหล่านี้
ตั้งค่าเป็น Null เพื่อล้างกรอบล้อมรอบทั้งหมด ขอบเขตใหม่จะแทนที่กรอบขอบเขตที่ระบุก่อนหน้านี้
เมื่อ LatLngBounds มีการเปลี่ยนแปลง SDK จะปรับการอัปเดตกล้องในภายหลังทั้งหมดเพื่อให้เป็นไปตามขอบเขตเหล่านั้น หากทําได้ โปรดทราบว่ามีข้อควรพิจารณาทางเทคนิคที่อาจทําให้ SDK รักษาเป้าหมายของกล้องอยู่ภายในขอบเขตอย่างเคร่งครัด เช่น ข้อผิดพลาดในการปัดเศษของจุดทศนิยมหรือระดับการซูมที่ต่ํามาก
พารามิเตอร์
ขอบเขต | ขอบเขตในการบังคับเป้าหมายของกล้องให้อยู่ภายใน |
---|
สาธารณะ null setLocationSource (แหล่งที่มา LocationSource)
แทนที่แหล่งที่มาของตําแหน่งในเลเยอร์ตําแหน่งของฉัน
พารามิเตอร์
source | แหล่งที่มาของตําแหน่งที่จะใช้ในเลเยอร์ตําแหน่งของฉัน ตั้งค่าเป็น null เพื่อใช้ต้นทางของตําแหน่งเริ่มต้น
|
---|
บูลีน สาธารณะ setMapStyle ( MapStyleOptions รูปแบบ)
ตั้งค่าการจัดรูปแบบของแผนที่ฐาน
ด้วยการใช้รูปแบบ คุณสามารถใช้ลักษณะที่กําหนดเองกับลักษณะและองค์ประกอบบนแผนที่ได้
ดูรายละเอียดการจัดรูปแบบได้ที่ MapStyleOptions
ตั้งค่าเป็น Null เพื่อล้างการจัดรูปแบบที่กําหนดเองก่อนหน้านี้
พารามิเตอร์
รูปแบบ |
---|
การคืนสินค้า
true
หากแยกวิเคราะห์สไตล์สําเร็จfalse
หากพบว่าเกิดปัญหาในMapStyleOptions
เช่น การจัดรูปแบบ JSON แยกวิเคราะห์ไม่ได้ ประเภทฟีเจอร์ที่ไม่รู้จัก ประเภทองค์ประกอบที่ไม่รู้จัก หรือคีย์การจัดรูปแบบไม่ถูกต้อง หากค่าการแสดงผลคือfalse
ระบบจะไม่เปลี่ยนแปลงรูปแบบปัจจุบัน
สาธารณะ null set MapType (int type)
กําหนดประเภทของชิ้นส่วนแผนที่ที่ควรแสดง ค่าที่อนุญาตมีดังนี้
MAP_TYPE_NORMAL
: แผนที่พื้นฐานMAP_TYPE_SATELLITE
: ภาพจากดาวเทียมMAP_TYPE_HYBRID
: ภาพจากดาวเทียมพร้อมถนนและป้ายกํากับMAP_TYPE_TERRAIN
: ข้อมูลภูมิประเทศMAP_TYPE_NONE
: ไม่มีชิ้นส่วนแผนที่พื้นฐาน
พารามิเตอร์
ประเภท | ประเภทของแผนที่ที่จะแสดง |
---|
สาธารณะ null setMaxZoomPreferences (ทศนิยม maxZoomPreferences)
ตั้งค่าขอบเขตบนที่ต้องการสําหรับการซูมของกล้อง
เมื่อการซูมสูงสุดมีการเปลี่ยนแปลง SDK จะปรับการอัปเดตกล้องในภายหลังทั้งหมดตามความละเอียดสูงสุดหากเป็นไปได้ โปรดทราบว่ามีปัญหาทางเทคนิคที่อาจป้องกันไม่ให้ SDK อนุญาตให้ผู้ใช้ซูมลึกลงไปในแผนที่ได้ ตัวอย่างเช่น ดาวเทียมหรือภูมิประเทศอาจมีการซูมสูงสุดที่ต่ํากว่าชิ้นส่วนแผนที่ฐาน
SDK แก้ไขความขัดแย้งในค่าต่ําสุดและสูงสุด หากคุณตั้งค่าการซูมขั้นต่ําเป็นระดับการซูมที่สูงกว่าจํานวนสูงสุดปัจจุบัน SDK จะใช้ค่าต่ําสุดขั้นต่ําสําหรับทั้งค่าต่ําสุดและสูงสุด หากคุณตั้งค่าการซูมสูงสุดเป็นระดับการซูมที่ต่ํากว่าค่าต่ําสุด SDK จะใช้ค่าสูงสุดใหม่สําหรับทั้งค่าต่ําสุดและสูงสุด เช่น สมมติว่าการซูมขั้นต่ําปัจจุบันคือ 8 และจํานวนสูงสุดคือ 14 จากนั้นตั้งค่าการซูมสูงสุดเป็น 6 SDK ใช้การซูมขั้นต่ําเป็น 6 และการซูมสูงสุด 6
พารามิเตอร์
ค่ากําหนด maxZoom | ขอบเขตบนที่ต้องการ |
---|
สาธารณะ null setMinZoomPreferences (ทศนิยม minZoomPreferences)
ตั้งค่าขอบเขตด้านล่างที่ต้องการสําหรับการซูมของกล้อง
เมื่อการซูมขั้นต่ํามีการเปลี่ยนแปลง SDK จะปรับการอัปเดตกล้องในภายหลังทั้งหมดเพื่อให้เป็นไปตามขอบเขตขั้นต่ําดังกล่าวหากเป็นไปได้ โปรดทราบว่ามีปัญหาทางเทคนิคที่อาจป้องกันไม่ให้ SDK อนุญาตให้ผู้ใช้ซูมได้ต่ําเกินไป
SDK แก้ไขความขัดแย้งในค่าต่ําสุดและสูงสุด หากคุณตั้งค่าการซูมขั้นต่ําเป็นระดับการซูมที่สูงกว่าจํานวนสูงสุดปัจจุบัน SDK จะใช้ค่าต่ําสุดขั้นต่ําสําหรับทั้งค่าต่ําสุดและสูงสุด หากคุณตั้งค่าการซูมสูงสุดเป็นระดับการซูมที่ต่ํากว่าค่าต่ําสุด SDK จะใช้ค่าสูงสุดใหม่สําหรับทั้งค่าต่ําสุดและสูงสุด เช่น สมมติว่าการซูมขั้นต่ําปัจจุบันคือ 8 และจํานวนสูงสุดคือ 14 จากนั้นตั้งค่าการซูมขั้นต่ําเป็น 16 SDK ใช้การซูมขั้นต่ําเป็น 16 และการซูมสูงสุด 16 ครั้ง
พารามิเตอร์
การตั้งค่าการซูมขั้นต่ํา | ขอบเขตล่างที่ต้องการ |
---|
สาธารณะ null setMyLocationEnabled (เปิดใช้บูลีน)
เปิดหรือปิดใช้เลเยอร์ตําแหน่งของฉัน
เมื่อเปิดใช้และตําแหน่งพร้อมใช้งาน เลเยอร์ตําแหน่งของฉันจะแสดงการระบุตําแหน่ง ปัจจุบันและทิศทางของผู้ใช้อย่างต่อเนื่อง รวมถึงแสดงการควบคุม UI ที่ช่วยให้ผู้ใช้โต้ตอบกับตําแหน่งของตน (เช่น เพื่อเปิดหรือปิดใช้กล้องจากการติดตามตําแหน่งและตําแหน่ง)
หากต้องการใช้ฟีเจอร์เลเยอร์สถานที่ตั้งของฉัน คุณต้องขอสิทธิ์สําหรับ ACCESS_COARSE_LOCATION
หรือ ACCESS_FINE_LOCATION
เว้นแต่คุณจะตั้งค่าแหล่งที่มาของตําแหน่งที่กําหนดเอง
หากคุณตั้งค่าแหล่งที่มาของตําแหน่งที่กําหนดเองผ่าน setLocationSource(LocationSource)
SDK ของ Google Maps สําหรับ Android จะไม่ตรวจสอบว่าสิทธิ์ด้านบนได้รับสิทธิ์หรือไม่ แต่คุณยังคงต้องตรวจสอบว่าผู้ใช้ให้สิทธิ์ทั้งหมดที่จําเป็นสําหรับแหล่งที่มาของตําแหน่งที่กําหนดเอง
พารามิเตอร์
เปิดใช้อยู่ | true เพื่อเปิดใช้ false เพื่อปิดใช้ |
---|
ผ้าคลุม
ข้อยกเว้นด้านความปลอดภัย | หากไม่มีการให้สิทธิ์การเข้าถึงตําแหน่ง |
---|
สาธารณะ null setOnCameraChangeListener (Google Map.OnCameraChangeListener Listener)
วิธีการนี้เลิกใช้งานแล้ว
แทนที่โดย setOnCameraMoveStartedListener(GoogleMap.OnCameraMoveStartedListener)
, setOnCameraMoveListener(GoogleMap.OnCameraMoveListener)
, setOnCameraMoveCanceledListener(GoogleMap.OnCameraMoveCanceledListener)
และ setOnCameraIdleListener(GoogleMap.OnCameraIdleListener)
ตั้งค่าโค้ดเรียกกลับที่มีการเรียกใช้เมื่อกล้องมีการเปลี่ยนแปลง
พารามิเตอร์
Listener | ระบบจะเรียกโค้ดเรียกกลับที่เรียกใช้เมื่อกล้องเปลี่ยน หากต้องการยกเลิกการติดต่อกลับ ให้ใช้ null |
---|
สาธารณะ นัล setOnCameraIdleListener (GoogleMap.OnCameraIdleListener Listener)
ตั้งค่าโค้ดเรียกกลับที่เรียกใช้เมื่อการเคลื่อนไหวของกล้องสิ้นสุดลง
พารามิเตอร์
Listener | โค้ดเรียกกลับที่เรียกใช้ หากต้องการยกเลิกการติดต่อกลับ ให้ใช้ null
|
---|
สาธารณะ null setOnCameraMoveCanceledListener (Google Map.OnCameraMoveCanceledListener Listener)
ตั้งค่าโค้ดเรียกกลับที่จะเรียกใช้เมื่อภาพเคลื่อนไหวของกล้องหยุดหรือถูกขัดจังหวะโดยภาพเคลื่อนไหวประเภทใหม่
พารามิเตอร์
Listener | โค้ดเรียกกลับที่เรียกใช้ หากต้องการยกเลิกการติดต่อกลับ ให้ใช้ null อย่าอัปเดตหรือทําให้กล้องเคลื่อนไหวจากภายใน onCameraMoveCanceled()
|
---|
สาธารณะ null setOnCameraMoveListener (GoogleMap.OnCameraMoveListener Listener)
ตั้งค่าโค้ดเรียกกลับที่เรียกใช้ซ้ําๆ ขณะที่กล้องกําลังเคลื่อนไหว ระบบอาจเรียกใช้โค้ดเรียกกลับบ่อยๆ ในทุกเฟรมและไม่ควรดําเนินการราคาแพง
พารามิเตอร์
Listener | โค้ดเรียกกลับที่เรียกใช้ หากต้องการยกเลิกการติดต่อกลับ ให้ใช้ null
|
---|
สาธารณะ null setOnCameraMoveStartedListener (GoogleMap.OnCameraMoveStartedListener))
ตั้งค่าโค้ดเรียกกลับที่มีการเรียกใช้เมื่อกล้องเริ่มเคลื่อนไหวหรือสาเหตุที่การเคลื่อนไหวของกล้องมีการเปลี่ยนแปลง
พารามิเตอร์
Listener | โค้ดเรียกกลับที่เรียกใช้ หากต้องการยกเลิกการติดต่อกลับ ให้ใช้ null อย่าอัปเดตหรือทําให้กล้องเคลื่อนไหวจากภายใน onCameraMoveStarted()
|
---|
สาธารณะ null setOnCircleClickListener (ผู้ฟัง GoogleMap.OnCircleClickListener)
ตั้งค่าโค้ดเรียกกลับที่จะเรียกใช้เมื่อมีการคลิกวงกลม
พารามิเตอร์
Listener | โค้ดเรียกกลับที่เรียกใช้เมื่อมีการคลิกวงกลม หากต้องการยกเลิกการติดต่อกลับ ให้ใช้ null
|
---|
สาธารณะ นัล setOnGroundOverClickListener (ผู้ฟัง GoogleMap.OnGroundโฆษณาซ้อนทับคลิกListener)
ตั้งค่าโค้ดเรียกกลับที่มีการเรียกใช้เมื่อมีการคลิกการวางซ้อนพื้น
พารามิเตอร์
Listener | ระบบจะเรียกโค้ดเรียกกลับเมื่อมีการคลิกการวางซ้อนพื้น หากต้องการยกเลิกการติดต่อกลับ ให้ใช้ null
|
---|
โฟลเดอร์สาธารณะ setOnIndoorStateChangeListener (Google Map.OnIndoorStateChangeListener)
ตั้งค่าหรือล้าง Listener สําหรับเหตุการณ์ในร่ม กําหนดผู้ฟังได้เพียง 1 คนเท่านั้น การตั้งค่า Listener ใหม่จะนํา Listener ก่อนหน้าออก
พารามิเตอร์
Listener | Listener เหตุการณ์ในอาคารหากไม่ใช่ Null มิเช่นนั้น ให้ล้าง Listener ออก |
---|
สาธารณะ null setOnInfoWindowClickListener (ผู้ฟัง GoogleMap.OnInfoWindowClickListener)
ตั้งค่าโค้ดเรียกกลับที่เรียกใช้เมื่อมีการคลิกที่หน้าต่างข้อมูลเครื่องหมาย
พารามิเตอร์
Listener | ระบบจะเรียกโค้ดเรียกกลับเมื่อมีการคลิกหน้าต่างข้อมูลเครื่องหมาย หากต้องการยกเลิกการติดต่อกลับ ให้ใช้ null
|
---|
สาธารณะ null setOnInfoWindowCloseListener (GoogleMap.OnInfoWindowCloseListener ))
ตั้งค่าโค้ดเรียกกลับที่จะเรียกใช้เมื่อหน้าต่างข้อมูลของเครื่องหมายปิดอยู่
พารามิเตอร์
Listener | ระบบจะเรียกโค้ดเรียกกลับเมื่อมีการปิดหน้าต่างข้อมูลของเครื่องหมาย ##99 หากต้องการยกเลิกการติดต่อกลับ ให้ใช้ null
|
---|
สาธารณะ Listener
ตั้งค่าโค้ดเรียกกลับที่เรียกใช้เมื่อหน้าต่างข้อมูลของเครื่องหมายถูกกดค้าง
พารามิเตอร์
Listener | ระบบจะเรียกโค้ดเรียกกลับเมื่อมีการกดเครื่องหมายข้อมูลของเครื่องหมายแสดงเครื่องหมาย ' ค้างไว้ หากต้องการยกเลิกการติดต่อกลับ ให้ใช้ null
|
---|
สาธารณะ null setOn MapClickListener (Google Map.On MapClickListener Listener)
ตั้งค่าการโทรกลับที่เรียกใช้เมื่อแตะแผนที่
พารามิเตอร์
Listener | ระบบจะเรียกโค้ดเรียกกลับเมื่อมีการแตะแผนที่ หากต้องการยกเลิกการติดต่อกลับ ให้ใช้ null
|
---|
สาธารณะ null setOn MapLoadedCallback (GoogleMap.On MapLoadedCallback callback)
ตั้งค่าโค้ดเรียกกลับที่เรียกใช้เมื่อแผนที่นี้แสดงภาพเสร็จแล้ว ระบบจะเรียกใช้โค้ดเรียกกลับเพียงครั้งเดียว
หากมีการเรียกใช้เมธอดนี้เมื่อแผนที่แสดงผลสมบูรณ์แล้ว ระบบจะเรียกใช้โค้ดเรียกกลับทันที เหตุการณ์นี้จะไม่เริ่มทํางานหากแผนที่ไม่โหลดเนื่องจากปัญหาการเชื่อมต่อ หรือหากแผนที่มีการเปลี่ยนแปลงอย่างต่อเนื่องและไม่โหลดจนเสร็จเนื่องจากผู้ใช้โต้ตอบกับแผนที่อย่างต่อเนื่อง
พารามิเตอร์
โค้ดเรียกกลับ | ระบบจะเรียกใช้โค้ดเรียกกลับเมื่อแผนที่แสดงผลเสร็จแล้ว หากต้องการยกเลิกการติดต่อกลับ ให้ใช้ null
|
---|
สาธารณะ นัล setOn MaplongClickListener (Google Map.On MaplongClickListener Listener)
ตั้งค่าโค้ดเรียกกลับที่เรียกใช้เมื่อมีการกดแผนที่ค้างไว้
พารามิเตอร์
Listener | ระบบจะเรียกโค้ดเรียกกลับเมื่อมีการกดแผนที่ หากต้องการยกเลิกการติดต่อกลับ ให้ใช้ null
|
---|
สาธารณะ null setOnMarkerClickListener (ผู้ฟัง GoogleMap.OnMarkerClickListener)
ตั้งค่าโค้ดเรียกกลับที่มีการเรียกใช้เมื่อมีการคลิกเครื่องหมาย
พารามิเตอร์
Listener | ระบบจะเรียกโค้ดเรียกกลับเมื่อมีการคลิกเครื่องหมาย หากต้องการยกเลิกการติดต่อกลับ ให้ใช้ null
|
---|
สาธารณะ null setOnMarkererListener (GoogleMap.OnMarker DragListener Listener)
ตั้งค่าโค้ดเรียกกลับที่มีการเรียกใช้เมื่อมีการลากเครื่องหมาย
พารามิเตอร์
Listener | โค้ดเรียกกลับที่เรียกใช้เหตุการณ์ลากเครื่องหมาย หากต้องการยกเลิกการติดต่อกลับ ให้ใช้ null
|
---|
สาธารณะ Null setOnMyLocationButtonClickListener (GoogleMap.OnMyLocationButtonClickListener Listener)
ตั้งค่าโค้ดเรียกกลับที่มีการเรียกใช้เมื่อมีการคลิกปุ่มตําแหน่งของฉัน
หาก listener
แสดงผล true
ระบบจะใช้เหตุการณ์และลักษณะการทํางานเริ่มต้นจะไม่เกิดขึ้น หากฟังก์ชันแสดงผล false
ลักษณะการทํางานเริ่มต้นจะเกิดขึ้น (เช่น กล้องขยับจนศูนย์กลางของตําแหน่งผู้ใช้)
พารามิเตอร์
Listener | ระบบจะเรียกโค้ดเรียกกลับเมื่อมีการคลิกปุ่ม "ตําแหน่งของฉัน" |
---|
สาธารณะ null setOnMyLocationChangeListener (ผู้ฟัง GoogleMap.OnMyLocationChangeListener)
เมธอดนี้เลิกใช้งานแล้ว
ให้ใช้ com.google.android.gms.location.FusedLocationProviderApi แทน
FusedLocationProviderApi ปรับปรุงการค้นหาตําแหน่งและการใช้พลังงานให้ดียิ่งขึ้น โดยใช้
จุด "My Location" สีน้ําเงิน ดู MyLocationDemoActivity ในโฟลเดอร์แอปพลิเคชันตัวอย่างสําหรับโค้ดตัวอย่าง หรือคู่มือนักพัฒนาซอฟต์แวร์ตําแหน่ง
ตั้งค่าโค้ดเรียกกลับที่จะเรียกใช้เมื่อจุดตําแหน่งของฉันเปลี่ยนตําแหน่ง
พารามิเตอร์
Listener | โค้ดเรียกกลับที่มีการเรียกใช้เมื่อจุดตําแหน่งของฉันเปลี่ยนไป |
---|
สาธารณะ null setOnMyLocationClickListener (ผู้ฟัง GoogleMap.OnMyLocationClickListener)
ตั้งค่าโค้ดเรียกกลับที่มีการเรียกใช้เมื่อมีการคลิกจุด "ตําแหน่งของฉัน" (ซึ่งหมายถึงตําแหน่งของผู้ใช้)
พารามิเตอร์
Listener | ระบบจะเรียกโค้ดเรียกกลับเมื่อมีการคลิกจุด "ตําแหน่งของฉัน" |
---|
สาธารณะ null setOnPoiClickListener (ผู้ฟัง GoogleMap.OnPoiClickListener)
กําหนด Listener ที่จะทริกเกอร์เมื่อมีการคลิกหรือแตะจุดที่น่าสนใจ
ผ่าน null
เพื่อล้าง Listener
พารามิเตอร์
Listener |
---|
สาธารณะ null setOnPolygonClickListener (Google Map.OnPolygonClickListener Listener)
ตั้งค่าโค้ดเรียกกลับที่มีการเรียกใช้เมื่อมีการคลิกรูปหลายเหลี่ยม
พารามิเตอร์
Listener | โค้ดเรียกกลับที่มีการเรียกใช้เมื่อมีการคลิกรูปหลายเหลี่ยม หากต้องการยกเลิกการติดต่อกลับ ให้ใช้ null
|
---|
สาธารณะ null setOnPolylineClickListener (GoogleMap.OnPolylineClickListener)
ตั้งค่าโค้ดเรียกกลับที่มีการเรียกใช้เมื่อมีการคลิกโพลีไลน์
พารามิเตอร์
Listener | ระบบจะเรียกโค้ดเรียกกลับเมื่อมีการคลิกโพลีไลน์ หากต้องการยกเลิกการติดต่อกลับ ให้ใช้ null
|
---|
สาธารณะ null setPaving (int left, inttop, int right, int down)
กําหนดระยะห่างจากขอบในแผนที่
วิธีการนี้ช่วยให้คุณกําหนดพื้นที่ที่มองเห็นได้บนแผนที่เพื่อส่งสัญญาณให้กับแผนที่ซึ่งบางส่วนของแผนที่รอบขอบอาจถูกบดบังโดยการตั้งค่าระยะห่างจากขอบทั้ง 4 ด้านของแผนที่ ระบบจะปรับเปลี่ยนฟังก์ชันแผนที่เข้ากับระยะห่างจากขอบ ตัวอย่างเช่น ย้ายตัวควบคุมการซูม เข็มทิศ ประกาศเกี่ยวกับลิขสิทธิ์ และโลโก้ Google ให้พอดีกับพื้นที่ที่กําหนดไว้ การเคลื่อนที่ของกล้องจะสัมพันธ์กับจุดศูนย์กลางของบริเวณที่มองเห็นได้ ฯลฯ
พารามิเตอร์
ซ้าย | จํานวนพิกเซลของระยะห่างจากขอบที่จะเพิ่มทางด้านซ้ายของแผนที่ |
---|---|
ช่วงต้น | จํานวนพิกเซลของระยะห่างจากขอบที่จะเพิ่มที่ด้านบนของแผนที่ |
ขวา | จํานวนพิกเซลของระยะห่างจากขอบที่จะเพิ่มทางด้านขวาของแผนที่ |
ช่วงท้าย | จํานวนพิกเซลในการขยายพื้นที่ด้านล่างของแผนที่ |
โฟลเดอร์สาธารณะ setTrafficEnabled (เปิดใช้บูลีน)
เปิดหรือปิดเลเยอร์การจราจร
พารามิเตอร์
เปิดใช้อยู่ |
---|
สาธารณะ null snapshot (Google Map.SnapshotReadyCallback Callback)
บันทึกภาพรวมของแผนที่
คุณจะใช้สแนปชอตในแอปพลิเคชันได้เมื่อแผนที่แบบอินเทอร์แอกทีฟใช้งานยากหรือไม่สามารถทําได้ เช่น รูปภาพที่สร้างด้วยเมธอด snapshot()
อาจใช้เพื่อแสดงภาพขนาดย่อของแผนที่ในแอป หรือสแนปชอตในศูนย์แจ้งเตือน
หมายเหตุ: ต้องไม่มีการส่งภาพแผนที่ไปยังเซิร์ฟเวอร์ของคุณ หรือใช้รูปภาพภายนอกแอปพลิเคชัน หากคุณจําเป็นต้องส่งแผนที่ไปยังแอปพลิเคชันหรือผู้ใช้รายอื่น ให้ส่งข้อมูลที่ช่วยให้ผู้ใช้เหล่านั้นสามารถสร้างแผนที่ใหม่ให้กับผู้ใช้รายใหม่แทนที่จะส่งสแนปชอต
พารามิเตอร์
โค้ดเรียกกลับ | มีการเรียกใช้โค้ดเรียกกลับเมื่อมีการบันทึกสแนปชอต |
---|
สาธารณะ null snapshot (GoogleMaps.SnapshotReadyCallback การเรียกกลับ, บิตแมปบิตแมป)
บันทึกภาพรวมของแผนที่
วิธีการนี้เทียบเท่ากับ snapshot(SnapshotReadyCallback)
แต่ให้ Bitmap
ที่จัดสรรไว้ล่วงหน้า หากบิตแมปไม่ตรงกับมิติข้อมูลปัจจุบันของแผนที่ ระบบจะจัดสรรบิตแมปอื่นที่เหมาะกับขนาดของแผนที่
แม้ว่าในกรณีส่วนใหญ่ ออบเจ็กต์ที่ส่งผ่านเมธอดเรียกกลับจะเหมือนกันกับค่าที่ระบุในพารามิเตอร์สําหรับเมธอดนี้ แต่ในบางกรณีออบเจ็กต์ที่ส่งกลับก็อาจแตกต่างกันไป (เช่น หากมิติข้อมูลของการดูมีการเปลี่ยนแปลงเมื่อถ่ายสแนปชอตจริงๆ) ดังนั้น คุณควรเชื่อถือเฉพาะบิตแมปของเมธอดการเรียกกลับเท่านั้น
พารามิเตอร์
โค้ดเรียกกลับ | มีการเรียกใช้โค้ดเรียกกลับเมื่อมีการบันทึกสแนปชอต |
---|---|
บิตแมป | บิตแมปที่จัดสรรล่วงหน้า หาก null มีลักษณะการทํางานเหมือน snapshot(SnapshotReadyCallback)
|
สาธารณะ null stopAnimation ()
หยุดภาพเคลื่อนไหวของกล้องหากมีกําลังดําเนินการอยู่ เมื่อมีการเรียกใช้เมธอด กล้องจะหยุดเคลื่อนที่ทันทีและยังคงอยู่ในตําแหน่งนั้น