Zdarzenia

Wybierz platformę: Android iOS JavaScript

Korzystając z pakietu SDK Map na Androida, możesz nasłuchiwać zdarzeń na mapie.

Przykładowe fragmenty kodu

Repozytorium ApiDemos w GitHubie zawiera przykłady, które pokazują zdarzenia i detektory:

Java

• EventsDemoActivity: zdarzenia mapowania kliknięć i zdarzeń zmiany aparatu
• KameraDemoActivity: zdarzenia zmiany kamery
• CircleDemoActivity: znaczniki kliknięcia i przeciągnięcia
• GroundNakładkaDemoActivity: zdarzenia kliknięcia nakładki na powierzchni
• IndoorDemoActivity: zdarzenia na mapie obiektów
• MarkerDemoActivity: zdarzenia znacznika i okna informacyjnego
• PolygonDemoActivity: zdarzenia wielokątne

Kotlin

• EventsDemoActivity: zdarzenia mapowania kliknięć i zdarzeń zmiany aparatu
• KameraDemoActivity: zdarzenia zmiany kamery
• CircleDemoActivity: znaczniki kliknięcia i przeciągnięcia
• GroundNakładkaDemoActivity: zdarzenia kliknięcia nakładki na powierzchni
• IndoorDemoActivity: zdarzenia na mapie obiektów
• MarkerDemoActivity: zdarzenia znacznika i okna informacyjnego
• PolygonDemoActivity: zdarzenia wielokątne

Zdarzenia kliknięcia kliknięcia lub kliknięcia mapy

Jeśli chcesz odpowiedzieć użytkownikowi, który klika punkt na mapie, możesz użyć OnMapClickListener, który możesz ustawić na mapie, wywołując GoogleMap.setOnMapClickListener(OnMapClickListener). Gdy użytkownik kliknie (i dotknie) miejsce na mapie, otrzymasz zdarzenie onMapClick(LatLng) wskazujące lokalizację na mapie, którą kliknął. Jeśli potrzebujesz odpowiedniej lokalizacji na ekranie (w pikselach), możesz uzyskać z mapy Projection, który umożliwia zamianę szerokości i długości geograficznej na współrzędne geograficzne.

Możesz też nasłuchiwać zdarzeń długiego kliknięcia za pomocą OnMapLongClickListener, które możesz ustawić na mapie, wywołując GoogleMap.setOnMapLongClickListener(OnMapLongClickListener). Ten detektor działa podobnie jak detektor kliknięć i będzie powiadamiany o zdarzeniach związanych z długimi kliknięciami z wywołaniem zwrotnym onMapLongClick(LatLng).

Wyłączanie zdarzeń kliknięcia w wersji uproszczonej

Aby wyłączyć zdarzenia kliknięcia na mapie w wersji uproszczonej, wywołaj setClickable() w widoku zawierającym MapView lub MapFragment. Jest to przydatne np. podczas wyświetlania mapy lub map w widoku listy, w którym zdarzenie kliknięcia ma wywoływać działanie niezwiązane z mapą.

Opcja wyłączania zdarzeń kliknięcia jest dostępna tylko w wersji uproszczonej. Wyłączenie zdarzeń kliknięcia uniemożliwi też klikanie znaczników. Nie będzie to miało wpływu na inne elementy sterujące na mapie.

W przypadku MapView:

Java

MapView mapView = findViewById(R.id.mapView);
mapView.setClickable(false);

      

Kotlin

val mapView = findViewById<MapView>(R.id.mapView)
mapView.isClickable = false

      

W przypadku MapFragment:

Java

SupportMapFragment mapFragment = (SupportMapFragment) getSupportFragmentManager()
    .findFragmentById(R.id.map);
View view = mapFragment.getView();
view.setClickable(false);

      

Kotlin

val mapFragment = supportFragmentManager
    .findFragmentById(R.id.map) as SupportMapFragment
val view = mapFragment.view
view?.isClickable = false

      

Zdarzenia zmiany kamery

Widok mapy jest wzorowany na aparacie patrzącym na płaski samolot. Możesz zmienić właściwości kamery, aby zmienić poziom powiększenia, widok portu i widok mapy. Zobacz przewodnik po aparacie. Użytkownicy mogą też wpływać na aparat, używając gestów.

