رسیدگی به رویدادها

این مثال نحوه گوش دادن و مدیریت برخی از رویدادهای روی نقشه را نشان می دهد.

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

شروع کنید

قبل از اینکه بتوانید کد نمونه را امتحان کنید، باید محیط توسعه خود را پیکربندی کنید. برای اطلاعات بیشتر، Maps SDK برای نمونه کدهای Android را ببینید.

کد را مشاهده کنید

کاتلین

class EventsDemoActivity : AppCompatActivity(), OnMapClickListener,
    OnMapLongClickListener, OnCameraIdleListener, 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)
    }

    override fun onMapReady(googleMap: GoogleMap) {
        // return early if the map was not initialised properly
        map = googleMap
        map.setOnMapClickListener(this)
        map.setOnMapLongClickListener(this)
        map.setOnCameraIdleListener(this)
    }

    override fun onMapClick(point: LatLng) {
        tapTextView.text = "tapped, point=$point"
    }

    override fun onMapLongClick(point: LatLng) {
        tapTextView.text = "long pressed, point=$point"
    }

    override fun onCameraIdle() {
        if (!::map.isInitialized) return
        cameraTextView.text = map.cameraPosition.toString()
    }
}
EventsDemoActivity.kt

      

جاوا

public class EventsDemoActivity extends AppCompatActivity
        implements OnMapClickListener, OnMapLongClickListener, OnCameraIdleListener,
        OnMapReadyCallback {

    private TextView tapTextView;
    private TextView cameraTextView;
    private GoogleMap map;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.events_demo);

        tapTextView = findViewById(R.id.tap_text);
        cameraTextView = findViewById(R.id.camera_text);

        SupportMapFragment mapFragment =
                (SupportMapFragment) getSupportFragmentManager().findFragmentById(R.id.map);
        mapFragment.getMapAsync(this);
    }

    @Override
    public void onMapReady(GoogleMap map) {
        this.map = map;
        this.map.setOnMapClickListener(this);
        this.map.setOnMapLongClickListener(this);
        this.map.setOnCameraIdleListener(this);
    }

    @Override
    public void onMapClick(LatLng point) {
        tapTextView.setText("tapped, point=" + point);
    }

    @Override
    public void onMapLongClick(LatLng point) {
        tapTextView.setText("long pressed, point=" + point);
    }

    @Override
    public void onCameraIdle() {
        cameraTextView.setText(map.getCameraPosition().toString());
    }
}
EventsDemoActivity.java

      

نمونه ها را شبیه سازی کرده و اجرا کنید

Git برای اجرای این نمونه به صورت محلی مورد نیاز است. دستور زیر مخزن نمونه برنامه را شبیه سازی می کند.

git clone [e-mail]:googlemaps-samples/android-samples.git

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

1. در Android Studio، File > New > Import Project را انتخاب کنید.

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

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

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

   MAPS_API_KEY=YOUR_API_KEY

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