Local atual

Selecione a plataforma: Android iOS

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

Observação: para ver um tutorial prático guiado, consulte o tutorial do local atual.

Permissões

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

Se o app não usa 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 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. O app também precisa incluir código para solicitar a permissão do usuário e processar o resultado. Consulte Solicitar permissões do app para ver mais detalhes.
2. Crie um FindCurrentPlaceRequest, transmitindo um List de Place.Fields, especificando os tipos de dados de lugar que o app deve solicitar.
3. Chame PlacesClient.findCurrentPlace(), transmitindo o FindCurrentPlaceRequest que você criou na etapa anterior.
4. Veja a lista de PlaceLikelihoods do FindCurrentPlaceResponse.

Observação: findCurrentPlace() NÃO oferece suporte aos seguintes campos: Place.Field.ADDRESS_COMPONENTS, Place.Field.OPENING_HOURS, Place.Field.PHONE_NUMBER, Place.Field.UTC_OFFSET e Place.Field.WEBSITE_URI.

Os campos correspondem aos resultados do Place Search e são divididos em três categorias de faturamento: "Basic", "Contact" e "Atmosphere". Os campos básicos são faturados pela 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 em que 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 pode estar vazia se não houver um local conhecido correspondente à localização do dispositivo.

Você pode chamar PlaceLikelihood.getPlace() para recuperar um objeto Place e PlaceLikelihood.getLikelihood() para ver a classificação de probabilidade do lugar. Um valor maior significa uma probabilidade maior 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 provavelmente está localizado e registra o nome e a probabilidade de cada um.

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();
}

      

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()
}

      

Observações sobre os valores de probabilidade:

• A probabilidade indica a probabilidade relativa de o local ser a melhor correspondência na lista de locais retornados para uma única solicitação. Não é possível comparar as probabilidades em solicitações diferentes.
• O valor da probabilidade vai estar 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 o lugar B seja uma resposta, há dois membros: a lugar A com uma probabilidade de 0, 55 e o lugar B com uma probabilidade de 0,35.

É possível usar um CancelToken para tentar cancelar uma solicitação em qualquer uma das classes de solicitação (por exemplo, FetchPlaceRequest). O cancelamento é feito na medida do possível. Quando uma solicitação de cancelamento é emitida, nenhuma resposta é retornada. A emissão de um token de cancelamento NÃO garante que uma solicitação específica seja cancelada, e você ainda pode receber uma cobrança por ela, mesmo que nenhuma resposta seja retornada.

Exibir atribuições no seu aplicativo

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