مدیریت رویدادها

این مثال نشان می‌دهد که چگونه به برخی رویدادها در نقشه گوش دهید و آن‌ها را مدیریت کنید.

برای اطلاعات بیشتر، به رویدادها مراجعه کنید.

شروع کنید

قبل‌از اینکه بتوانید کد نمونه را امتحان کنید، باید محیط توسعه نرم‌افزارتان را پیکربندی کنید. برای اطلاعات بیشتر، به نمونه‌های کد کیت توسعه نرم‌افزار Google Maps برای 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)
    }
}

      

جاوا

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 [e-mail]:googlemaps-samples/android-samples.git

پروژه نمونه را به «استودیو Android» وارد کنید:

1. در «استودیو Android»، فایل > جدید > وارد کردن پروژه را انتخاب کنید.

2. به مکانی که مخزن را ذخیره کرده‌اید بروید و دایرکتوری پروژه را برای Kotlin یا Java انتخاب کنید:

   • Kotlin: PATH-REPO/android-samples/ApiDemos/kotlin
   • Java: PATH-REPO/android-samples/ApiDemos/java
3. باز کردن را انتخاب کنید. «استودیو Android» پروژه شما را بااستفاده از ابزار ساخت Gradle می‌سازد.
4. فایل secrets.properties خالی در همان فهرست راهنمای فایل local.properties پروژه‌تان ایجاد کنید. برای کسب اطلاعات بیشتر درباره این فایل، افزودن کلید میانای API به پروژه را ببینید.
5. کلید میانای برنامه‌سازی کاربردی را از پروژه‌تان با کیت توسعه نرم‌افزار Google Maps برای Android فعال‌شده دریافت کنید.

6. رشته زیر را به secrets.properties اضافه کنید و YOUR_API_KEY را با مقدار کلید میانای برنامه‌سازی کاربردی خود جایگزین کنید:

   MAPS_API_KEY=YOUR_API_KEY

7. برنامه را اجرا کنید.