Local atual (legado)

Desenvolvedores do Espaço Econômico Europeu (EEE)

Com o SDK do Places para Android, você pode descobrir o lugar na localização informada pelo dispositivo no momento. Exemplos de lugares incluem empresas locais, pontos de interesse e localizações geográficas.

Permissões

Para usar a biblioteca, não é necessário declarar outras permissões no manifesto do app, já que a biblioteca declara todas as permissões que usa no próprio manifesto. No entanto, se o app usar PlacesClient.findCurrentPlace(), será necessário solicitar permissões de localização no momento da execução.

Se o app não usar PlacesClient.findCurrentPlace(), remova explicitamente as permissões ACCESS_FINE_LOCATION e ACCESS_COARSE_LOCATION introduzidas 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 o EasyPermissions para começar.

Obter localização atual

Para encontrar a empresa local ou outro lugar onde o dispositivo está localizado, siga estas etapas:

  1. Chame ContextCompat.checkSelfPermission para verificar se o usuário concedeu permissão para acessar a localização do dispositivo. Seu app também precisa incluir um código para solicitar permissão ao usuário e processar o resultado. Consulte Solicitar permissões do app para mais detalhes.
  2. Crie um FindCurrentPlaceRequest, transmitindo um List de Place.Fields, especificando os tipos de dados de lugar que o app precisa solicitar.
  3. Chame PlacesClient.findCurrentPlace(), transmitindo o FindCurrentPlaceRequest que você criou na etapa anterior.
  4. Acesse a lista de PlaceLikelihoods do FindCurrentPlaceResponse.

Os campos correspondem aos resultados da pesquisa do Place Search e são divididos em três categorias de faturamento: Basic, Contact e Atmosphere. Os campos "Basic" são faturados na taxa básica e não geram cobranças extras. 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 um FindCurrentPlaceResponse em um Task. O FindCurrentPlaceResponse contém uma lista de objetos PlaceLikelihood que representam lugares onde o dispositivo provavelmente está localizado. Para cada lugar, o resultado inclui uma indicação da probabilidade de que o lugar seja o correto. A lista poderá ficar vazia se não houver um lugar conhecido correspondente à localização do dispositivo.

Chame PlaceLikelihood.getPlace() para recuperar um objeto Place e PlaceLikelihood.getLikelihood() para conferir a classificação de probabilidade do lugar. Um valor mais alto significa uma probabilidade maior de que o lugar seja a melhor correspondência.

O exemplo de código a seguir recupera a lista de lugares em que o dispositivo tem mais probabilidade de estar e registra o nome e a probabilidade de cada lugar.

Kotlin

// Use fields to define the data types to return.
val placeFields = listOf(Place.Field.DISPLAY_NAME, Place.Field.FORMATTED_ADDRESS, Place.Field.LOCATION)

// Define the search area around the current location (500m radius).
val currentLocation = LatLng(37.4220, -122.0841)
val circle = CircularBounds.newInstance(currentLocation, 500.0)
val request = SearchNearbyRequest.builder(circle, placeFields)
    .setMaxResultCount(20)
    .build()

// Call searchNearby and handle the response (first check that the user has granted permission).
if (ContextCompat.checkSelfPermission(this, permission.ACCESS_FINE_LOCATION) ==
    PackageManager.PERMISSION_GRANTED
) {
    placesClient.searchNearby(request).addOnSuccessListener { response ->
        binding.progressBar.visibility = View.GONE
        adapter.setPlaces(response.places)
    }.addOnFailureListener { exception ->
        binding.progressBar.visibility = View.GONE
        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 =
        Arrays.asList(
                Place.Field.DISPLAY_NAME,
                Place.Field.FORMATTED_ADDRESS,
                Place.Field.LOCATION);

// Define the search area around the current location.
LatLng currentLocation = new LatLng(37.4220, -122.0841);
LocationRestriction circle =
        CircularBounds.newInstance(currentLocation, /* radius= */ 500.0);

// Use the builder to create a SearchNearbyRequest.
SearchNearbyRequest request =
        SearchNearbyRequest.builder(circle, placeFields).setMaxResultCount(20).build();

// Call searchNearby and handle the response (first check that the user has granted
// permission).
if (ContextCompat.checkSelfPermission(this, ACCESS_FINE_LOCATION)
        == PackageManager.PERMISSION_GRANTED) {
    Task<SearchNearbyResponse> placeResponse = placesClient.searchNearby(request);
    placeResponse.addOnCompleteListener(
            task -> {
                binding.progressBar.setVisibility(View.GONE);
                if (task.isSuccessful()) {
                    SearchNearbyResponse response = task.getResult();
                    adapter.setPlaces(response.getPlaces());
                } else {
                    Exception exception = task.getException();
                    if (exception instanceof ApiException apiException) {
                        Log.e(
                                "CurrentPlace",
                                "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 de o lugar ser a melhor correspondência na lista de lugares retornados para uma única solicitação. Não é possível comparar probabilidades entre solicitações diferentes.
  • O valor da probabilidade será entre 0,0 e 1,0.

Por exemplo, para representar uma probabilidade de 55% de que o lugar correto seja o Lugar A e uma probabilidade de 35% de que seja o Lugar B, a resposta tem dois membros: o Lugar A com uma probabilidade de 0, 55 e o Lugar B com uma probabilidade de 0,35.

Exibir atribuições no seu aplicativo

Quando o app mostra informações de PlacesClient.findCurrentPlace(), ele também precisa exibir as atribuições. Consulte a documentação sobre atribuições.