Places SDK for Android – Kurzübersicht

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

Offizielle Places SDK for Android-Pakete:

  • Maven: com.google.android.libraries.places:places

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.Field in der Feldliste SearchNearbyRequest. 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 wurde Places.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 mit Places.initializeWithNewPlacesApiEnabled(). Weitere Informationen finden Sie unter /maps/documentation/places/android-sdk/legacy/migrate-overview.
  • Problem: Die von fetchPlace() zurückgegebene Place hat keine PhotoMetadata (es gibt also nichts aufzulösen), wenn die Feldliste PHOTO_METADATAS weglässt. Lösung: Nehmen Sie Place.Field.PHOTO_METADATAS in die Feldliste auf. Da fetchResolvedPhotoUri() 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, PhotoMetadata und Review zurü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() und awaitFindCurrentPlace() (Current Place, Legacy): Eingestellt seit dem 30.09.2026. Ersatz: PlacesClient.searchNearby() (Nearby Search (New)) Symptom: Methoden und FindCurrentPlaceRequest/FindCurrentPlaceResponse-Klassen wurden in Version 6.0.2 entfernt. Weitere Informationen finden Sie in der Migrationsanleitung.
  • PlacesClient.fetchPhoto() und awaitFetchPhoto(): Außer Betrieb genommen seit dem 30.09.2026. Ersatz: „Place Details“-Komponente des Places UI Kit (PlacesClient.fetchResolvedPhotoUri() wird eingestellt). Symptom: Methoden und FetchPhotoRequest/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) oder PlacesClient.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 (AutocompleteSupportFragment wurde 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

Places SDK for Android: Places

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