Com o SDK do Places para Android, você pode descobrir o local no o local relatado no momento do dispositivo. Exemplos de lugares incluem locais empresas, pontos de interesse e localizações geográficas.
Permissões
Para usar a biblioteca, não é necessário declarar nenhuma permissão adicional no manifesto do app.
porque a biblioteca declara todas as permissões usadas no manifesto. No entanto, se o aplicativo usa
PlacesClient.findCurrentPlace()
,
solicite permissões de localização no momento da execução.
Caso seu app não use PlacesClient.findCurrentPlace()
, remova explicitamente o
Introdução das permissões ACCESS_FINE_LOCATION
e ACCESS_COARSE_LOCATION
pela biblioteca adicionando o seguinte ao manifesto:
<manifest ... xmlns:tools="http://schemas.android.com/tools"> ... <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" tools:node="remove"/> <uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" tools:node="remove"/> ... </manifest>
Leia mais sobre permissões e considere usar EasyPermissions para começar.
Obter localização atual
Para encontrar a empresa local ou outro lugar onde o dispositivo está siga estas etapas:
- Chamar
ContextCompat.checkSelfPermission
para verificar se o usuário concedeu permissão para acessar o dispositivo o local. O app também precisa incluir código para solicitar a permissão do usuário. e lidar com o resultado. Consulte Solicitar permissões do app. para mais detalhes. - Crie um
FindCurrentPlaceRequest
, transmitindo umList
dePlace.Field
s, especificando o tipos de dados de lugar que seu aplicativo deve solicitar. - Chame
PlacesClient.findCurrentPlace()
, transmitindo oFindCurrentPlaceRequest
que você criou na etapa. - Acesse a lista de
PlaceLikelihood
s noFindCurrentPlaceResponse
Os campos correspondem aos resultados da Pesquisa de local e são divididos em três categorias de cobrança: "Basic", "Contact" e "Atmosphere". Os campos "Basic" são faturados na taxa básica e não geram cargas. Os campos "Contact" e "Atmosphere" são faturados em uma taxa maior. Para mais informações sobre como as solicitações de dados de lugar são faturadas, consulte Uso e faturamento.
A API retorna uma
FindCurrentPlaceResponse
em um
Task
O FindCurrentPlaceResponse
contém uma lista de
PlaceLikelihood
objetos que representam lugares onde o dispositivo provavelmente está localizado. Para
cada local, o resultado incluirá uma indicação da probabilidade de
o lugar certo. Se não houver um lugar conhecido, a lista poderá ficar vazia.
correspondente à localização do dispositivo especificada.
Você pode ligar
PlaceLikelihood.getPlace()
para recuperar um
Place
objeto e
PlaceLikelihood.getLikelihood()
para obter a classificação de probabilidade do lugar. Um valor maior significa um maior
probabilidade de que o lugar seja a melhor correspondência.
O exemplo de código a seguir recupera a lista de locais em que o dispositivo com mais probabilidade de ser localizado e registra o nome e a probabilidade de cada local.
Kotlin
// Use fields to define the data types to return. val placeFields: List<Place.Field> = listOf(Place.Field.NAME) // Use the builder to create a FindCurrentPlaceRequest. val request: FindCurrentPlaceRequest = FindCurrentPlaceRequest.newInstance(placeFields) // Call findCurrentPlace and handle the response (first check that the user has granted permission). if (ContextCompat.checkSelfPermission(this, permission.ACCESS_FINE_LOCATION) == PackageManager.PERMISSION_GRANTED) { val placeResponse = placesClient.findCurrentPlace(request) placeResponse.addOnCompleteListener { task -> if (task.isSuccessful) { val response = task.result for (placeLikelihood: PlaceLikelihood in response?.placeLikelihoods ?: emptyList()) { Log.i( TAG, "Place '${placeLikelihood.place.name}' has likelihood: ${placeLikelihood.likelihood}" ) } } else { val exception = task.exception if (exception is ApiException) { Log.e(TAG, "Place not found: ${exception.statusCode}") } } } } else { // A local method to request required permissions; // See https://developer.android.com/training/permissions/requesting getLocationPermission() }
Java
// Use fields to define the data types to return. List<Place.Field> placeFields = Collections.singletonList(Place.Field.NAME); // Use the builder to create a FindCurrentPlaceRequest. FindCurrentPlaceRequest request = FindCurrentPlaceRequest.newInstance(placeFields); // Call findCurrentPlace and handle the response (first check that the user has granted permission). if (ContextCompat.checkSelfPermission(this, ACCESS_FINE_LOCATION) == PackageManager.PERMISSION_GRANTED) { Task<FindCurrentPlaceResponse> placeResponse = placesClient.findCurrentPlace(request); placeResponse.addOnCompleteListener(task -> { if (task.isSuccessful()){ FindCurrentPlaceResponse response = task.getResult(); for (PlaceLikelihood placeLikelihood : response.getPlaceLikelihoods()) { Log.i(TAG, String.format("Place '%s' has likelihood: %f", placeLikelihood.getPlace().getName(), placeLikelihood.getLikelihood())); } } else { Exception exception = task.getException(); if (exception instanceof ApiException) { ApiException apiException = (ApiException) exception; Log.e(TAG, "Place not found: " + apiException.getStatusCode()); } } }); } else { // A local method to request required permissions; // See https://developer.android.com/training/permissions/requesting getLocationPermission(); }
Observações sobre os valores de probabilidade:
- A probabilidade fornece uma probabilidade relativa do local sendo a melhor correspondência dentro da lista de locais retornados para uma com uma única solicitação. Não é possível comparar probabilidades entre solicitações diferentes.
- O valor da probabilidade estará entre 0,0 e 1,0.
Por exemplo, para representar uma probabilidade de 55% de que o lugar correto seja Lugar A e uma probabilidade de 35% de que seja o Lugar B, a resposta tem dois membros, Local A com uma probabilidade de 0,55 e Local B com uma probabilidade de 0,35.
Exibir atribuições no seu aplicativo
Quando o app exibe informações recebidas de
PlacesClient.findCurrentPlace()
,
o aplicativo também deve exibir atribuições. Consulte a documentação
atribuições.