Current Place

Entwickler im Europäischen Wirtschaftsraum (EWR)

Mit dem Places SDK for Android können Sie den Ort am derzeit gemeldeten Standort des Geräts ermitteln. Beispiele für Orte sind lokale Unternehmen, Sehenswürdigkeiten und geografische Standorte.

Berechtigungen

Um die Bibliothek zu verwenden, müssen Sie keine zusätzlichen Berechtigungen im Manifest Ihrer App deklarieren, da die Bibliothek alle von ihr verwendeten Berechtigungen in ihrem Manifest deklariert. Wenn Ihre App jedoch PlacesClient.findCurrentPlace() verwendet, müssen Sie Berechtigungen zur Standortermittlung zur Laufzeit anfordern.

Wenn Ihre App PlacesClient.findCurrentPlace() nicht verwendet, entfernen Sie die durch die Bibliothek eingeführten Berechtigungen ACCESS_FINE_LOCATION und ACCESS_COARSE_LOCATION explizit, indem Sie Ihrem Manifest Folgendes hinzufügen:

<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>

Weitere Informationen zu Berechtigungen und EasyPermissions

Aktuellen Standort anfordern

So finden Sie das lokale Unternehmen oder den anderen Ort, an dem sich das Gerät gerade befindet:

  1. Rufen Sie ContextCompat.checkSelfPermission auf, um zu prüfen, ob der Nutzer die Berechtigung zum Zugriff auf den Standort seines Geräts erteilt hat. Ihre App muss außerdem Code enthalten, um den Nutzer nach der Berechtigung zu fragen und das Ergebnis zu verarbeiten. Weitere Informationen finden Sie unter App-Berechtigungen anfordern.
  2. Erstellen Sie ein FindCurrentPlaceRequest und übergeben Sie ein List von Place.Fields, um die Arten von Ortsdaten anzugeben, die Ihre App anfordern soll.
  3. Rufen Sie PlacesClient.findCurrentPlace() auf und übergeben Sie die FindCurrentPlaceRequest, die Sie im vorherigen Schritt erstellt haben.
  4. Rufen Sie die Liste der PlaceLikelihoods aus dem FindCurrentPlaceResponse ab.

Die Felder entsprechen „Place Search“-Ergebnissen und sind in drei Abrechnungskategorien unterteilt: „Basic“, „Contact“ und „Atmosphere“. Für Felder der Kategorie „Basic“ gilt der Basispreis und es fallen keine zusätzlichen Kosten an. Für Felder der Kategorie „Contact“ und „Atmosphere“ werden höhere Kosten abgerechnet. Weitere Informationen zur Abrechnung von Anfragen für Ortsdaten finden Sie unter Nutzung und Abrechnung.

Die API gibt ein FindCurrentPlaceResponse in einem Task zurück. FindCurrentPlaceResponse enthält eine Liste von PlaceLikelihood-Objekten, die Orte darstellen, an denen sich das Gerät wahrscheinlich befindet. Für jeden Ort enthält das Ergebnis einen Hinweis darauf, wie wahrscheinlich es ist, dass es sich um den richtigen Ort handelt. Die Liste kann leer sein, wenn es keinen bekannten Ort gibt, der dem angegebenen Gerätestandort entspricht.

Sie können PlaceLikelihood.getPlace() aufrufen, um ein Place-Objekt abzurufen, und PlaceLikelihood.getLikelihood(), um die Wahrscheinlichkeitsbewertung des Orts abzurufen. Ein höherer Wert bedeutet eine größere Wahrscheinlichkeit, dass der Ort die beste Übereinstimmung ist.

Im folgenden Codebeispiel wird die Liste der Orte abgerufen, an denen sich das Gerät höchstwahrscheinlich befindet, und der Name und die Wahrscheinlichkeit für jeden Ort werden protokolliert.

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

Anmerkungen zu den Wahrscheinlichkeitswerten

  • Die Wahrscheinlichkeit gibt eine relative Wahrscheinlichkeit dafür an, dass der Ort die beste Übereinstimmung in der Liste der zurückgegebenen Orte für eine einzelne Anfrage ist. Sie können Wahrscheinlichkeiten nicht für verschiedene Anfragen vergleichen.
  • Der Wert der Wahrscheinlichkeit liegt zwischen 0,0 und 1,0.

Wenn beispielsweise die Wahrscheinlichkeit, dass der richtige Ort Ort A ist, 55% beträgt und die Wahrscheinlichkeit, dass es sich um Ort B handelt, 35 %, enthält die Antwort zwei Elemente: Ort A mit einer Wahrscheinlichkeit von 0,55 und Ort B mit einer Wahrscheinlichkeit von 0,35.

Zuordnungen in der App anzeigen

Wenn in Ihrer App Informationen angezeigt werden, die durch Aufrufen von PlacesClient.findCurrentPlace() eingeholt wurden, müssen auch Quellenangaben eingeblendet werden. Weitere Informationen finden Sie in der Dokumentation zu Attributionen.