Auf Google APIs zugreifen

Wenn Sie in Ihrer Android-App auf APIs zugreifen möchten, die von Google Play-Diensten unterstützt werden, müssen Sie API-Clientobjekte verwenden. Diese Objekte verarbeiten die Verbindung zu den Google Play-Diensten, stellen Anfragen in die Warteschlange und führen sie in der richtigen Reihenfolge aus, wenn eine Verbindung verfügbar ist. Sie können bei Bedarf neue API-Clients erstellen, da sie kostengünstig sind.

Jetzt starten

Bevor Sie beginnen, müssen Sie Google Play-Dienste in Ihrem App-Projekt einrichten.

Warnung :APIs, die GoogleApiClient verwenden, werden eingestellt. Wenn Sie GoogleApiClient noch verwenden, migrieren Sie zu den entsprechenden GoogleApi-basierten APIs, indem Sie auf die neuesten verfügbaren SDK-Versionen aktualisieren.

Wenn Sie auf einen Dienst zugreifen möchten, für den keine Autorisierung erforderlich ist, erstellen Sie eine Instanz des Clientobjekts des Dienstes und übergeben Sie entweder ein Context- oder ein Activity-Objekt. Bei Bedarf werden Nutzer aufgefordert, Google Play-Dienste zu aktualisieren, bevor API-Aufrufe ausgeführt werden.

Das folgende Code-Snippet zeigt, wie der letzte bekannte Standort des Geräts mit dem Fused Location Provider abgerufen wird:

Kotlin

// Code required for requesting location permissions omitted for brevity.
val client = LocationServices.getFusedLocationProviderClient(this)

// Get the last known location. In some rare situations, this can be null.
client.lastLocation.addOnSuccessListener { location : Location? ->
    location?.let {
        // Logic to handle location object.
    }
}

Java

// Code required for requesting location permissions omitted for brevity.
FusedLocationProviderClient client =
        LocationServices.getFusedLocationProviderClient(this);

// Get the last known location. In some rare situations, this can be null.
client.getLastLocation()
        .addOnSuccessListener(this, location -> {
            if (location != null) {
                // Logic to handle location object.
            }
        });

Wenn Sie auf APIs zugreifen möchten, für die eine Nutzerautorisierung erforderlich ist, folgen Sie der Anleitung unter Zugriff auf Google-Nutzerdaten autorisieren. Wenn Sie eine API verwenden, für die ein GoogleSignInAccount-Objekt erforderlich ist, verwenden Sie die Methode AuthorizationResult#toGoogleSignInAccount().

API-Verfügbarkeit prüfen

Bevor Sie ein Feature aktivieren, das von einer Google Play-Dienste-API abhängt, prüfen Sie, ob die API auf dem Gerät verfügbar ist. Rufen Sie dazu checkApiAvailability() auf.

Hinweis :Diese Prüfung ist nur erforderlich, wenn Sie eine Funktion deaktivieren müssen, wenn eine API nicht verfügbar ist. Sie können API-Methoden auch ohne diese Prüfung aufrufen, da sie fehlschlagen, wenn die API nicht verfügbar ist.

Das folgende Code-Snippet zeigt, wie Sie prüfen, ob der Fused Location Provider verfügbar ist:

Kotlin

fun getLastLocationIfApiAvailable(context: Context?): Task<Location>? {
    val client = getFusedLocationProviderClient(context)
    return GoogleApiAvailability.getInstance()
        .checkApiAvailability(client)
        .onSuccessTask { _ -> client.lastLocation }
        .addOnFailureListener { _ -> Log.d(TAG, "Location unavailable.")}
}

Java

public Task<Location> getLastLocationIfApiAvailable(Context context) {
    FusedLocationProviderClient client =
            getFusedLocationProviderClient(context);
    return GoogleApiAvailability.getInstance()
            .checkApiAvailability(client)
            .onSuccessTask(unused -> client.getLastLocation())
            .addOnFailureListener(e -> Log.d(TAG, "Location unavailable."));
}