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
- Zu aktivierender Dienst:
places.googleapis.com - Authentifizierung: API-Schlüssel
- Nutzungszuordnung: Rufen Sie die Klassenmethode
addInternalUsageAttributionIDfürGMSPlacesClient(Objective-C/Swift) oderPlacesClient(GooglePlacesSwift) auf, um eine ID für die Nutzungszuordnung hinzuzufügen. Wenn Sie den Aufruf löschen, wird die Nutzungszuordnung deaktiviert. - Erste Schritte: Places SDK for iOS einrichten
- Referenz: Places SDK for iOS-Referenz
- Preise: Places SDK for iOS – Nutzung und Abrechnung
- Richtlinien: Richtlinien für das Places SDK for iOS
- Versionshinweise: Versionshinweise zum Places SDK for iOS
Offizielle Places SDK for iOS-Pakete:
- swift_package:
https://github.com/googlemaps/ios-places-sdk (GooglePlaces, GooglePlacesSwift)
Places SDK for iOS: ähnliche Produkte
- Häufig verwendet mit: Maps SDK for iOS
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,GMSAutocompleteFetcherundGMSAutocompleteViewController) sind im SDK 11.0.0 und höher nicht vorhanden, was die Kompilierung verhindert. Weitere Informationen finden Sie in der Migrationsanleitung. GMSAutocompleteResultsViewControllersetAutocompleteBoundsUsingNorthEastCorner:SouthWestCornerundGMSAutocompleteFetcherinitWithBounds:filter: Seit dem 13.10.2020 außer Betrieb genommen. Ersatz:GMSAutocompleteFilter(locationBiasoderlocationRestriction) aufGMSAutocompleteRequestmitGMSPlacesClientfetchAutocompleteSuggestionsFromRequest:callback:oder den ModifikatorenGooglePlacesSwiftplaceAutocompleteoderbasicPlaceAutocompletefür ein UI-Widget. Symptom: Die Methoden sind im SDK 4.0.0 und höher nicht vorhanden.GMSAutocompleteResultsViewControllerundGMSAutocompleteFetcherwurden 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 vonfindAutocompletePredictionsFromQueryundautocompleteQuery): Eingestellt seit 13.10.2020. Ersatz:GMSAutocompleteRequestdurchGMSAutocompleteFilter(locationBiasoderlocationRestriction) undGMSPlacesClientfetchAutocompleteSuggestionsFromRequest:callback:oder die ModifikatorenGooglePlacesSwiftplaceAutocompleteoderbasicPlaceAutocompletefür ein UI-Widget. Symptom: Eigenschaften und Parameter sind im SDK 4.0.0 und höher nicht vorhanden.GMSAutocompleteViewControllerundfindAutocompletePredictionsFromQuerywurden im SDK 11.0.0 entfernt. Weitere Informationen finden Sie in der Migrationsanleitung.GMSPlace.openNowStatus: Außer Betrieb genommen seit 13.10.2020. Ersatz:GMSPlacesClientisOpenWithRequest:callback:(GMSPlaceIsOpenRequest) oderPlacesClient.isPlaceOpen(with:)inGooglePlacesSwift. Symptom: Die Property ist im SDK 4.0.0 und höher nicht vorhanden. Weitere Informationen finden Sie in der Migrationsanleitung.GMSPlaceFieldalsNS_ENUM: Außer Betrieb genommen seit 13.10.2020. Ersatz:GMSPlaceProperty-Konstanten durch Anfrageklassen wieGMSFetchPlaceRequestundGMSPlaceSearchByTextRequestoderPlacePropertyinGooglePlacesSwift. Symptom: Ersetzt durchNS_OPTIONSim SDK 4.0.0 (GMSPlaceField, daNS_OPTIONSzur 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
- 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 iOS: 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.
- 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
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