این مثال نحوه گوش دادن و مدیریت برخی از رویدادهای روی نقشه را نشان می دهد.
برای اطلاعات بیشتر، به مستندات مراجعه کنید.
شروع کنید
قبل از اینکه بتوانید کد نمونه را امتحان کنید، باید محیط توسعه خود را پیکربندی کنید. برای اطلاعات بیشتر، Maps SDK برای نمونه کدهای Android را ببینید.
کد را مشاهده کنید
کاتلین
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) } }
جاوا
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 برای اجرای این نمونه به صورت محلی مورد نیاز است. دستور زیر مخزن نمونه برنامه را شبیه سازی می کند.
git clone git@github.com:googlemaps-samples/android-samples.git
نمونه پروژه را به اندروید استودیو وارد کنید:
- در Android Studio، File > New > Import Project را انتخاب کنید.
به مکانی که مخزن را در آن ذخیره کرده اید بروید و دایرکتوری پروژه را برای Kotlin یا Java انتخاب کنید:
- Kotlin :
PATH-REPO /android-samples/ApiDemos/kotlin - جاوا :
PATH-REPO /android-samples/ApiDemos/java
- Kotlin :
- Open را انتخاب کنید. Android Studio پروژه شما را با استفاده از ابزار ساخت Gradle می سازد.
- یک فایل
secrets.propertiesخالی در دایرکتوری مشابه فایلlocal.propertiesپروژه خود ایجاد کنید. برای اطلاعات بیشتر در مورد این فایل، به افزودن کلید API خود به پروژه مراجعه کنید. - با فعال کردن Maps SDK for Android، یک کلید API از پروژه خود دریافت کنید .
رشته زیر را به
secrets.propertiesاضافه کنید و مقدار YOUR_API_KEY را با مقدار کلید API خود جایگزین کنید:MAPS_API_KEY=YOUR_API_KEY- برنامه را اجرا کنید.
این مثال نحوه گوش دادن و مدیریت برخی از رویدادهای روی نقشه را نشان می دهد.
برای اطلاعات بیشتر، به مستندات مراجعه کنید.
شروع کنید
قبل از اینکه بتوانید کد نمونه را امتحان کنید، باید محیط توسعه خود را پیکربندی کنید. برای اطلاعات بیشتر، Maps SDK برای نمونه کدهای Android را ببینید.
کد را مشاهده کنید
کاتلین
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) } }
جاوا
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 برای اجرای این نمونه به صورت محلی مورد نیاز است. دستور زیر مخزن نمونه برنامه را شبیه سازی می کند.
git clone git@github.com:googlemaps-samples/android-samples.git
نمونه پروژه را به اندروید استودیو وارد کنید:
- در Android Studio، File > New > Import Project را انتخاب کنید.
به مکانی که مخزن را در آن ذخیره کرده اید بروید و دایرکتوری پروژه را برای Kotlin یا Java انتخاب کنید:
- Kotlin :
PATH-REPO /android-samples/ApiDemos/kotlin - جاوا :
PATH-REPO /android-samples/ApiDemos/java
- Kotlin :
- Open را انتخاب کنید. Android Studio پروژه شما را با استفاده از ابزار ساخت Gradle می سازد.
- یک فایل
secrets.propertiesخالی در دایرکتوری مشابه فایلlocal.propertiesپروژه خود ایجاد کنید. برای اطلاعات بیشتر در مورد این فایل، به افزودن کلید API خود به پروژه مراجعه کنید. - با فعال کردن Maps SDK for Android، یک کلید API از پروژه خود دریافت کنید .
رشته زیر را به
secrets.propertiesاضافه کنید و مقدار YOUR_API_KEY را با مقدار کلید API خود جایگزین کنید:MAPS_API_KEY=YOUR_API_KEY- برنامه را اجرا کنید.