Za pomocą detektorów zmian w kamerze możesz śledzić ruchy kamery. Twoja aplikacja może otrzymywać powiadomienia o rozpoczęciu, trwających i zakończonych zdarzeniach ruchu kamery. Możesz też sprawdzić, dlaczego kamera się porusza, niezależnie od tego, czy jest to spowodowane gestami użytkownika, wbudowanymi animacjami interfejsu API czy ruchami kontrolowanymi przez dewelopera.

Poniższy przykład pokazuje wszystkie dostępne detektory zdarzeń kamery:

Java

// Copyright 2020 Google LLC
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
//
//      http://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.


package com.example.mapdemo;

import android.graphics.Color;
import android.os.Bundle;
import android.util.Log;
import android.view.View;
import android.widget.CompoundButton;
import android.widget.SeekBar;
import android.widget.Toast;

import androidx.appcompat.app.AppCompatActivity;

import com.google.android.gms.maps.CameraUpdate;
import com.google.android.gms.maps.CameraUpdateFactory;
import com.google.android.gms.maps.GoogleMap;
import com.google.android.gms.maps.GoogleMap.CancelableCallback;
import com.google.android.gms.maps.GoogleMap.OnCameraIdleListener;
import com.google.android.gms.maps.GoogleMap.OnCameraMoveCanceledListener;
import com.google.android.gms.maps.GoogleMap.OnCameraMoveListener;
import com.google.android.gms.maps.GoogleMap.OnCameraMoveStartedListener;
import com.google.android.gms.maps.OnMapReadyCallback;
import com.google.android.gms.maps.SupportMapFragment;
import com.google.android.gms.maps.model.CameraPosition;
import com.google.android.gms.maps.model.LatLng;
import com.google.android.gms.maps.model.PolylineOptions;

/**
 * This shows how to change the camera position for the map.
 */
