Local atual

Selecione a plataforma: Android iOS

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.

Observação : para trabalhar com um tutorial prático guiado, consulte o Tutorial do lugar atual.

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:

1. 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.
2. Crie um FindCurrentPlaceRequest, transmitindo um List de Place.Fields, especificando o tipos de dados de lugar que seu aplicativo deve solicitar.
3. Chame PlacesClient.findCurrentPlace(), transmitindo o FindCurrentPlaceRequest que você criou na etapa.
4. Acesse a lista de PlaceLikelihoods no FindCurrentPlaceResponse

Observação: embora PlacesClient.fetchPlace() suporta todos os detalhes do lugar, PlacesClient.findCurrentPlace() aceita apenas um subconjunto de detalhes do lugar. Para a lista de campos NOT compatível com findCurrentPlace(). Consulte Suporte a campos do SDK do Places para Android

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.

Observação:para mais informações sobre como inicializar o PlacesClient, consulte Inicialize o cliente da API Places.

Você pode usar um CancellationToken para tentar cancelar uma solicitação para 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 determinada solicitação será cancelado e ainda poderá ser cobrado pela solicitação mesmo que não for retornada.

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.