Jedną z wyjątkowych cech aplikacji mobilnych jest to, że mogą one wykrywać lokalizację. Użytkownicy mobilni mają przy sobie swoje urządzenia i mogą dodać lokalizację. świadomość Twojej aplikacji zapewnia użytkownikom bardziej kontekstowe wrażenia.
Przykładowe fragmenty kodu
Repozytorium API Apigee na GitHubie zawiera: przykłady ilustrujące użycie lokalizacji na mapie:
Kotlin
- MyLocationDemoActivity: korzystanie z tagu Warstwa Moja lokalizacja, w tym uprawnienia czasu działania.
- LocationSourceDemoActivity: za pomocą parametru niestandardowego
LocationSource
- CurrentPlaceDetailsOnMap: znajdowanie bieżącego lokalizacji urządzenia z Androidem i wyświetlania szczegółowych informacji o danym miejscu (firmy lub inne ciekawe miejsce) w tej lokalizacji. Zobacz samouczek na temat programu aktualnych szczegółów miejsca na mapie.
Java
- MyLocationDemoActivity: korzystanie z tagu Warstwa Moja lokalizacja, w tym uprawnienia czasu działania.
- LocationSourceDemoActivity: za pomocą parametru niestandardowego
LocationSource
- CurrentPlaceDetailsOnMap: znajdowanie bieżącego lokalizacji urządzenia z Androidem i wyświetlania szczegółowych informacji o danym miejscu (firmy lub inne ciekawe miejsce) w tej lokalizacji. Zobacz samouczek na temat programu aktualnych szczegółów miejsca na mapie.
Praca z danymi o lokalizacji
Dane o lokalizacji dostępne dla urządzenia z Androidem obejmują bieżącą lokalizację urządzeń – wyświetlanych za pomocą kombinacji technologii – kierunek i metodę ruchu oraz czy urządzenie przemieściło się w poprzek do wstępnie zdefiniowanej granicy geograficznej, czyli geofencingu. W zależności od potrzeb Twojej aplikacji, możesz wybrać jeden z kilku sposobów pracy z lokalizacją dane:
- Warstwa Moja lokalizacja umożliwia w prosty sposób wyświetlanie lokalizację na mapie. Nie dostarcza danych.
- Interfejs Google Play Services Location API jest zalecany w przypadku wszystkich zautomatyzowane żądania dotyczące danych o lokalizacji.
- Interfejs
LocationSource
umożliwia podawanie niestandardowego dostawcy lokalizacji.
Dostęp do lokalizacji
Jeśli aplikacja potrzebuje dostępu do lokalizacji użytkownika, o jego pozwolenie musisz poprosić w dodaj do aplikacji odpowiednie dostęp do lokalizacji na urządzeniach z Androidem.
Android udostępnia 2 uprawnienia dostępu do lokalizacji: ACCESS_COARSE_LOCATION
oraz
ACCESS_FINE_LOCATION
Wybrane uprawnienie określa dokładność
lokalizację zwracaną przez interfejs API.
android.permission.ACCESS_COARSE_LOCATION
– zezwala interfejsowi API na zwrócenie przybliżonej lokalizacji urządzenia. udostępnia przybliżoną lokalizację urządzenia z usług lokalizacyjnych, opisane w dokumentacji dotyczącej przybliżonej lokalizacji dokładności.android.permission.ACCESS_FINE_LOCATION
– pozwala interfejsowi API określić możliwie dokładną lokalizację dostępnych dostawców lokalizacji, w tym globalnego systemu pozycjonowania. (GPS) oraz Wi-Fi i komórkowej transmisji danych.
Dodaj uprawnienia do pliku manifestu aplikacji
Jeśli do działania aplikacji potrzebna jest tylko przybliżona lokalizacja, dodaj parametr
Uprawnienia ACCESS_COARSE_LOCATION
do pliku manifestu aplikacji:
<manifest xmlns:android="http://schemas.android.com/apk/res/android" package="com.example.myapp" > ... <uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION"/> ... </manifest>
Jeśli jednak potrzebna jest dokładna lokalizacja, dodaj zarówno ACCESS_COARSE_LOCATION
,
i uprawnienie ACCESS_FINE_LOCATION
do pliku manifestu Twojej aplikacji:
<manifest xmlns:android="http://schemas.android.com/apk/res/android" package="com.example.myapp" > ... <uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION"/> <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION"/> ... </manifest>
Poproś o uprawnienia w czasie działania
Android 6.0 (Marshmallow) wprowadza nowy model obsługi uprawnień, upraszcza proces instalowania i aktualizacji aplikacji. Jeśli aplikacja jest kierowana na interfejs API na poziomie 23 lub nowszym, możesz użyć nowego modelu uprawnień.
Jeśli Twoja aplikacja obsługuje nowy model uprawnień, a na urządzeniu działa Android 6.0 (Marshmallow) lub nowszego, użytkownik nie musi przyznawać żadnych uprawnień. podczas instalowania lub uaktualniania aplikacji. Aplikacja musi sprawdzić, czy ma wymagane uprawnienia w czasie działania i je prosi o ich przyznanie, nie ma tej funkcji. System wyświetli okno z prośbą o przyznanie uprawnień.
Ze względu na wygodę użytkowników prośby o przyznanie uprawnień warto wysyłać w kontekście. Jeśli lokalizacja jest niezbędna do działania aplikacji, dostęp do lokalizacji podczas uruchamiania aplikacji. Aby to zrobić, użyj ciepła ekran powitalny lub kreator informujący użytkowników o przyczynach
Jeśli aplikacja wymaga uprawnień tylko do niektórych funkcji, powinna prosić o dostęp do lokalizacji, gdy aplikacja działanie, które wymaga tych uprawnień.
Aplikacja musi bezproblemowo obsługiwać sprawę, w przypadku której użytkownik nie wyrazi zgody uprawnienia. Jeśli na przykład uprawnienie jest potrzebne do działania danej funkcji, może ją wyłączyć. Jeśli uprawnienia są niezbędne, aby aplikacja aplikacja może wyłączyć wszystkie funkcje i poinformować użytkownika, że którzy muszą przyznać te uprawnienia.
Poniżej znajduje się przykładowy kod, który sprawdza uprawnienia za pomocą biblioteki AndroidaX
przed włączeniem warstwy Moja lokalizacja. Następnie obsługuje wyniki funkcji
prośby o zgodę, implementując
ActivityCompat.OnRequestPermissionsResultCallback
w bibliotece pomocy:
Kotlin
// 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.kotlindemos import android.Manifest import android.annotation.SuppressLint import android.content.pm.PackageManager import android.location.Location import android.os.Bundle import android.widget.Toast import androidx.appcompat.app.AppCompatActivity import androidx.core.app.ActivityCompat import androidx.core.app.ActivityCompat.OnRequestPermissionsResultCallback import androidx.core.content.ContextCompat import com.example.kotlindemos.PermissionUtils.PermissionDeniedDialog.Companion.newInstance import com.example.kotlindemos.PermissionUtils.isPermissionGranted import com.google.android.gms.maps.GoogleMap import com.google.android.gms.maps.GoogleMap.OnMyLocationButtonClickListener import com.google.android.gms.maps.GoogleMap.OnMyLocationClickListener import com.google.android.gms.maps.OnMapReadyCallback import com.google.android.gms.maps.SupportMapFragment /** * This demo shows how GMS Location can be used to check for changes to the users location. The * "My Location" button uses GMS Location to set the blue dot representing the users location. * Permission for [Manifest.permission.ACCESS_FINE_LOCATION] and [Manifest.permission.ACCESS_COARSE_LOCATION] * are requested at run time. If either permission is not granted, the Activity is finished with an error message. */ class MyLocationDemoActivity : AppCompatActivity(), OnMyLocationButtonClickListener, OnMyLocationClickListener, OnMapReadyCallback, OnRequestPermissionsResultCallback { /** * Flag indicating whether a requested permission has been denied after returning in * [.onRequestPermissionsResult]. */ private var permissionDenied = false private lateinit var map: GoogleMap override fun onCreate(savedInstanceState: Bundle?) { super.onCreate(savedInstanceState) setContentView(R.layout.my_location_demo) val mapFragment = supportFragmentManager.findFragmentById(R.id.map) as SupportMapFragment? mapFragment?.getMapAsync(this) } override fun onMapReady(googleMap: GoogleMap) { map = googleMap googleMap.setOnMyLocationButtonClickListener(this) googleMap.setOnMyLocationClickListener(this) enableMyLocation() } /** * Enables the My Location layer if the fine location permission has been granted. */ @SuppressLint("MissingPermission") private fun enableMyLocation() { // 1. Check if permissions are granted, if so, enable the my location layer if (ContextCompat.checkSelfPermission( this, Manifest.permission.ACCESS_FINE_LOCATION ) == PackageManager.PERMISSION_GRANTED || ContextCompat.checkSelfPermission( this, Manifest.permission.ACCESS_COARSE_LOCATION ) == PackageManager.PERMISSION_GRANTED ) { map.isMyLocationEnabled = true return } // 2. If if a permission rationale dialog should be shown if (ActivityCompat.shouldShowRequestPermissionRationale( this, Manifest.permission.ACCESS_FINE_LOCATION ) || ActivityCompat.shouldShowRequestPermissionRationale( this, Manifest.permission.ACCESS_COARSE_LOCATION ) ) { PermissionUtils.RationaleDialog.newInstance( LOCATION_PERMISSION_REQUEST_CODE, true ).show(supportFragmentManager, "dialog") return } // 3. Otherwise, request permission ActivityCompat.requestPermissions( this, arrayOf( Manifest.permission.ACCESS_FINE_LOCATION, Manifest.permission.ACCESS_COARSE_LOCATION ), LOCATION_PERMISSION_REQUEST_CODE ) } override fun onMyLocationButtonClick(): Boolean { Toast.makeText(this, "MyLocation button clicked", Toast.LENGTH_SHORT) .show() // Return false so that we don't consume the event and the default behavior still occurs // (the camera animates to the user's current position). return false } override fun onMyLocationClick(location: Location) { Toast.makeText(this, "Current location:\n$location", Toast.LENGTH_LONG) .show() } override fun onRequestPermissionsResult( requestCode: Int, permissions: Array<String>, grantResults: IntArray ) { if (requestCode != LOCATION_PERMISSION_REQUEST_CODE) { super.onRequestPermissionsResult( requestCode, permissions, grantResults ) return } if (isPermissionGranted( permissions, grantResults, Manifest.permission.ACCESS_FINE_LOCATION ) || isPermissionGranted( permissions, grantResults, Manifest.permission.ACCESS_COARSE_LOCATION ) ) { // Enable the my location layer if the permission has been granted. enableMyLocation() } else { // Permission was denied. Display an error message // Display the missing permission error dialog when the fragments resume. permissionDenied = true } } override fun onResumeFragments() { super.onResumeFragments() if (permissionDenied) { // Permission was not granted, display error dialog. showMissingPermissionError() permissionDenied = false } } /** * Displays a dialog with error message explaining that the location permission is missing. */ private fun showMissingPermissionError() { newInstance(true).show(supportFragmentManager, "dialog") } companion object { /** * Request code for location permission request. * * @see .onRequestPermissionsResult */ private const val LOCATION_PERMISSION_REQUEST_CODE = 1 } }
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.Manifest.permission; import android.annotation.SuppressLint; import com.google.android.gms.maps.GoogleMap; import com.google.android.gms.maps.GoogleMap.OnMyLocationButtonClickListener; import com.google.android.gms.maps.GoogleMap.OnMyLocationClickListener; import com.google.android.gms.maps.OnMapReadyCallback; import com.google.android.gms.maps.SupportMapFragment; import android.Manifest; import android.content.pm.PackageManager; import android.location.Location; import android.os.Bundle; import androidx.annotation.NonNull; import androidx.appcompat.app.AppCompatActivity; import androidx.core.app.ActivityCompat; import androidx.core.content.ContextCompat; import android.widget.Toast; /** * This demo shows how GMS Location can be used to check for changes to the users location. The "My * Location" button uses GMS Location to set the blue dot representing the users location. * Permission for {@link android.Manifest.permission#ACCESS_FINE_LOCATION} and {@link * android.Manifest.permission#ACCESS_COARSE_LOCATION} are requested at run time. If either * permission is not granted, the Activity is finished with an error message. */ public class MyLocationDemoActivity extends AppCompatActivity implements OnMyLocationButtonClickListener, OnMyLocationClickListener, OnMapReadyCallback, ActivityCompat.OnRequestPermissionsResultCallback { /** * Request code for location permission request. * * @see #onRequestPermissionsResult(int, String[], int[]) */ private static final int LOCATION_PERMISSION_REQUEST_CODE = 1; /** * Flag indicating whether a requested permission has been denied after returning in {@link * #onRequestPermissionsResult(int, String[], int[])}. */ private boolean permissionDenied = false; private GoogleMap map; @Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.my_location_demo); SupportMapFragment mapFragment = (SupportMapFragment) getSupportFragmentManager().findFragmentById(R.id.map); mapFragment.getMapAsync(this); } @Override public void onMapReady(@NonNull GoogleMap googleMap) { map = googleMap; map.setOnMyLocationButtonClickListener(this); map.setOnMyLocationClickListener(this); enableMyLocation(); } /** * Enables the My Location layer if the fine location permission has been granted. */ @SuppressLint("MissingPermission") private void enableMyLocation() { // 1. Check if permissions are granted, if so, enable the my location layer if (ContextCompat.checkSelfPermission(this, Manifest.permission.ACCESS_FINE_LOCATION) == PackageManager.PERMISSION_GRANTED || ContextCompat.checkSelfPermission(this, permission.ACCESS_COARSE_LOCATION) == PackageManager.PERMISSION_GRANTED) { map.setMyLocationEnabled(true); return; } // 2. Otherwise, request location permissions from the user. PermissionUtils.requestLocationPermissions(this, LOCATION_PERMISSION_REQUEST_CODE, true); } @Override public boolean onMyLocationButtonClick() { Toast.makeText(this, "MyLocation button clicked", Toast.LENGTH_SHORT).show(); // Return false so that we don't consume the event and the default behavior still occurs // (the camera animates to the user's current position). return false; } @Override public void onMyLocationClick(@NonNull Location location) { Toast.makeText(this, "Current location:\n" + location, Toast.LENGTH_LONG).show(); } @Override public void onRequestPermissionsResult(int requestCode, @NonNull String[] permissions, @NonNull int[] grantResults) { if (requestCode != LOCATION_PERMISSION_REQUEST_CODE) { super.onRequestPermissionsResult(requestCode, permissions, grantResults); return; } if (PermissionUtils.isPermissionGranted(permissions, grantResults, Manifest.permission.ACCESS_FINE_LOCATION) || PermissionUtils .isPermissionGranted(permissions, grantResults, Manifest.permission.ACCESS_COARSE_LOCATION)) { // Enable the my location layer if the permission has been granted. enableMyLocation(); } else { // Permission was denied. Display an error message // Display the missing permission error dialog when the fragments resume. permissionDenied = true; } } @Override protected void onResumeFragments() { super.onResumeFragments(); if (permissionDenied) { // Permission was not granted, display error dialog. showMissingPermissionError(); permissionDenied = false; } } /** * Displays a dialog with error message explaining that the location permission is missing. */ private void showMissingPermissionError() { PermissionUtils.PermissionDeniedDialog .newInstance(true).show(getSupportFragmentManager(), "dialog"); } }
Warstwa Moja lokalizacja
Możesz użyć warstwy Moja lokalizacja oraz przycisku Moja lokalizacja, aby wyświetlać swoje
użytkownik może sprawdzić swoją bieżącą pozycję na mapie. Zadzwoń pod numer mMap.setMyLocationEnabled()
aby włączyć warstwę Moja lokalizacja na mapie.
Poniższy przykład pokazuje proste zastosowanie warstwy Moja lokalizacja:
Kotlin
// 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.google.maps.example.kotlin import android.annotation.SuppressLint import android.location.Location import android.os.Bundle import android.widget.Toast import androidx.appcompat.app.AppCompatActivity import com.google.android.gms.maps.GoogleMap import com.google.android.gms.maps.GoogleMap.OnMyLocationButtonClickListener import com.google.android.gms.maps.GoogleMap.OnMyLocationClickListener import com.google.android.gms.maps.OnMapReadyCallback import com.google.android.gms.maps.SupportMapFragment import com.google.maps.example.R internal class MyLocationLayerActivity : AppCompatActivity(), OnMyLocationButtonClickListener, OnMyLocationClickListener, OnMapReadyCallback { override fun onCreate(savedInstanceState: Bundle?) { super.onCreate(savedInstanceState) setContentView(R.layout.activity_my_location) val mapFragment = supportFragmentManager.findFragmentById(R.id.map) as SupportMapFragment mapFragment.getMapAsync(this) } @SuppressLint("MissingPermission") override fun onMapReady(map: GoogleMap) { // TODO: Before enabling the My Location layer, you must request // location permission from the user. This sample does not include // a request for location permission. map.isMyLocationEnabled = true map.setOnMyLocationButtonClickListener(this) map.setOnMyLocationClickListener(this) } override fun onMyLocationClick(location: Location) { Toast.makeText(this, "Current location:\n$location", Toast.LENGTH_LONG) .show() } override fun onMyLocationButtonClick(): Boolean { Toast.makeText(this, "MyLocation button clicked", Toast.LENGTH_SHORT) .show() // Return false so that we don't consume the event and the default behavior still occurs // (the camera animates to the user's current position). return false } }
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.google.maps.example; import android.annotation.SuppressLint; import android.location.Location; import android.os.Bundle; import android.widget.Toast; import androidx.annotation.NonNull; import androidx.appcompat.app.AppCompatActivity; import com.google.android.gms.maps.GoogleMap; import com.google.android.gms.maps.OnMapReadyCallback; import com.google.android.gms.maps.SupportMapFragment; class MyLocationLayerActivity extends AppCompatActivity implements GoogleMap.OnMyLocationButtonClickListener, GoogleMap.OnMyLocationClickListener, OnMapReadyCallback { @Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.activity_my_location); SupportMapFragment mapFragment = (SupportMapFragment) getSupportFragmentManager().findFragmentById(R.id.map); mapFragment.getMapAsync(this); } @SuppressLint("MissingPermission") @Override public void onMapReady(GoogleMap map) { // TODO: Before enabling the My Location layer, you must request // location permission from the user. This sample does not include // a request for location permission. map.setMyLocationEnabled(true); map.setOnMyLocationButtonClickListener(this); map.setOnMyLocationClickListener(this); } @Override public void onMyLocationClick(@NonNull Location location) { Toast.makeText(this, "Current location:\n" + location, Toast.LENGTH_LONG) .show(); } @Override public boolean onMyLocationButtonClick() { Toast.makeText(this, "MyLocation button clicked", Toast.LENGTH_SHORT) .show(); // Return false so that we don't consume the event and the default behavior still occurs // (the camera animates to the user's current position). return false; } }
Gdy włączona jest warstwa Moja lokalizacja, w w prawym górnym rogu mapy. Gdy użytkownik kliknie przycisk, kamera zostanie wyśrodkowana. mapę na aktualnej lokalizacji urządzenia, o ile jest ona znana. Lokalizacja jest oznaczona na mapie małą niebieską kropką, jeśli urządzenie jest nieruchome, lub szewron, gdy urządzenie jest w ruchu.
Na poniższym zrzucie ekranu widać przycisk Moja lokalizacja w prawym górnym rogu oraz Niebieski punkt „Moja lokalizacja” na środku mapy:
Możesz zapobiec wyświetlaniu przycisku Moja lokalizacja, dzwoniąc
UiSettings.setMyLocationButtonEnabled(false)
Aplikacja może reagować na te zdarzenia:
- Jeśli użytkownik kliknie przycisk Moja lokalizacja, aplikacja otrzyma
onMyLocationButtonClick()
wywołanie zwrotne zGoogleMap.OnMyLocationButtonClickListener
- Jeśli użytkownik kliknie niebieski punkt Moja lokalizacja, aplikacja otrzyma
onMyLocationClick()
wywołanie zwrotne zGoogleMap.OnMyLocationClickListener
Interfejs Google Play Services Location API
Preferowaną metodą jest interfejs API lokalizacji Usług Google Play. do zwiększania świadomości lokalizacji w aplikacjach na Androida. Zawiera on: która pozwala:
- Określ lokalizację urządzenia.
- Wykrywaj zmiany lokalizacji.
- Ustal środek transportu, jeśli urządzenie jest w ruchu.
- Tworzenie i monitorowanie wstępnie zdefiniowanych regionów geograficznych, tzw. geofence.
Interfejsy API lokalizacji ułatwiają tworzenie wydajnych rozwiązań, aplikacji zorientowanych na lokalizację. Podobnie jak w przypadku pakietu Maps SDK na Androida, funkcja lokalizacji Interfejs API jest rozpowszechniany w ramach pakietu SDK Usług Google Play. Więcej informacji na temat interfejsu Location API znajdziesz w zajęciach szkoleniowych dotyczących Androida Uwzględnianie lokalizacji w aplikacji i interfejs API lokalizacji Plik referencyjny. Przykładowe fragmenty kodu są częścią Pakiet SDK Usług Google Play.