public class CameraDemoActivity extends AppCompatActivity implements
        OnCameraMoveStartedListener,
        OnCameraMoveListener,
        OnCameraMoveCanceledListener,
        OnCameraIdleListener,
        OnMapReadyCallback {
    private static final String TAG = CameraDemoActivity.class.getName();

    /**
     * The amount by which to scroll the camera. Note that this amount is in raw pixels, not dp
     * (density-independent pixels).
     */
    private static final int SCROLL_BY_PX = 100;

    public static final CameraPosition BONDI =
            new CameraPosition.Builder().target(new LatLng(-33.891614, 151.276417))
                    .zoom(15.5f)
                    .bearing(300)
                    .tilt(50)
                    .build();

    public static final CameraPosition SYDNEY =
            new CameraPosition.Builder().target(new LatLng(-33.87365, 151.20689))
                    .zoom(15.5f)
                    .bearing(0)
                    .tilt(25)
                    .build();

    private GoogleMap map;
    private CompoundButton animateToggle;
    private CompoundButton customDurationToggle;
    private SeekBar customDurationBar;
    private PolylineOptions currPolylineOptions;
    private boolean isCanceled = false;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.camera_demo);
        animateToggle = findViewById(R.id.animate);
        customDurationToggle = findViewById(R.id.duration_toggle);
        customDurationBar = findViewById(R.id.duration_bar);

        updateEnabledState();

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

    @Override
    protected void onResume() {
        super.onResume();
        updateEnabledState();
    }

    @Override
    public void onMapReady(GoogleMap googleMap) {
        map = googleMap;

        map.setOnCameraIdleListener(this);
        map.setOnCameraMoveStartedListener(this);
        map.setOnCameraMoveListener(this);
        map.setOnCameraMoveCanceledListener(this);
        // We will provide our own zoom controls.
        map.getUiSettings().setZoomControlsEnabled(false);
        map.getUiSettings().setMyLocationButtonEnabled(true);

        // Show Sydney
        map.moveCamera(CameraUpdateFactory.newLatLngZoom(new LatLng(-33.87365, 151.20689), 10));
    }

    /**
     * When the map is not ready the CameraUpdateFactory cannot be used. This should be called on
     * all entry points that call methods on the Google Maps API.
     */
    private boolean checkReady() {
        if (map == null) {
            Toast.makeText(this, R.string.map_not_ready, Toast.LENGTH_SHORT).show();
            return false;
        }
        return true;
    }

    /**
     * Called when the Go To Bondi button is clicked.
     */
    public void onGoToBondi(View view) {
        if (!checkReady()) {
            return;
        }

        changeCamera(CameraUpdateFactory.newCameraPosition(BONDI));
    }

    /**
     * Called when the Animate To Sydney button is clicked.
     */
    public void onGoToSydney(View view) {
        if (!checkReady()) {
            return;
        }

        changeCamera(CameraUpdateFactory.newCameraPosition(SYDNEY), new CancelableCallback() {
            @Override
            public void onFinish() {
                Toast.makeText(getBaseContext(), "Animation to Sydney complete", Toast.LENGTH_SHORT)
                        .show();
            }

            @Override
            public void onCancel() {
                Toast.makeText(getBaseContext(), "Animation to Sydney canceled", Toast.LENGTH_SHORT)
                        .show();
            }
        });
    }

    /**
     * Called when the stop button is clicked.
     */
    public void onStopAnimation(View view) {
        if (!checkReady()) {
            return;
        }

        map.stopAnimation();
    }

    /**
     * Called when the zoom in button (the one with the +) is clicked.
     */
    public void onZoomIn(View view) {
        if (!checkReady()) {
            return;
        }

        changeCamera(CameraUpdateFactory.zoomIn());
    }

    /**
     * Called when the zoom out button (the one with the -) is clicked.
     */
    public void onZoomOut(View view) {
        if (!checkReady()) {
            return;
        }

        changeCamera(CameraUpdateFactory.zoomOut());
    }

    /**
     * Called when the tilt more button (the one with the /) is clicked.
     */
    public void onTiltMore(View view) {
        if (!checkReady()) {
            return;
        }

        CameraPosition currentCameraPosition = map.getCameraPosition();
        float currentTilt = currentCameraPosition.tilt;
        float newTilt = currentTilt + 10;

        newTilt = (newTilt > 90) ? 90 : newTilt;

        CameraPosition cameraPosition = new CameraPosition.Builder(currentCameraPosition)
                .tilt(newTilt).build();

        changeCamera(CameraUpdateFactory.newCameraPosition(cameraPosition));
    }

    /**
     * Called when the tilt less button (the one with the \) is clicked.
     */
    public void onTiltLess(View view) {
        if (!checkReady()) {
            return;
        }

        CameraPosition currentCameraPosition = map.getCameraPosition();

        float currentTilt = currentCameraPosition.tilt;

        float newTilt = currentTilt - 10;
        newTilt = (newTilt > 0) ? newTilt : 0;

        CameraPosition cameraPosition = new CameraPosition.Builder(currentCameraPosition)
                .tilt(newTilt).build();

        changeCamera(CameraUpdateFactory.newCameraPosition(cameraPosition));
    }

    /**
     * Called when the left arrow button is clicked. This causes the camera to move to the left
     */
    public void onScrollLeft(View view) {
        if (!checkReady()) {
            return;
        }

        changeCamera(CameraUpdateFactory.scrollBy(-SCROLL_BY_PX, 0));
    }

    /**
     * Called when the right arrow button is clicked. This causes the camera to move to the right.
     */
    public void onScrollRight(View view) {
        if (!checkReady()) {
            return;
        }

        changeCamera(CameraUpdateFactory.scrollBy(SCROLL_BY_PX, 0));
    }

    /**
     * Called when the up arrow button is clicked. The causes the camera to move up.
     */
    public void onScrollUp(View view) {
        if (!checkReady()) {
            return;
        }

        changeCamera(CameraUpdateFactory.scrollBy(0, -SCROLL_BY_PX));
    }

    /**
     * Called when the down arrow button is clicked. This causes the camera to move down.
     */
    public void onScrollDown(View view) {
        if (!checkReady()) {
            return;
        }

        changeCamera(CameraUpdateFactory.scrollBy(0, SCROLL_BY_PX));
    }

    /**
     * Called when the animate button is toggled
     */
    public void onToggleAnimate(View view) {
        updateEnabledState();
    }

    /**
     * Called when the custom duration checkbox is toggled
     */
    public void onToggleCustomDuration(View view) {
        updateEnabledState();
    }

    /**
     * Update the enabled state of the custom duration controls.
     */
    private void updateEnabledState() {
        customDurationToggle.setEnabled(animateToggle.isChecked());
        customDurationBar
                .setEnabled(animateToggle.isChecked() && customDurationToggle.isChecked());
    }

    private void changeCamera(CameraUpdate update) {
        changeCamera(update, null);
    }

    /**
     * Change the camera position by moving or animating the camera depending on the state of the
     * animate toggle button.
     */
    private void changeCamera(CameraUpdate update, CancelableCallback callback) {
        if (animateToggle.isChecked()) {
            if (customDurationToggle.isChecked()) {
                int duration = customDurationBar.getProgress();
                // The duration must be strictly positive so we make it at least 1.
                map.animateCamera(update, Math.max(duration, 1), callback);
            } else {
                map.animateCamera(update, callback);
            }
        } else {
            map.moveCamera(update);
        }
    }

    @Override
    public void onCameraMoveStarted(int reason) {
        if (!isCanceled) {
            map.clear();
        }

        String reasonText = "UNKNOWN_REASON";
        currPolylineOptions = new PolylineOptions().width(5);
        switch (reason) {
            case OnCameraMoveStartedListener.REASON_GESTURE:
                currPolylineOptions.color(Color.BLUE);
                reasonText = "GESTURE";
                break;
            case OnCameraMoveStartedListener.REASON_API_ANIMATION:
                currPolylineOptions.color(Color.RED);
                reasonText = "API_ANIMATION";
                break;
            case OnCameraMoveStartedListener.REASON_DEVELOPER_ANIMATION:
                currPolylineOptions.color(Color.GREEN);
                reasonText = "DEVELOPER_ANIMATION";
                break;
        }
        Log.d(TAG, "onCameraMoveStarted(" + reasonText + ")");
        addCameraTargetToPath();
    }

    @Override
    public void onCameraMove() {
        // When the camera is moving, add its target to the current path we'll draw on the map.
        if (currPolylineOptions != null) {
            addCameraTargetToPath();
        }
        Log.d(TAG, "onCameraMove");
    }

    @Override
    public void onCameraMoveCanceled() {
        // When the camera stops moving, add its target to the current path, and draw it on the map.
        if (currPolylineOptions != null) {
            addCameraTargetToPath();
            map.addPolyline(currPolylineOptions);
        }
        isCanceled = true;  // Set to clear the map when dragging starts again.
        currPolylineOptions = null;
        Log.d(TAG, "onCameraMoveCancelled");
    }

    @Override
    public void onCameraIdle() {
        if (currPolylineOptions != null) {
            addCameraTargetToPath();
            map.addPolyline(currPolylineOptions);
        }
        currPolylineOptions = null;
        isCanceled = false;  // Set to *not* clear the map when dragging starts again.
        Log.d(TAG, "onCameraIdle");
    }

    private void addCameraTargetToPath() {
        LatLng target = map.getCameraPosition().target;
        currPolylineOptions.add(target);
    }
}
CameraDemoActivity.java

