Za pomocą pakietu SDK Map Google na Androida możesz nasłuchiwać zdarzeń na mapie.
Przykładowe fragmenty kodu
Repozytorium ApiDemos w GitHubie zawiera przykłady przedstawiające zdarzenia i detektory:
Kotlin
- EventsDemoActivity: mapowanie zdarzeń kliknięcia i zmiany kamery
- CameraDemoActivity: zdarzenia związane ze zmianą kamery.
- CircleDemoActivity: kliknięcia i przeciąganie znacznikami.
- GroundOverlayDemoActivity: zdarzenia kliknięcia nakładki docelowej.
- IndoorDemoActivity: wydarzenia na mapie obiektu.
- MarkerDemoActivity: znacznik i zdarzenia w oknie informacyjnym.
- PolygonDemoActivity: zdarzenia Polygon.
Java
- EventsDemoActivity: mapowanie zdarzeń kliknięcia i zmiany kamery
- CameraDemoActivity: zdarzenia związane ze zmianą kamery.
- CircleDemoActivity: kliknięcia i przeciąganie znacznikami.
- GroundOverlayDemoActivity: zdarzenia kliknięcia nakładki docelowej.
- IndoorDemoActivity: wydarzenia na mapie obiektu.
- MarkerDemoActivity: znacznik i zdarzenia w oknie informacyjnym.
- PolygonDemoActivity: zdarzenia Polygon.
Zdarzenia kliknięcia mapy lub długiego kliknięcia
Jeśli chcesz odpowiedzieć użytkownikowi, który kliknie punkt na mapie, możesz użyć obiektu OnMapClickListener
, który możesz ustawić na mapie, wywołując GoogleMap.setOnMapClickListener(OnMapClickListener)
. Gdy użytkownik kliknie (kliknie) dowolne miejsce na mapie, otrzymasz zdarzenie onMapClick(LatLng)
wskazujące lokalizację klikniętą na mapie. Pamiętaj, że jeśli potrzebujesz odpowiedniej lokalizacji na ekranie (w pikselach), możesz uzyskać z mapy Projection
, który umożliwia konwersję między współrzędnymi szerokości i długości geograficznej a współrzędnymi piksela ekranu.
Możesz też wykrywać zdarzenia długich kliknięć za pomocą OnMapLongClickListener
, które możesz ustawić na mapie, wywołując GoogleMap.setOnMapLongClickListener(OnMapLongClickListener)
.
Ten detektor działa podobnie do detektora kliknięć i będzie otrzymywać powiadomienia o zdarzeniach długich kliknięć za pomocą wywołania zwrotnego onMapLongClick(LatLng)
.
Wyłączanie zdarzeń kliknięć 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, gdy chcesz, aby zdarzenie kliknięcia wywołuje działanie niezwiązane z mapą.
Opcja wyłączania zdarzeń kliknięcia jest dostępna tylko w wersji uproszczonej. Wyłączenie zdarzeń kliknięcia sprawi też, że nie będzie można klikać znaczników. Nie będzie to miało wpływu 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 dotyczące zmiany aparatu
Widok mapy jest modelowany jako aparat patrzący na płaską płaszczyznę. Możesz zmieniać właściwości kamery, aby wpływać na poziom powiększenia, port widoku i perspektywę mapy. Zobacz przewodnik po aparacie. Użytkownicy mogą też wykonywać gesty związane z kamerą.
Za pomocą detektorów zmian kamery możesz śledzić ruch kamery. Aplikacja może otrzymywać powiadomienia o zdarzeniach rozpoczęcia, trwania i zakończenia ruchu kamery. Możesz też sprawdzić, dlaczego kamera się porusza – czy to spowodowane gestami użytkownika, wbudowanymi animacjami interfejsu API czy ruchami kontrolowanymi przez programistę.
Poniższy przykład ilustruje 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()
klasyOnCameraMoveStartedListener
jest wywoływane, gdy kamera zacznie się poruszać. Metoda wywołania zwrotnego otrzymuje wartośćreason
związaną z ruchem kamery. Możliwe przyczyny:REASON_GESTURE
oznacza, że kamera poruszyła się w reakcji na gest użytkownika na mapie, taki jak przesunięcie, pochylenie, ściągnięcie palcami, aby powiększyć lub obrócić mapę.REASON_API_ANIMATION
wskazuje, że interfejs API przesunął kamerę w odpowiedzi na działanie użytkownika, które nie wykonuje gestu, takie jak kliknięcie przycisku powiększenia, kliknięcie przycisku Moja lokalizacja czy kliknięcie znacznika.REASON_DEVELOPER_ANIMATION
oznacza, że aplikacja zainicjowała ruch kamery.
Wywołanie zwrotne
onCameraMove()
obiektuOnCameraMoveListener
jest wywoływane wiele razy, gdy kamera się porusza lub użytkownik wchodzi w interakcję z ekranem dotykowym. Informując o częstotliwości wywołania zwrotnego, warto wiedzieć, że interfejs API wywołuje to wywołanie raz na klatkę. Pamiętaj jednak, że to wywołanie zwrotne jest wywoływane asynchronicznie i dlatego nie jest zsynchronizowane z tym, co widać na ekranie. Pamiętaj też, że pozycja kamery może pozostać niezmieniona między wywołaniem zwrotnymonCameraMove()
a następnym wywołaniem.Wywołanie zwrotne
OnCameraIdle()
obiektuOnCameraIdleListener
jest wywoływane, gdy kamera przestaje się poruszać, a użytkownik zakończy interakcję z mapą.Wywołanie zwrotne
OnCameraMoveCanceled()
interfejsuOnCameraMoveCanceledListener
jest wywoływane po przerwaniu bieżącego ruchu kamery. Bezpośrednio po wywołaniu zwrotnymOnCameraMoveCanceled()
wywołanie zwrotneonCameraMoveStarted()
jest wywoływane z nowymreason
.Jeśli aplikacja wyraźnie wywołuje metodę
GoogleMap.stopAnimation()
, wywołanie zwrotneOnCameraMoveCanceled()
jest wywoływane, ale wywołanie zwrotneonCameraMoveStarted()
nie.
Aby ustawić odbiornik na mapie, wywołaj odpowiednią metodę set-listener.
Jeśli chcesz np. poprosić o oddzwonienie z firmy OnCameraMoveStartedListener
, zadzwoń pod numer GoogleMap.setOnCameraMoveStartedListener()
.
CameraPosition
pozwala określić docelowy zasięg kamery (szerokość i długość geograficzną), powiększenie, kierunek i przechylenie kamery. Szczegółowe informacje o tych właściwościach znajdziesz w przewodniku po pozycji kamery.
Wydarzenia związane z firmami i innymi ciekawymi miejscami
Domyślnie ciekawe miejsca (POI) są wyświetlane na mapie podstawowej wraz z odpowiadającymi im ikonami. Ważne miejsca to m.in. parki, szkoły i budynki administracji, a także ważne miejsca biznesowe, takie jak sklepy, restauracje i hotele.
Możesz odpowiadać na kliknięcia ważnych miejsc. Zapoznaj się z przewodnikiem po firmach i innych ciekawych miejscach.
Wydarzenia związane z mapami obiektu
Korzystając ze zdarzeń, możesz znajdować i dostosowywać aktywny poziom mapy obiektu. Korzystając z interfejsu OnIndoorStateChangeListener
, możesz skonfigurować detektor, który ma być wywoływany, gdy aktywuje się nowy budynek lub nowy poziom w budynku.
Pobierz budynek, który jest obecnie widoczny, wywołując metodę GoogleMap.getFocusedBuilding()
.
Wyśrodkowanie mapy na konkretnej szerokości i długości
umożliwia wyświetlenie budynku z tą samą szerokością i długością, ale nie jest to gwarantowane.
Następnie możesz sprawdzić aktywny poziom, wywołując metodę 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, gdy chcesz wyświetlać niestandardowe znaczniki dla poziomu aktywnego, takie jak znaczniki, nakładki na powierzchni, nakładki z kafelków, wielokąty, linie łamane i inne kształty.
Wskazówka: aby wrócić na poziom ulicy, pobierz poziom domyślny za pomocą funkcji IndoorBuilding.getDefaultLevelIndex()
i ustaw go jako poziom aktywny: IndoorLevel.activate()
.
Zdarzenia znacznika i okna informacyjnego
Możesz nasłuchiwać zdarzeń znacznika, w tym zdarzeń kliknięcia i przeciągania znacznika, i ustawić odpowiedni detektor w obiekcie GoogleMap
, do którego należy znacznik. Zobacz przewodnik po oznaczaniu zdarzeń.
Możesz też odsłuchiwać zdarzenia w oknach informacyjnych.
Zdarzenia dotyczące kształtów i nakładek
Możesz rejestrować zdarzenia kliknięcia i reagować na zdarzenia kliknięcia linii łamanych, wielokątów, okręgów i nakładek na powierzchni.
Zdarzenia związane z lokalizacją
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 protokołuGoogleMap.OnMyLocationButtonClickListener
. - Jeśli użytkownik kliknie niebieski punkt Moja lokalizacja, aplikacja otrzyma wywołanie zwrotne
onMyLocationClick()
zGoogleMap.OnMyLocationClickListener
.
Szczegółowe informacje znajdziesz w przewodniku po warstwie Moja lokalizacja.