Dzięki pakietowi Maps SDK na Androida możesz nasłuchiwać zdarzeń na mapie.
Przykładowe fragmenty kodu
Repozytorium API Apigee na GitHubie zawiera: przykłady, które pokazują zdarzenia i detektory:
Kotlin
- EventsDemoActivity: zdarzenia kliknięcia mapy i zmiany kamery
- CameraDemoActivity: zdarzenia zmiany kamery.
- CircleDemoActivity: zdarzenia kliknięcia i przeciągania znacznika
- GroundOverlayDemoActivity: zdarzenia kliknięcia nakładki z podłożem.
- IndoorDemoActivity: zdarzenia mapy obiektów.
- MarkerDemoActivity: zdarzenia znaczników i okna informacyjnego.
- PolygonDemoActivity: zdarzenia dotyczące wielokątów.
Java
- EventsDemoActivity: mapowanie zdarzeń kliknięcia i zmiany kamery
- CameraDemoActivity: zdarzenia zmiany kamery.
- CircleDemoActivity: zaznaczaj i przeciągaj zdarzenia.
- GroundOverlayDemoActivity: zdarzenia kliknięcia nakładki z podłożem.
- IndoorDemoActivity: wydarzenia na mapach obiektów.
- MarkerDemoActivity: zdarzenia znaczników i okna informacyjnego.
- PolygonDemoActivity: zdarzenia dotyczące wielokątów.
Zdarzenia kliknięcia na mapie / kliknięcia długiego kliknięcia
Jeśli chcesz odpowiedzieć użytkownikowi, który kliknie punkt na mapie, możesz użyć przycisku
OnMapClickListener
, który można ustawić na mapie,
Dzwonię pod numer GoogleMap.setOnMapClickListener(OnMapClickListener)
. Gdy użytkownik
kliknięcia (kliknięcia) w dowolnym miejscu na mapie, otrzymasz onMapClick(LatLng)
, które wskazuje lokalizację na mapie, którą kliknął użytkownik. Pamiętaj, że
Jeśli potrzebujesz odpowiedniego miejsca na ekranie (w pikselach), możesz
uzyskać z mapy Projection
, który umożliwia konwersję
między długością i szerokością geograficzną a współrzędnymi pikselami ekranu.
Możesz też rejestrować zdarzenia przytrzymania za pomocą funkcji
OnMapLongClickListener
, które możesz ustawić na
mapy, dzwoniąc pod numer GoogleMap.setOnMapLongClickListener(OnMapLongClickListener)
.
Ten detektor działa podobnie jak detektor kliknięć i będzie powiadamiony o zdarzeniach długiego kliknięcia za pomocą wywołania zwrotnego onMapLongClick(LatLng)
.
Wyłączanie zdarzeń kliknięcia w wersji uproszczonej
Aby wyłączyć zdarzenia kliknięcia na mapie w wersji uproszczonej, zadzwoń pod numer setClickable()
w widoku zawierającym MapView
lub MapFragment
. To jest przydatne,
na przykład do wyświetlenia mapy lub map w widoku listy,
zdarzenie kliknięcia wywołujące działanie niezwiązane z mapą.
Opcja wyłączenia zdarzeń kliknięcia jest dostępna tylko w wersji uproszczonej. Wyłączenie zdarzeń kliknięć spowoduje też, że znaczniki nie będą klikalne. Nie wpłynie to na inne elementy sterujące na mapie.
W przypadku MapView
:
Kotlin
val mapView = findViewById<MapView>(R.id.mapView) mapView.isClickable = false
Java
MapView mapView = findViewById(R.id.mapView); mapView.setClickable(false);
W przypadku MapFragment
:
Kotlin
val mapFragment = supportFragmentManager .findFragmentById(R.id.map) as SupportMapFragment val view = mapFragment.view view?.isClickable = false
Java
SupportMapFragment mapFragment = (SupportMapFragment) getSupportFragmentManager() .findFragmentById(R.id.map); View view = mapFragment.getView(); view.setClickable(false);
Zdarzenia zmiany kamery
Widok mapy jest modelowany jako kamera patrząca w dół na płaskiej płaszczyźnie. Dostępne opcje zmienić właściwości kamery, by dostosować poziom powiększenia, widok z perspektywy mapy. Przeczytaj przewodnik po aparacie. Użytkownicy może również wpływać na działanie aparatu, wykonując gesty.
Dzięki detektorom zmiany kamery możesz śledzić ruchy kamery. Twoja aplikacja może otrzymywać powiadomienia o zdarzeniach rozpoczęcia, trwającej i zakończenia ruchu kamery. Ty może też sprawdzić, dlaczego kamera się porusza? animacjami wbudowanych interfejsu API lub ruchami kontrolowanymi przez programistę.
Poniższy przykład pokazuje wszystkie dostępne detektory zdarzeń kamery:
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) } }
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); } }
Dostępne są te detektory kamer:
Wywołanie zwrotne
onCameraMoveStarted()
dlaOnCameraMoveStartedListener
jest wywoływany, gdy kamera zacznie się poruszać. Metoda wywołania zwrotnego otrzymujereason
za ruch kamery. Przyczyny mogą być następujące:REASON_GESTURE
oznacza, że kamera poruszyła się w reakcji na gest na mapie, taki jak przesuwanie, przechylanie, ściąganie palców, aby powiększyć lub i obracam mapę.REASON_API_ANIMATION
oznacza, że interfejs API przesunął kamerę do wewnątrz. reakcja na wykonywane przez użytkownika czynności, które nie są gestami, np. kliknięcie przycisku powiększenia, wybierając przycisk Moja lokalizacja lub klikając znacznik.REASON_DEVELOPER_ANIMATION
oznacza, że aplikacja zainicjowała ruch kamery.
Wywoływane jest wywołanie zwrotne
onCameraMove()
funkcjiOnCameraMoveListener
gdy kamera jest w ruchu lub użytkownik wchodzi z nią w interakcję. ekranu dotykowego. Wskazuje, jak często jest wywoływane wywołanie zwrotne, (interfejs API wywołuje wywołanie zwrotne raz na klatkę). Pamiętaj jednak, że to wywołanie zwrotne jest wywoływane asynchronicznie i dlatego nie jest zsynchronizowane z co widać na ekranie. Pamiętaj też, że aparat może pozycja pozostaje niezmieniona między jednym wywołaniem zwrotnymonCameraMove()
a co dalej.Funkcja zwracana przez wywołanie zwrotne
OnCameraIdle()
OnCameraIdleListener
jest wywoływana, gdy kamera przestanie się poruszać i użytkownik przestanie wchodzić w interakcję z mapą.Wywołanie zwrotne funkcji
OnCameraMoveCanceled()
PoleOnCameraMoveCanceledListener
jest wywoływane podczas bieżącego ruchu kamery zostało przerwane. Bezpośrednio po Wywołanie zwrotneOnCameraMoveCanceled()
, wywołanie zwrotneonCameraMoveStarted()
to wywołano przy użyciu nowego parametrureason
.Jeśli aplikacja wyraźnie łączy się
GoogleMap.stopAnimation()
,OnCameraMoveCanceled()
wywołanie zwrotneonCameraMoveStarted()
jest nie .
Aby ustawić detektor na mapie, wywołaj odpowiednią metodę set-detener.
Aby na przykład poprosić o oddzwonienie z numeru OnCameraMoveStartedListener
, wywołaj
GoogleMap.setOnCameraMoveStartedListener()
Możesz wyświetlić cel kamery (szerokość i długość geograficzną), powiększenie, położenie i nachylenie kamery.
z CameraPosition
. Zobacz przewodnik
pozycji kamery, by uzyskać szczegółowe informacje o tych właściwościach.
Wydarzenia w firmach i innych ciekawych miejscach
Domyślnie ciekawe miejsca (POI) są wyświetlane na mapie podstawowej wraz z ich odpowiadające im ikony. Punkty zainteresowania obejmują parki, szkoły, budynki rządowe i inne obiekty, a także punkty zainteresowania związane z biznesem, takie jak sklepy, restauracje i hotele.
Możesz odpowiadać na zdarzenia kliknięcia związane z ważnym miejscem. Zapoznaj się z przewodnikiem po firmach i innych ciekawe miejsca.
Wydarzenia na mapach obiektów
Za pomocą zdarzeń możesz znaleźć i dostosować aktywny poziom mapy obiektu. Użyj interfejsu OnIndoorStateChangeListener
, aby ustawić wywołanie detektora, które ma być wykonywane, gdy nowy budynek zostanie wyśrodkowany lub nowy poziom zostanie aktywowany w budynku.
Pobierz aktualnie widoczny budynek, wywołując
GoogleMap.getFocusedBuilding()
Wyśrodkowanie mapy na określonej szerokości/długości geograficznej
zwykle uzyskujesz budynek przy tej szerokości i długości, ale nie jest to gwarantowane.
Możesz wtedy znaleźć aktualnie aktywny poziom, dzwoniąc pod numer
IndoorBuilding.getActiveLevelIndex()
Kotlin
map.focusedBuilding?.let { building: IndoorBuilding -> val activeLevelIndex = building.activeLevelIndex val activeLevel = building.levels[activeLevelIndex] }
Java
IndoorBuilding building = map.getFocusedBuilding(); if (building != null) { int activeLevelIndex = building.getActiveLevelIndex(); IndoorLevel activeLevel = building.getLevels().get(activeLevelIndex); }
Jest to przydatne, jeśli chcesz wyświetlić niestandardowe znaczniki dla aktywnego poziomu, np. znaczniki, nakładki na powierzchnię, nakładki kafelków, wielokąty, linie łamane i inne kształty.
Wskazówka: aby wrócić do poziomu ulicy, ustaw poziom domyślny w
IndoorBuilding.getDefaultLevelIndex()
i ustaw go jako aktywny w
IndoorLevel.activate()
Zdarzenia znacznika i okna informacyjnego
Możesz nasłuchiwać zdarzeń znaczników, w tym ich kliknięcia i przeciągania, i reagować na nie
zdarzeń przez ustawienie odpowiedniego detektora obiektu GoogleMap
, który
lub znacznik. Zobacz przewodnik po oznaczaniu zdarzeń.
Możesz też nasłuchiwać zdarzeń w oknach informacyjnych.
Zdarzenia dotyczące kształtu i nakładek
Możesz nasłuchiwać zdarzeń kliknięcia i reagować na nie na liniach łamanych, wielokąty, koła oraz nakładki na powierzchnię.
Zdarzenia lokalizacji
Aplikacja może reagować na następujące zdarzenia związane z warstwą Moja lokalizacja:
- Jeśli użytkownik kliknie przycisk Moja lokalizacja, Twoja aplikacja otrzyma wywołanie zwrotne
onMyLocationButtonClick()
zGoogleMap.OnMyLocationButtonClickListener
. - Jeśli użytkownik kliknie niebieski punkt Moja lokalizacja, aplikacja otrzyma
onMyLocationClick()
wywołanie zwrotne zGoogleMap.OnMyLocationClickListener
Szczegółowe informacje znajdziesz w przewodniku dotyczącym warstwy Moja lokalizacja.