Kotlin

/*
 * Copyright 2018 Google LLC
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *     https://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

package com.example.kotlindemos

import android.graphics.Color
import android.os.Bundle
import android.util.Log
import android.view.View
import android.widget.CompoundButton
import android.widget.SeekBar
import android.widget.Toast
import androidx.appcompat.app.AppCompatActivity
import com.google.android.gms.maps.CameraUpdate
import com.google.android.gms.maps.CameraUpdateFactory
import com.google.android.gms.maps.GoogleMap
import com.google.android.gms.maps.GoogleMap.CancelableCallback
import com.google.android.gms.maps.GoogleMap.OnCameraIdleListener
import com.google.android.gms.maps.GoogleMap.OnCameraMoveCanceledListener
import com.google.android.gms.maps.GoogleMap.OnCameraMoveListener
import com.google.android.gms.maps.GoogleMap.OnCameraMoveStartedListener
import com.google.android.gms.maps.OnMapReadyCallback
import com.google.android.gms.maps.SupportMapFragment
import com.google.android.gms.maps.model.CameraPosition
import com.google.android.gms.maps.model.LatLng
import com.google.android.gms.maps.model.PolylineOptions

/**
 * This shows how to change the camera position for the map.
 */
class CameraDemoActivity :
        AppCompatActivity(),
        OnCameraMoveStartedListener,
        OnCameraMoveListener,
        OnCameraMoveCanceledListener,
        OnCameraIdleListener,
        OnMapReadyCallback {
    /**
     * The amount by which to scroll the camera. Note that this amount is in raw pixels, not dp
     * (density-independent pixels).
     */
    private val SCROLL_BY_PX = 100
    private val TAG = CameraDemoActivity::class.java.name
    private val sydneyLatLng = LatLng(-33.87365, 151.20689)
    private val bondiLocation: CameraPosition = CameraPosition.Builder()
            .target(LatLng(-33.891614, 151.276417))
            .zoom(15.5f)
            .bearing(300f)
            .tilt(50f)
            .build()

    private val sydneyLocation: CameraPosition = CameraPosition.Builder().
            target(LatLng(-33.87365, 151.20689))
            .zoom(15.5f)
            .bearing(0f)
            .tilt(25f)
            .build()

    private lateinit var map: GoogleMap
    private lateinit var animateToggle: CompoundButton
    private lateinit var customDurationToggle: CompoundButton
    private lateinit var customDurationBar: SeekBar
    private var currPolylineOptions: PolylineOptions? = null
    private var isCanceled = false

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.camera_demo)
        animateToggle = findViewById(R.id.animate)
        customDurationToggle = findViewById(R.id.duration_toggle)
        customDurationBar = findViewById(R.id.duration_bar)

        updateEnabledState()

        val mapFragment = supportFragmentManager.findFragmentById(R.id.map) as SupportMapFragment
        mapFragment.getMapAsync(this)
    }

    override fun onResume() {
        super.onResume()
        updateEnabledState()
    }

    override fun onMapReady(googleMap: GoogleMap) {
        map = googleMap
        // return early if the map was not initialised properly
        with(googleMap) {
            setOnCameraIdleListener(this@CameraDemoActivity)
            setOnCameraMoveStartedListener(this@CameraDemoActivity)
            setOnCameraMoveListener(this@CameraDemoActivity)
            setOnCameraMoveCanceledListener(this@CameraDemoActivity)
            // We will provide our own zoom controls.
            uiSettings.isZoomControlsEnabled = false
            uiSettings.isMyLocationButtonEnabled = true

            // Show Sydney
            moveCamera(CameraUpdateFactory.newLatLngZoom(sydneyLatLng, 10f))
        }
    }

    /**
     * When the map is not ready the CameraUpdateFactory cannot be used. This should be used to wrap
     * all entry points that call methods on the Google Maps API.
     *
     * @param stuffToDo the code to be executed if the map is initialised
     */
    private fun checkReadyThen(stuffToDo: () -> Unit) {
        if (!::map.isInitialized) {
            Toast.makeText(this, R.string.map_not_ready, Toast.LENGTH_SHORT).show()
        } else {
            stuffToDo()
        }
    }

    /**
     * Called when the Go To Bondi button is clicked.
     */
    @Suppress("UNUSED_PARAMETER")
    fun onGoToBondi(view: View) {
        checkReadyThen {
            changeCamera(CameraUpdateFactory.newCameraPosition(bondiLocation))
        }
    }

    /**
     * Called when the Animate To Sydney button is clicked.
     */
    @Suppress("UNUSED_PARAMETER")
    fun onGoToSydney(view: View) {
        checkReadyThen {
            changeCamera(CameraUpdateFactory.newCameraPosition(sydneyLocation),
                    object : CancelableCallback {
                        override fun onFinish() {
                            Toast.makeText(baseContext, "Animation to Sydney complete",
                                    Toast.LENGTH_SHORT).show()
                        }

                        override fun onCancel() {
                            Toast.makeText(baseContext, "Animation to Sydney canceled",
                                    Toast.LENGTH_SHORT).show()
                        }
                    })
        }
    }

    /**
     * Called when the stop button is clicked.
     */
    @Suppress("UNUSED_PARAMETER")
    fun onStopAnimation(view: View) = checkReadyThen { map.stopAnimation() }

    /**
     * Called when the zoom in button (the one with the +) is clicked.
     */
    @Suppress("UNUSED_PARAMETER")
    fun onZoomIn(view: View) = checkReadyThen { changeCamera(CameraUpdateFactory.zoomIn()) }

    /**
     * Called when the zoom out button (the one with the -) is clicked.
     */
    @Suppress("UNUSED_PARAMETER")
    fun onZoomOut(view: View) = checkReadyThen { changeCamera(CameraUpdateFactory.zoomOut()) }

    /**
     * Called when the tilt more button (the one with the /) is clicked.
     */
    @Suppress("UNUSED_PARAMETER")
    fun onTiltMore(view: View) {
        checkReadyThen {

            val newTilt = Math.min(map.cameraPosition.tilt + 10, 90F)
            val cameraPosition = CameraPosition.Builder(map.cameraPosition).tilt(newTilt).build()

            changeCamera(CameraUpdateFactory.newCameraPosition(cameraPosition))
        }
    }

    /**
     * Called when the tilt less button (the one with the \) is clicked.
     */
    @Suppress("UNUSED_PARAMETER")
    fun onTiltLess(view: View) {
        checkReadyThen {

            val newTilt = Math.max(map.cameraPosition.tilt - 10, 0F)
            val cameraPosition = CameraPosition.Builder(map.cameraPosition).tilt(newTilt).build()

            changeCamera(CameraUpdateFactory.newCameraPosition(cameraPosition))
        }
    }

    /**
     * Called when the left arrow button is clicked. This causes the camera to move to the left
     */
    @Suppress("UNUSED_PARAMETER")
    fun onScrollLeft(view: View) {
        checkReadyThen {
            changeCamera(CameraUpdateFactory.scrollBy((-SCROLL_BY_PX).toFloat(),0f))
        }
    }

    /**
     * Called when the right arrow button is clicked. This causes the camera to move to the right.
     */
    @Suppress("UNUSED_PARAMETER")
    fun onScrollRight(view: View) {
        checkReadyThen {
            changeCamera(CameraUpdateFactory.scrollBy(SCROLL_BY_PX.toFloat(), 0f))
        }
    }

    /**
     * Called when the up arrow button is clicked. The causes the camera to move up.
     */
    @Suppress("UNUSED_PARAMETER")
    fun onScrollUp(view: View) {
        checkReadyThen {
            changeCamera(CameraUpdateFactory.scrollBy(0f, (-SCROLL_BY_PX).toFloat()))
        }
    }

    /**
     * Called when the down arrow button is clicked. This causes the camera to move down.
     */
    @Suppress("UNUSED_PARAMETER")
    fun onScrollDown(view: View) {
        checkReadyThen {
            changeCamera(CameraUpdateFactory.scrollBy(0f, SCROLL_BY_PX.toFloat()))
        }
    }

    /**
     * Called when the animate button is toggled
     */
    @Suppress("UNUSED_PARAMETER")
    fun onToggleAnimate(view: View) = updateEnabledState()

    /**
     * Called when the custom duration checkbox is toggled
     */
    @Suppress("UNUSED_PARAMETER")
    fun onToggleCustomDuration(view: View) = updateEnabledState()

    /**
     * Update the enabled state of the custom duration controls.
     */
    private fun updateEnabledState() {
        customDurationToggle.isEnabled = animateToggle.isChecked
        customDurationBar.isEnabled = animateToggle.isChecked && customDurationToggle.isChecked
    }

    /**
     * Change the camera position by moving or animating the camera depending on the state of the
     * animate toggle button.
     */
    private fun changeCamera(update: CameraUpdate, callback: CancelableCallback? = null) {
        if (animateToggle.isChecked) {
            if (customDurationToggle.isChecked) {
                // The duration must be strictly positive so we make it at least 1.
                map.animateCamera(update, Math.max(customDurationBar.progress, 1), callback)
            } else {
                map.animateCamera(update, callback)
            }
        } else {
            map.moveCamera(update)
        }
    }

    override fun onCameraMoveStarted(reason: Int) {
        if (!isCanceled) map.clear()

        var reasonText = "UNKNOWN_REASON"
        currPolylineOptions = PolylineOptions().width(5f)
        when (reason) {
            OnCameraMoveStartedListener.REASON_GESTURE -> {
                currPolylineOptions?.color(Color.BLUE)
                reasonText = "GESTURE"
            }
            OnCameraMoveStartedListener.REASON_API_ANIMATION -> {
                currPolylineOptions?.color(Color.RED)
                reasonText = "API_ANIMATION"
            }
            OnCameraMoveStartedListener.REASON_DEVELOPER_ANIMATION -> {
                currPolylineOptions?.color(Color.GREEN)
                reasonText = "DEVELOPER_ANIMATION"
            }
        }
        Log.d(TAG, "onCameraMoveStarted($reasonText)")
        addCameraTargetToPath()
    }

    /**
     * Ensures that currPolyLine options is not null before accessing it
     *
     * @param stuffToDo the code to be executed if currPolylineOptions is not null
     */
    private fun checkPolylineThen(stuffToDo: () -> Unit) {
        if (currPolylineOptions != null) stuffToDo()
    }

    override fun onCameraMove() {
        Log.d(TAG, "onCameraMove")
        // When the camera is moving, add its target to the current path we'll draw on the map.
        checkPolylineThen { addCameraTargetToPath() }
    }

    override fun onCameraMoveCanceled() {
        // When the camera stops moving, add its target to the current path, and draw it on the map.
        checkPolylineThen {
            addCameraTargetToPath()
            map.addPolyline(currPolylineOptions!!)
        }

        isCanceled = true  // Set to clear the map when dragging starts again.
        currPolylineOptions = null
        Log.d(TAG, "onCameraMoveCancelled")
    }

    override fun onCameraIdle() {
        checkPolylineThen {
            addCameraTargetToPath()
            map.addPolyline(currPolylineOptions!!)
        }

        currPolylineOptions = null
        isCanceled = false  // Set to *not* clear the map when dragging starts again.
        Log.d(TAG, "onCameraIdle")
    }
    private fun addCameraTargetToPath() {
        currPolylineOptions?.add(map.cameraPosition.target)
    }
}
CameraDemoActivity.kt

