בדוגמה הזו מוסבר איך להאזין לאירועים מסוימים במפה ולטפל בהם.
מידע נוסף זמין במסמכי העזרה.
שנתחיל?
לפני שתוכלו לנסות את הקוד לדוגמה, תצטרכו להגדיר את סביבת הפיתוח. מידע נוסף זמין במאמר דוגמאות קוד ל-SDK של מפות ל-Android.
הצגת הקוד
Kotlin
class EventsDemoActivity : SamplesBaseActivity(), OnMapClickListener, OnMapLongClickListener, OnCameraIdleListener, OnCameraMoveListener, OnMapReadyCallback { private lateinit var tapTextView: TextView private lateinit var cameraTextView: TextView private lateinit var map: GoogleMap override fun onCreate(savedInstanceState: Bundle?) { super.onCreate(savedInstanceState) setContentView(R.layout.events_demo) tapTextView = findViewById(R.id.tap_text) cameraTextView = findViewById(R.id.camera_text) val mapFragment = supportFragmentManager.findFragmentById(R.id.map) as SupportMapFragment? mapFragment?.getMapAsync(this) applyInsets(findViewById(R.id.map_container)) } override fun onMapReady(googleMap: GoogleMap) { map = googleMap map.setOnMapClickListener(this) map.setOnMapLongClickListener(this) map.setOnCameraMoveListener(this) map.setOnCameraIdleListener(this) updateCameraPosition() } override fun onMapClick(point: LatLng) { val lat = String.format(Locale.US, "%.6f", point.latitude) val lng = String.format(Locale.US, "%.6f", point.longitude) tapTextView.text = getString(R.string.events_tapped_format, lat, lng) } override fun onMapLongClick(point: LatLng) { val lat = String.format(Locale.US, "%.6f", point.latitude) val lng = String.format(Locale.US, "%.6f", point.longitude) tapTextView.text = getString(R.string.events_long_pressed_format, lat, lng) } override fun onCameraMove() { updateCameraPosition() } override fun onCameraIdle() { updateCameraPosition() } private fun updateCameraPosition() { if (!::map.isInitialized) return val pos = map.cameraPosition val lat = String.format(Locale.US, "%.6f", pos.target.latitude) val lng = String.format(Locale.US, "%.6f", pos.target.longitude) val zoom = String.format(Locale.US, "%.1f", pos.zoom) val tilt = String.format(Locale.US, "%.1f", pos.tilt) val bearing = String.format(Locale.US, "%.1f", pos.bearing) cameraTextView.text = getString(R.string.events_camera_position_format, lat, lng, zoom, tilt, bearing) } }
Java
public class EventsDemoActivity extends SamplesBaseActivity implements OnMapClickListener, OnMapLongClickListener, OnCameraIdleListener, GoogleMap.OnCameraMoveListener, OnMapReadyCallback { private TextView tapTextView; private TextView cameraTextView; private GoogleMap map; @Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(com.example.common_ui.R.layout.events_demo); tapTextView = findViewById(com.example.common_ui.R.id.tap_text); cameraTextView = findViewById(com.example.common_ui.R.id.camera_text); SupportMapFragment mapFragment = (SupportMapFragment) getSupportFragmentManager().findFragmentById(com.example.common_ui.R.id.map); mapFragment.getMapAsync(this); applyInsets(findViewById(com.example.common_ui.R.id.map_container)); } @Override public void onMapReady(GoogleMap map) { this.map = map; this.map.setOnMapClickListener(this); this.map.setOnMapLongClickListener(this); this.map.setOnCameraMoveListener(this); this.map.setOnCameraIdleListener(this); updateCameraPosition(); } @Override public void onMapClick(LatLng point) { String lat = String.format(Locale.US, "%.6f", point.latitude); String lng = String.format(Locale.US, "%.6f", point.longitude); tapTextView.setText(getString(com.example.common_ui.R.string.events_tapped_format, lat, lng)); } @Override public void onMapLongClick(LatLng point) { String lat = String.format(Locale.US, "%.6f", point.latitude); String lng = String.format(Locale.US, "%.6f", point.longitude); tapTextView.setText(getString(com.example.common_ui.R.string.events_long_pressed_format, lat, lng)); } @Override public void onCameraMove() { updateCameraPosition(); } @Override public void onCameraIdle() { updateCameraPosition(); } private void updateCameraPosition() { if (map == null) return; com.google.android.gms.maps.model.CameraPosition pos = map.getCameraPosition(); String lat = String.format(Locale.US, "%.6f", pos.target.latitude); String lng = String.format(Locale.US, "%.6f", pos.target.longitude); String zoom = String.format(Locale.US, "%.1f", pos.zoom); String tilt = String.format(Locale.US, "%.1f", pos.tilt); String bearing = String.format(Locale.US, "%.1f", pos.bearing); cameraTextView.setText(getString( com.example.common_ui.R.string.events_camera_position_format, lat, lng, zoom, tilt, bearing )); } }
יצירת עותקים מקודמים והרצה של הדוגמאות
כדי להריץ את הדוגמה הזו באופן מקומי, צריך Git. הפקודה הבאה יוצרת עותק (clone) של מאגר האפליקציה לדוגמה.
git clone git@github.com:googlemaps-samples/android-samples.git
מייבאים את פרויקט הדוגמה ל-Android Studio:
- ב-Android Studio, בוחרים באפשרות File (קובץ) > New (חדש) > Import Project (ייבוא פרויקט).
עוברים למיקום שבו שמרתם את המאגר ובוחרים את ספריית הפרויקט ל-Kotlin או ל-Java:
- Kotlin:
PATH-REPO/android-samples/ApiDemos/kotlin - Java:
PATH-REPO/android-samples/ApiDemos/java
- Kotlin:
- בוחרים באפשרות פתיחה. Android Studio יוצר את הפרויקט באמצעות הכלי ל-build של Gradle.
- יוצרים קובץ
secrets.propertiesריק באותה ספרייה שבה נמצא קובץlocal.propertiesשל הפרויקט. מידע נוסף על הקובץ הזה זמין במאמר הוספת מפתח ה-API לפרויקט. - מקבלים מפתח API מהפרויקט שבו ה-SDK של מפות Google ל-Android מופעל.
מוסיפים את המחרוזת הבאה ל-
secrets.properties, מחליפים את YOUR_API_KEY בערך של מפתח ה-API:MAPS_API_KEY=YOUR_API_KEY- מפעילים את האפליקציה.