Places SDK for iOS – Kurzübersicht

Mit dem Places SDK for iOS können iOS-Apps Informationen zu Orten (Unternehmen, POIs, geografische Standorte) über Place Details, Place Photos, Text Search, Nearby Search und Autocomplete abrufen. Die Places API (New) ist die aktuelle Version des SDK.

Places SDK for iOS: Wichtige Fakten

  • Produkt: Places SDK for iOS
  • Auch bekannt als: Places SDK for iOS (New)
  • Kategorie: Orte
  • Plattform: iOS
  • Ausführung auf: Client (App- oder Browsercode)
  • Einführungsphase: GA
  • Lebenszyklus: Aktiv
  • Übersicht: Places SDK for iOS – Übersicht

Places SDK for iOS: Wann sollte es verwendet werden?

Verwenden Sie das Places SDK for iOS, wenn:

  • Sie benötigen Place Details, Fotos, Text Search- oder Nearby Search-Ergebnisse in einer nativen iOS-App.
  • Sie benötigen die automatische Vervollständigung von Ortsnamen oder Adressen, während Nutzer in einer iOS-App tippen.
  • Sie möchten vordefinierte Places UI Kit-Komponenten (Place Details, Place Search, Place Autocomplete) in einer iOS-App verwenden.

Verwenden Sie das Places SDK for iOS nicht, wenn:

  • Sie entwickeln eine native Android-App. Verwenden Sie stattdessen das Places SDK for Android.
  • Sie erstellen eine Webseite im Browser. Verwenden Sie stattdessen die Maps JavaScript API.
  • Sie benötigen Ortsdaten von einem Server oder Backend über HTTP und nicht in einem iOS-Client. Verwenden Sie stattdessen die Places API (New).

Places SDK for iOS: Einrichtung

Offizielle Places SDK for iOS-Pakete:

  • swift_package: https://github.com/googlemaps/ios-places-sdk (GooglePlaces, GooglePlacesSwift)

Places SDK for iOS: Häufige Fehler

  • Problem: Places SDK for iOS (New)-Aufrufe schlagen fehl, wenn die Places API (New) im Cloud-Projekt nicht aktiviert ist oder nicht in der Liste der autorisierten APIs des API-Schlüssels enthalten ist. Lösung: Aktivieren Sie die Places API (New) und fügen Sie sie den API-Schlüsseleinschränkungen der App hinzu. Weitere Informationen finden Sie unter /maps/documentation/places/ios-sdk/legacy/migrate-overview.
  • Problem: kGMSPlacesRateLimitExceeded (-7) bedeutet, dass das Nutzungslimit für den API-Schlüssel überschritten wurde. Dieser Fehler wird auch bei Apps mit deaktivierten SDK 2.x-Versionen (deaktiviert am 29. Juli 2019) angezeigt. Lösung: Prüfen Sie das Kontingent und die Nutzung der Places API (New) in der Google Cloud Console und aktualisieren Sie Apps mit SDK-Versionen vor 3.0. Weitere Informationen finden Sie unter /maps/documentation/places/ios-sdk/reference/objc/Enums/GMSPlacesErrorCode.
  • Problem: Wenn Sitzungstokens in mehreren Apps im selben Projekt oder in mehreren Sitzungen wiederverwendet werden, funktioniert die Gruppierung der Abrechnung für Sitzungen mit automatischer Vervollständigung nicht mehr. Lösung: Generieren Sie für jede Autocomplete-Sitzung ein eindeutiges Sitzungstoken (UUID Version 4 empfohlen). Die Tokens müssen pro Projekt eindeutig sein. Weitere Informationen finden Sie unter /maps/documentation/places/ios-sdk/use-session-tokens.
  • Problem: In Apps werden Ortsdaten ohne die von der API zurückgegebenen Quellenangaben angezeigt. Lösung: Zeigen Sie alle relevanten Quellenangaben an, die mit Places-Daten zurückgegeben werden, wie auf der Richtlinienseite beschrieben. Weitere Informationen finden Sie unter /maps/documentation/places/ios-sdk/overview.