Dostępne są następujące detale:

• Wywołanie OnCameraMoveStartedListener funkcji onCameraMoveStarted() jest wywoływane, kiedy kamera zacznie się poruszać. Metoda wywołania zwrotnego otrzymuje reason dla ruchu kamery. Oto możliwe przyczyny:

  • REASON_GESTURE oznacza, że kamera porusza się w odpowiedzi na ruch użytkownika na mapie, np. przesuwanie, pochylanie, ściąganie, powiększanie czy obracanie mapy.
  • REASON_API_ANIMATION wskazuje, że interfejs API przesunął kamerę w odpowiedzi na działanie użytkownika, które nie wymaga gestu, na przykład kliknięcie przycisku powiększenia, kliknięcie przycisku Moja lokalizacja lub kliknięcie znacznika.
  • REASON_DEVELOPER_ANIMATION oznacza, że aplikacja zainicjowała ruch kamery.

• Wywołanie OnCameraMoveListener z metody onCameraMove() jest wywoływane wiele razy, gdy kamera się porusza lub użytkownik korzysta z ekranu dotykowego. Aby się dowiedzieć, jak często wywoływane jest wywołanie zwrotne, warto wiedzieć, że interfejs API wywołuje wywołanie zwrotne raz na ramkę. Pamiętaj jednak, że to wywołanie zwrotne jest wywoływane asynchronicznie i dlatego nie jest zsynchronizowane z obrazem na ekranie. Pamiętaj też, że pozycja kamery może pozostać niezmieniona między jednym wywołaniem onCameraMove() a kolejnym.

