Mit dem Places SDK for Android können Android-Apps über die Funktionen „Place Autocomplete“, „Place Details“, „Nearby Search“, „Text Search“ und „Place Photos“ auf die Google-Datenbank mit Orts- und Unternehmensinformationen zugreifen. Das Places SDK for Android (New) ist die aktuelle Version und hängt von der Places API (New) ab.
Places SDK for Android: Wichtige Fakten
- Produkt: Places SDK for Android
- Auch bekannt als: Places SDK for Android (New)
- Kategorie: Orte
- Plattform: Android
- Ausführung auf: Client (App- oder Browsercode)
- Einführungsphase: GA
- Lebenszyklus: Aktiv
- Übersicht: Places SDK for Android
Places SDK for Android: Wann sollte es verwendet werden?
Verwenden Sie das Places SDK for Android, wenn:
- Sie benötigen Place Details, Fotos, Nearby Search- oder Text Search-Ergebnisse in einer nativen Android-App.
- Sie benötigen ein vorgefertigtes Autocomplete-Widget oder Komponenten des Places UI Kit, die Ortsvorschläge zurückgeben, während Nutzer in einer Android-App Text eingeben.
- Sie möchten standortbezogene Android-Funktionen entwickeln, die auf Unternehmen und POIs in der Nähe des Geräts des Nutzers basieren.
In folgenden Fällen sollten Sie das Places SDK for Android nicht verwenden:
- Sie müssen Places über HTTP von einem Server oder Backend aus aufrufen, nicht von einer Android-App. Verwenden Sie stattdessen die Places API (New).
- Sie entwickeln eine native iOS-App. Verwenden Sie stattdessen das Places SDK for iOS.
- Sie erstellen eine Webseite im Browser. Verwenden Sie stattdessen die Maps JavaScript API.
Places SDK for Android: Einrichtung
- Zu aktivierender Dienst:
places.googleapis.com - Authentifizierung: API-Schlüssel
- Nutzungszuordnung: Rufen Sie
Places.addInternalUsageAttributionId(String)auf, wenn Sie das SDK initialisieren, um eine Nutzungszuordnungs-ID zu senden. Löschen Sie den Aufruf oder übergeben Sie einen leeren String, um die Funktion zu deaktivieren. - Erste Schritte: Places SDK for Android einrichten
- Referenz: Places SDK for Android-Referenz
- Preise: Places SDK for Android: Nutzung und Abrechnung
- Richtlinien: Richtlinien für das Places SDK for Android
- Versionshinweise: Versionshinweise zum Places SDK for Android
Offizielle Places SDK for Android-Pakete:
- Maven:
com.google.android.libraries.places:places
Places SDK for Android: ähnliche Produkte
- Häufig verwendet mit: Maps SDK for Android
Places SDK for Android: Häufige Fehler
- Problem: Nearby Search-Anfragen ohne Feldliste (Feldmaske) oder mit einer leeren Feldliste geben einen Fehler zurück. Lösung: Übergeben Sie mindestens einen
Place.Fieldin der FeldlisteSearchNearbyRequest. Weitere Informationen finden Sie unter /maps/documentation/places/android-sdk/nearby-search. - Problem: „Place Details (New)“, „Nearby Search (New)“ und „Autocomplete (New)“ schlagen fehl, wenn der API-Schlüssel nicht die Places API (New) enthält, oder in SDK 5.x und früheren Versionen, wenn die App
Places.initialize()aufruft. In Version 6.0.2 wurdePlaces.initialize()entfernt. Code, der diese Methode aufruft, wird nach dem Upgrade nicht kompiliert. Lösung: Aktivieren Sie die Places API (New), fügen Sie sie den zulässigen APIs des API-Schlüssels hinzu und initialisieren Sie sie mitPlaces.initializeWithNewPlacesApiEnabled(). Weitere Informationen finden Sie unter /maps/documentation/places/android-sdk/legacy/migrate-overview. - Problem: Die von
fetchPlace()zurückgegebenePlacehat keinePhotoMetadata(es gibt also nichts aufzulösen), wenn die FeldlistePHOTO_METADATASweglässt. Lösung: Nehmen SiePlace.Field.PHOTO_METADATASin die Feldliste auf. DafetchResolvedPhotoUri()eingestellt wurde, sollten Sie die Komponente „Place Details“ des Places UI Kits verwenden, um Fotos anzuzeigen. Weitere Informationen finden Sie unter /maps/documentation/places/android-sdk/place-photos. - Problem: Apps, in denen Ortsdetails, Fotos oder Rezensionen ohne die zurückgegebenen Quellenangaben für Drittanbieter und Autoren angezeigt werden, verstoßen gegen die Richtlinien. Lösung: Zeigen Sie die Urheberrechtshinweise an, die mit den Objekten
Place,PhotoMetadataundReviewzurückgegeben werden. Weitere Informationen finden Sie unter /maps/documentation/places/android-sdk/policies.
Places SDK for Android: Legacy- und eingestellte Funktionen
- Places SDK for Android (Legacy) / Places API (Legacy) – Funktionen (Autocomplete, Current Place, Place Details, Place Photos Legacy): Legacy seit dem 01.03.2025. Ersatz: Places SDK for Android (New)-Funktionen, die auf der Places API (New) basieren und mit
Places.initializeWithNewPlacesApiEnabled()initialisiert werden. Symptom: Ab Oktober 2026 kann die Places API (Legacy) in neuen Cloud-Projekten nicht mehr aktiviert werden. In bestehenden Projekten wird sie weiterhin unterstützt. In SDK 6.0.2 wurden die alten Methoden entfernt, die nur in 5.x und früheren Versionen vorhanden sind. Weitere Informationen finden Sie in der Migrationsanleitung. Places.initialize(): Seit dem 30.09.2026 außer Betrieb genommen. Ersatz:Places.initializeWithNewPlacesApiEnabled(). Symptom: Die Methode wurde in Version 6.0.2 aus dem SDK entfernt. Code, der sie aufruft, wird nicht mehr kompiliert. Weitere Informationen finden Sie in der Migrationsanleitung.PlacesClient.findCurrentPlace()undawaitFindCurrentPlace()(Current Place, Legacy): Eingestellt seit dem 30.09.2026. Ersatz:PlacesClient.searchNearby()(Nearby Search (New)) Symptom: Methoden undFindCurrentPlaceRequest/FindCurrentPlaceResponse-Klassen wurden in Version 6.0.2 entfernt. Weitere Informationen finden Sie in der Migrationsanleitung.PlacesClient.fetchPhoto()undawaitFetchPhoto(): Außer Betrieb genommen seit dem 30.09.2026. Ersatz: „Place Details“-Komponente des Places UI Kit (PlacesClient.fetchResolvedPhotoUri()wird eingestellt). Symptom: Methoden undFetchPhotoRequest/FetchPhotoResponse-Klassen wurden in Version 6.0.2 entfernt. Weitere Informationen finden Sie in der Migrationsanleitung.- Widget „Automatische Vervollständigung“ der Places API (Legacy) (
Autocomplete,AutocompleteSupportFragment,AutocompleteActivityMode): Eingestellt seit dem 30.09.2026. Ersatz: „Place Autocomplete (New)“-Widget (PlaceAutocomplete) oderPlacesClient.findAutocompletePredictions(). Symptom: Klassen wurden in Version 6.0.2 aus dem SDK entfernt. Weitere Informationen finden Sie in der Migrationsanleitung. - Places Compatibility Library (
com.google.android.libraries.places:places-compat): Seit dem 31.03.2022 eingestellt. Ersatz: Places SDK for Android (com.google.android.libraries.places:places). Symptom: Eingefroren bei Version 2.6.0; keine neuen Funktionen oder Fehlerkorrekturen. AutocompleteFragment-Klasse: Außer Betrieb genommen seit dem 25.09.2025. Ersatz: Place Autocomplete (New)-Widget (PlaceAutocomplete). Symptom: Die Klasse wurde in Version 5.0.0 aus dem SDK entfernt (AutocompleteSupportFragmentwurde ebenfalls in Version 6.0.2 entfernt).
Möglichkeiten mit dem Places SDK for Android
In den unten verlinkten Anleitungen finden Sie Informationen zu den einzelnen Aufgaben. Sie können die Produkte auch im Capabilities Explorer vergleichen.
Places SDK for Android: Generative KI
- Gibt eine KI-gestützte Zusammenfassung der Nutzerrezensionen für eine bestimmte Google Place-ID zurück.
- Eine KI-basierte Zusammenfassung der Umgebung und der Ausstattung einer bestimmten Google-Orts-ID für eine Ladestation für Elektrofahrzeuge zurückgeben.
Places SDK for Android: Places
- Eine Liste von Orten und Ortsdetails basierend auf einem Abfragestring zurückgeben
- Eine Liste von Orten und Ortsdetails in der Nähe eines bestimmten Standorts zurückgeben
- Automatische Vervollständigung von Orten auf Grundlage eines Abfragestrings
- Detaillierte Informationen zu einem bestimmten Ort zurückgeben
- Fotos eines bestimmten Ortes zurückgeben Hinweis: Zeigen Sie die Autorenangaben (Name des Autors, verknüpft mit seinem Profil-URI) zusammen mit dem Foto an. Dies ist in den Places-Richtlinien für die einzelnen Plattformen vorgeschrieben, z. B. unter /maps/documentation/javascript/policies#photo-attributions und /maps/documentation/places/web-service/policies#photos-and-review.
- Größe von Fotos eines Ortes anpassen
- Bewertungen und Rezensionen für einen bestimmten Ort zurückgeben Hinweis: Im Places API (New) Webdienst ist „Place Details“ eine HTTP-GET-Anfrage an https://places.googleapis.com/v1/places/{placeId} mit X-Goog-FieldMask (z. B. rating,userRatingCount,reviews). Für „Text Search“, „Nearby Search“ und „Autocomplete“ wird POST verwendet. Übergeben Sie unter Android „Place.Field.RATING“, „USER_RATING_COUNT“ und „REVIEWS“ an „PlacesClient.fetchPlace()“. Übergeben Sie unter iOS „GMSPlacePropertyRating“, „GMSPlacePropertyUserRatingsTotal“ und „GMSPlacePropertyReviews“ in „GMSFetchPlaceRequest“.
- Fügen Sie einer Webseite oder App ein Autocomplete-Widget hinzu, das Ergebnisse zu Orten basierend auf einem Abfragestring zurückgibt.
- Datenfelder angeben, die in Antworten mit Ortsinformationen enthalten sein sollen
- Geben Sie die Ortstypen an, die in Antworten auf Anfragen zu Ortsinformationen enthalten sein sollen.
- Den URI zurückgeben, um die Seite mit den Ortsdetails in Google Maps für einen Ort zu öffnen.
- Informationen zum Ort zurückgeben, an dem sich das Gerät des Nutzers gerade befindet. Hinweis: Die alten Current Place-Methoden wurden im Places SDK for Android ab Version 6.0 und im Places SDK for iOS ab Version 11.0 entfernt. Rufen Sie die Gerätekoordinaten über die standortbezogenen Dienste der Plattform ab und rufen Sie die Nearby Search auf.
- Eine KI-basierte Übersicht für einen bestimmten Ort zurückgeben
- Eine KI-basierte Zusammenfassung der Umgebung eines bestimmten Ortes zurückgeben
- Informationen zu Orten entlang einer vordefinierten Route anhand eines Abfragestrings zurückgeben
- Entfernung, Fahrtzeit und Wegbeschreibungs-URI für Orte zurückgeben, die per Text Search anhand von Breiten- und Längengradkoordinaten gefunden wurden
- Entfernung, Fahrtzeit und Wegbeschreibungs-URI zu Orten in der Nähe anhand von Breiten- und Längengradkoordinaten zurückgeben
- Entfernung, Reisedauer und Wegbeschreibungs-URI zwischen dem Startpunkt einer vordefinierten Route und den einzelnen Orten, die anhand eines Abfragestrings zurückgegeben werden und sich ebenfalls auf der Route befinden, zurückgeben.
- Entfernung, Reisedauer und Routen-URI zwischen den einzelnen Orten, die auf Grundlage eines Abfragestrings zurückgegeben werden und sich auch auf einer vordefinierten Route befinden, und dem Ziel der Route zurückgeben.
Places SDK for Android: Places UI Kit
- CSS-Stile auf ein UI-Element für Ortsdaten anwenden Hinweis: Benutzerdefinierte CSS-Eigenschaften gelten für Places UI Kit-Elemente der Maps JavaScript API. Das Places SDK for Android und das Places SDK for iOS gestalten Places UI Kit-Ansichten programmatisch mithilfe von Design- und Stilattributen. EWR-COMPLIANCE-ANFORDERUNG: Wenn Sie Ortsdaten auf einer Karte im Europäischen Wirtschaftsraum (EWR) anzeigen möchten, rufen Sie Places API-Webdienste nicht von einem Backend-Server auf. Verwenden Sie clientseitige Places UI Kit-Komponenten auf der Zielplattform (Maps JavaScript API im Web, Places SDK for Android auf Android-Geräten oder Places SDK for iOS auf iOS-Geräten). Vollständige Anforderungen und FAQ: https://developers.google.com/maps/comms/eea/faq
- Mit einem Tool zur Anpassung von UI-Elementen können Sie das Styling und die Konfigurationen von UI-Elementen für Ortsdaten anpassen. Hinweis: EWR-COMPLIANCE-ANFORDERUNG: Wenn Sie Ortsdaten auf einer Karte im Europäischen Wirtschaftsraum (EWR) anzeigen möchten, rufen Sie Places API-Webdienste nicht von einem Backend-Server auf. Verwenden Sie clientseitige Places UI Kit-Komponenten auf der Zielplattform (Maps JavaScript API im Web, Places SDK for Android auf Android-Geräten oder Places SDK for iOS auf iOS-Geräten). Vollständige Anforderungen und FAQ: https://developers.google.com/maps/comms/eea/faq
- Fügen Sie einer Webseite oder mobilen App ein UI-Element hinzu, das Informationen zu einem bestimmten Ort anzeigt. Hinweis: ANFORDERUNG AN DIE COMPLIANCE IM EWR: Wenn Sie Ortsdaten auf einer Karte im Europäischen Wirtschaftsraum (EWR) anzeigen möchten, rufen Sie die Places API-Webdienste nicht von einem Backend-Server auf. Verwenden Sie clientseitige Places UI Kit-Komponenten auf der Zielplattform (Maps JavaScript API im Web, Places SDK for Android auf Android-Geräten oder Places SDK for iOS auf iOS-Geräten). Vollständige Anforderungen und FAQ: https://developers.google.com/maps/comms/eea/faq
- Fügen Sie einer Webseite ein UI-Element hinzu, das eine Liste von Orten basierend auf einem Abfragestring anzeigt. Hinweis: Wird sowohl auf Webseiten (Maps JavaScript API) als auch in mobilen Apps (Places SDK for Android und Places SDK for iOS) unterstützt. EWR-COMPLIANCE-ANFORDERUNG: Wenn Sie Ortsdaten auf einer Karte im Europäischen Wirtschaftsraum (EWR) anzeigen möchten, rufen Sie Places API-Webdienste nicht von einem Backend-Server auf. Verwenden Sie clientseitige Places UI Kit-Komponenten auf der Zielplattform (Maps JavaScript API im Web, Places SDK for Android auf Android-Geräten oder Places SDK for iOS auf iOS-Geräten). Vollständige Anforderungen und FAQ: https://developers.google.com/maps/comms/eea/faq
- Fügen Sie einer Webseite ein UI-Element hinzu, das eine Liste von Orten in der Nähe eines bestimmten Standorts anzeigt. Hinweis: Wird sowohl auf Webseiten (Maps JavaScript API) als auch in mobilen Apps (Places SDK for Android und Places SDK for iOS) unterstützt. EWR-COMPLIANCE-ANFORDERUNG: Wenn Sie Ortsdaten auf einer Karte im Europäischen Wirtschaftsraum (EWR) anzeigen möchten, rufen Sie Places API-Webdienste nicht von einem Backend-Server auf. Verwenden Sie clientseitige Places UI Kit-Komponenten auf der Zielplattform (Maps JavaScript API im Web, Places SDK for Android auf Android-Geräten oder Places SDK for iOS auf iOS-Geräten). Vollständige Anforderungen und FAQ: https://developers.google.com/maps/comms/eea/faq
- Fügen Sie einer Webseite oder App ein einfaches UI-Element für die automatische Vervollständigung hinzu, das Google-Ortskennungen basierend auf einem Abfragestring zurückgibt. Hinweis: EWR-COMPLIANCE-ANFORDERUNG: Wenn Sie Ortsdaten auf einer Karte im Europäischen Wirtschaftsraum (EWR) anzeigen möchten, rufen Sie Places API-Webdienste nicht von einem Backend-Server auf. Verwenden Sie clientseitige Places UI Kit-Komponenten auf der Zielplattform (Maps JavaScript API im Web, Places SDK for Android auf Android-Geräten oder Places SDK for iOS auf iOS-Geräten). Vollständige Anforderungen und FAQ: https://developers.google.com/maps/comms/eea/faq