Places SDK for iOS: Legacy- und verworfene Funktionen

  • Places SDK for iOS (alte Version): Alte Version seit dem 01.03.2025. Ersatz: Places SDK for iOS (New) (erfordert die Places API (New)). Symptom: Legacy-Klassen und -Methoden (z. B. fetchPlaceFromPlaceID, GMSAutocompleteFetcher und GMSAutocompleteViewController) sind im SDK 11.0.0 und höher nicht vorhanden, was die Kompilierung verhindert. Weitere Informationen finden Sie in der Migrationsanleitung.
  • GMSAutocompleteResultsViewController setAutocompleteBoundsUsingNorthEastCorner:SouthWestCorner und GMSAutocompleteFetcher initWithBounds:filter: Seit dem 13.10.2020 außer Betrieb genommen. Ersatz: GMSAutocompleteFilter (locationBias oder locationRestriction) auf GMSAutocompleteRequest mit GMSPlacesClient fetchAutocompleteSuggestionsFromRequest:callback: oder den Modifikatoren GooglePlacesSwift placeAutocomplete oder basicPlaceAutocomplete für ein UI-Widget. Symptom: Die Methoden sind im SDK 4.0.0 und höher nicht vorhanden. GMSAutocompleteResultsViewController und GMSAutocompleteFetcher wurden im SDK 11.0.0 entfernt. Weitere Informationen finden Sie in der Migrationsanleitung.
  • GMSCoordinateBounds-basierte Grenzen für die automatische Vervollständigung (GMSAutocompleteViewController.autocompleteBounds/autocompleteBoundsMode; bounds/boundsMode-Parameter von findAutocompletePredictionsFromQuery und autocompleteQuery): Eingestellt seit 13.10.2020. Ersatz: GMSAutocompleteRequest durch GMSAutocompleteFilter (locationBias oder locationRestriction) und GMSPlacesClient fetchAutocompleteSuggestionsFromRequest:callback: oder die Modifikatoren GooglePlacesSwift placeAutocomplete oder basicPlaceAutocomplete für ein UI-Widget. Symptom: Eigenschaften und Parameter sind im SDK 4.0.0 und höher nicht vorhanden. GMSAutocompleteViewController und findAutocompletePredictionsFromQuery wurden im SDK 11.0.0 entfernt. Weitere Informationen finden Sie in der Migrationsanleitung.
  • GMSPlace.openNowStatus: Außer Betrieb genommen seit 13.10.2020. Ersatz: GMSPlacesClient isOpenWithRequest:callback: (GMSPlaceIsOpenRequest) oder PlacesClient.isPlaceOpen(with:) in GooglePlacesSwift. Symptom: Die Property ist im SDK 4.0.0 und höher nicht vorhanden. Weitere Informationen finden Sie in der Migrationsanleitung.
  • GMSPlaceField als NS_ENUM: Außer Betrieb genommen seit 13.10.2020. Ersatz: GMSPlaceProperty-Konstanten durch Anfrageklassen wie GMSFetchPlaceRequest und GMSPlaceSearchByTextRequest oder PlaceProperty in GooglePlacesSwift. Symptom: Ersetzt durch NS_OPTIONS im SDK 4.0.0 (GMSPlaceField, da NS_OPTIONS zur Legacy-API gehört und im SDK 11.0.0 und höher nicht vorhanden ist). Weitere Informationen finden Sie in der Migrationsanleitung.
  • Places SDK for iOS, Version 2.7.0: Außer Betrieb genommen seit dem 29.07.2019. Ersatz: Aktuelle Version des Places SDK for iOS. Symptom: kGMSPlacesRateLimitExceeded-Fehler.

Möglichkeiten mit dem Places SDK for iOS

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 iOS: Generative AI

Places SDK for iOS: Places

Places SDK for iOS: 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