• Wywołanie OnCameraIdleListener wywołania OnCameraIdle() jest wywoływane, gdy kamera przestanie się poruszać, a użytkownik przestanie korzystać z mapy.

• Wywołanie OnCameraMoveCanceledListener elementu OnCameraMoveCanceled() jest wywoływane po przerwaniu bieżącego ruchu kamery. Zaraz po wywołaniu OnCameraMoveCanceled() wywołanie zwrotne onCameraMoveStarted() jest wywoływane z nowym reason.

  Jeśli Twoja aplikacja jednoznacznie wywołuje metodę GoogleMap.stopAnimation(), wywołanie zwrotne OnCameraMoveCanceled() jest wywoływane, ale wywołanie zwrotne onCameraMoveStarted() nie jest wywoływane.

Aby ustawić detektor na mapie, wywołaj odpowiednią metodę set-detektor. Aby na przykład poprosić o oddzwonienie z numeru OnCameraMoveStartedListener, zadzwoń pod numer GoogleMap.setOnCameraMoveStartedListener().

Wartość docelową kamery (szerokość i długość geograficzną), przybliżenie, kąt uchylenia i pochylenie kamery możesz uzyskać z CameraPosition. Szczegółowe informacje o tych właściwościach znajdziesz w przewodniku po pozycji kamery.

Powiadomienie o wycofaniu: interfejs OnCameraChangeListener został wycofany i wybrany dla słuchaczy opisanych powyżej. Są to: OnCameraMoveStartedListener, OnCameraMoveListener, OnCameraMoveCanceledListener i OnCameraIdleListener.

Wydarzenia w firmach i inne ciekawe miejsca

Domyślnie ciekawe miejsca są wyróżnione na mapie podstawowej wraz z odpowiednimi ikonami. Ciekawe miejsca obejmują parki, szkoły, budynki administracji publicznej oraz inne ważne miejsca, takie jak sklepy, restauracje i hotele.

Możesz odpowiadać na zdarzenia kliknięcia w danym miejscu. Zobacz przewodnik po firmach i innych ciekawych miejscach.

Wydarzenia związane z mapą obiektu

Korzystając ze zdarzeń, możesz znaleźć i dostosować aktywny poziom mapy obiektu. Korzystając z interfejsu OnIndoorStateChangeListener, możesz skonfigurować detektor, który będzie wywoływany, gdy nowy budynek zostanie aktywowany lub aktywowany zostanie nowy poziom.

Aby uzyskać informacje o konkretnym budynku, zadzwoń pod numer GoogleMap.getFocusedBuilding(). Wyśrodkowanie mapy na określonym końcu/długości geograficznej zwykle daje początek budynku, ale nie jest to gwarantowane.

Następnie możesz znaleźć aktualny poziom, wywołując opcję IndoorBuilding.getActiveLevelIndex().

Java

IndoorBuilding building = map.getFocusedBuilding();
if (building != null) {
    int activeLevelIndex = building.getActiveLevelIndex();
    IndoorLevel activeLevel = building.getLevels().get(activeLevelIndex);
}

      

Kotlin

map.focusedBuilding?.let { building: IndoorBuilding ->
    val activeLevelIndex = building.activeLevelIndex
    val activeLevel = building.levels[activeLevelIndex]
}

      

Jest to przydatne, gdy chcesz wyświetlić niestandardowe znaczniki dla aktywnego poziomu, takie jak znaczniki, nakładki na ziemi, nakładki z kafelkami, wielokąty, linie łamane i inne kształty.

Podpowiedź: aby wrócić do poziomu ulicy, uzyskaj domyślny poziom za pomocą IndoorBuilding.getDefaultLevelIndex() i ustaw go jako aktywny na IndoorLevel.activate().

Zdarzenia znacznika i okna informacyjnego

Możesz nasłuchiwać zdarzeń znaczników i odpowiadać na nie, w tym zdarzeń kliknięcia i przeciągnięcia znacznika, ustawiając odpowiedni detektor w obiekcie GoogleMap, do którego należy znacznik. Przeczytaj przewodnik po znacznikach zdarzeń.

Możesz też odsłuchiwać zdarzenia w oknach informacyjnych.

Zdarzenia kształtów i nakładek

Możesz nasłuchiwać zdarzeń kliknięcia i odpowiadać na nie na liniach, wielokątach, kręgach i nakładkach podstawowych.

Uwaga: jeśli nałożonych jest wiele nakładek lub kształtów (znaczniki, linie łamane, wielokąty, okręgi lub warstwy na ziemi), zdarzenie kliknięcia jest po kolei wyświetlane po klastrze znaczników, a następnie uruchamiane w przypadku innych klikalnych nakładek lub kształtów na podstawie ich wartości kolejności nakładania. Wywołuje się maksymalnie jedno zdarzenie na kliknięcie. Oznacza to, że kliknięcie nie jest przekazywane do nakładek ani kształtów o niższych wartościach z-index. Dowiedz się więcej o zdarzeniach z-index i kliknięciach znaczników.

Zdarzenia dotyczące lokalizacji

Aplikacja może reagować na te zdarzenia związane z warstwą Moja lokalizacja:

• Jeśli użytkownik kliknie przycisk Moja lokalizacja, aplikacja otrzyma wywołanie zwrotne onMyLocationButtonClick() z GoogleMap.OnMyLocationButtonClickListener.
• Jeśli użytkownik kliknie niebieski punkt mojej lokalizacji, aplikacja odbierze wywołanie onMyLocationClick() z GoogleMap.OnMyLocationClickListener.

Szczegółowe informacje znajdziesz w przewodniku po warstwie Moja lokalizacja.