Welche Funktionen des Places SDK for iOS in Ihrer App verfügbar sind, ergibt sich aus der Kombination der SDK-Versionsnummer (z.B. 9.0.0), die Sie in den Paketabhängigkeiten angeben, und den APIs, die für Ihren API-Schlüssel aktiviert sind. In diesem Leitfaden werden die Unterschiede zwischen den Versionen erläutert und es wird erklärt, wie Sie die in Ihrer Anwendung aktivierten Versionen auswählen.
SDK-Versionsnummern
Die Versionsnummer des SDKs, das Sie in den Paketabhängigkeiten angeben, bestimmt, ob Ihre App Zugriff auf Funktionen hat, die in einem bestimmten Release hinzugefügt wurden. „Autocomplete (New)“ ist beispielsweise erst ab SDK-Version 9.0.0 verfügbar.
Weitere Informationen zu den Änderungen in den einzelnen SDK-Versionen finden Sie in den Versionshinweisen zum Places SDK for iOS.
Places API-Versionen für das Places SDK for iOS
Zusätzlich zur SDK-Versionsnummer müssen Sie auch den Places API-Dienst auswählen, den das SDK in der Google Cloud Console aufruft: entweder Places API oder Places API (New). Zusammen mit der SDK-Versionsnummer bestimmt der von Ihnen ausgewählte API-Dienst, welche Version bestimmter Funktionen in Ihrer App verfügbar ist, z. B. „Autocomplete“ oder „Autocomplete (New)“. Sie können zwar nur eine SDK-Versionsnummer angeben, aber gleichzeitig die Places API und die Places API (New) für Ihren API-Schlüssel aktivieren. In den meisten Fällen empfiehlt es sich jedoch, die Places API (New) zu aktivieren und die (neuen) Versionen der SDK-Funktionen in Ihrer App zu verwenden.
SDK-Version und API-Dienste auswählen
So wählen Sie aus, welche SDK-Funktionen in Ihrer App verfügbar sind:
- Aktivieren Sie in Ihrem Google Cloud-Projekt die Places API, die Places API (New) oder beide. Weitere Informationen finden Sie unter APIs aktivieren.
- Aktivieren Sie in den Einschränkungen für API-Schlüssel die Places API, die Places API (New) oder beide. Weitere Informationen finden Sie unter API-Schlüssel einschränken.
- Geben Sie bei der Installation des SDK die Versionsnummer an. Weitere Informationen finden Sie unter Xcode-Projekt einrichten.
Weitere Informationen zur Auswahl des Places API-Dienstes finden Sie unter Google Cloud-Projekt einrichten.
SDK-Funktionen, die in den einzelnen Versionen verfügbar sind
In der folgenden Tabelle sehen Sie, welche SDK- und API-Versionen für die einzelnen SDK-Funktionen erforderlich sind:
Feature | Places API für API-Schlüssel aktiviert | Mindestversion des SDK |
---|---|---|
Automatische Vervollständigung (neu) | Places API (New) | 9.0.0 |
Place Details (neu) | Places API (New) | 9.0.0 |
Nearby Search (neu) | Places API (New) | 9.0.0 |
Ortsfotos (neu) | Places API (New) | 9.0.0 |
Textsuche (neu) | Places API (New) | 8.5.0 |
Place Autocomplete | Places API | 3.0.0 |
Find Current Place | Places API | 3.0.0 |
Ortsdetails | Places API | 3.0.0 |
Ortsfotos | Places API | 3.0.0 |
Überlegungen zur Auswahl der zu aktivierenden Versionen
- Wenn Sie Neukunde sind und gerade erst mit dem Places SDK for iOS begonnen haben, sollten Sie mit der Places API (New) und dem neuen SDK beginnen.
- Wenn Sie bereits Kunde sind, können Sie das vorhandene SDK weiterhin verwenden. Damit Sie jedoch von den Leistungsverbesserungen und Funktionsoptimierungen des Places SDK for iOS (New) profitieren können, sollten Sie die Places API (New) aktivieren und das neue SDK verwenden. Für die Umstellung auf das neue SDK ist keine Migration erforderlich. Folge einfach der Anleitung unter SDK-Version und API-Dienste auswählen.
- Mit der Places API (New) werden einige vorhandene Features wie Current Place,
GMSPlace.isOpen
undGMSPlaceisOpenAtDate
nicht aktiviert.
Verwenden der Vorabversion von GooglePlacesSwift
Die folgenden Schritte sind erforderlich, um GooglePlacesSwift zu verwenden:
- Aktivieren Sie die Places API (New).
- Fügen Sie den Abhängigkeiten das GooglePlacesSwiftSDK hinzu.
- Initialisieren Sie den Places-Client mit
PlacesClient
.
Weitere Informationen zu GooglePlacesSwift finden Sie in der Referenzdokumentation.
Zu den neuen APIs migrieren
Wenn Sie eine vorhandene API verwenden und zur neuen API migrieren möchten, lesen Sie die folgenden Migrationsanleitungen für die einzelnen APIs:
- Zu Place Details migrieren (Neu)
- Zu Place Photo migrieren (neu)
- Zur automatischen Vervollständigung migrieren (neu)
Verbesserungen im Places SDK for iOS (neu)
In diesem Abschnitt werden die wichtigsten Funktionen beschrieben, die dem Places SDK for iOS (neu) hinzugefügt wurden.
Implementierung auf der Google Cloud-Standardplattform
Das Places SDK for iOS (New) ist in der Dienstinfrastruktur in Google Cloud implementiert. Diese Implementierung bietet eine sicherere und vertrauenswürdigere Plattform. Dieses Standarddesign sorgt für ein gewisses Maß an Konsistenz über alle SDKs hinweg, was die Entwicklung mit dem Places SDK for iOS (neu) effizienter macht.
Verbesserte Leistung
Das Places SDK for iOS (New) bietet eine verbesserte Leistung. Daher lohnt es sich, Apps zu ersetzen, die das vorhandene SDK verwenden.
Neue Funktionen
Das Places SDK for iOS (New) enthält die neuesten Versionen aller SDK-Funktionen:
- Automatische Vervollständigung (neu)
- Place Details (neu)
- Nearby Search (neu)
- Ortsfotos (neu)
- Textsuche (neu)
Vereinfachte Preisgestaltung
Die Preisgestaltung wurde mit dem Places SDK for iOS (New) vereinfacht, sodass Sie nur für die tatsächlich genutzten Daten bezahlen. Vereinfachte Preise werden mithilfe von Feldlisten implementiert, die auch als Feldmasken bezeichnet werden.
Beim Places SDK for iOS und mit Text Search legen Sie mithilfe von Feldlisten fest, welche Felder in der Antwort zurückgegeben werden sollen. Ihnen werden dann nur die angeforderten Daten in Rechnung gestellt. Die Verwendung einer Feldliste hat sich bewährt, um zu verhindern, dass unnötige Daten angefordert werden. So lassen sich unnötige Verarbeitungszeiten und Gebühren vermeiden.
Ausführliche Preisinformationen für beide SDKs finden Sie unter Nutzung und Abrechnung.
Maximierte Ortstypen
Im neuen SDK werden die in der folgenden Tabelle aufgeführten Ortstypen hinzugefügt. Diese Typen werden als Teil der „Place Details“- und „Text Search“-Antwort zurückgegeben. Sie können diese neuen Typen und die vorhandenen Typen auch in einer Suche mit „Text Search“ verwenden. Die neuen Typen sind in Tabelle A enthalten.
Typ | |||
---|---|---|---|
american_restaurant | discount_store | ice_cream_shop | sandwich_shop |
amusement_center | dog_park | indian_restaurant | school_district |
athletic_field | electric_vehicle_charging_station | indonesian_restaurant | seafood_restaurant |
auto_parts_store | event_venue | italian_restaurant | ski_resort |
banquet_hall | extended_stay_hotel | japanese_restaurant | spanish_restaurant |
barbecue_restaurant | farm | korean_restaurant | sporting_goods_store |
barber_shop | Bauernhof | lebanese_restaurant | sports_club |
bed_and_breakfast | fast_food_restaurant | Marina | sports_complex |
brazilian_restaurant | ferry_terminal | Markt | steak_house |
breakfast_restaurant | fitness_center | medical_lab | sushi_restaurant |
brunch_restaurant | french_restaurant | mediterranean_restaurant | swimming_pool |
bus_stop | gift_shop | mexican_restaurant | Schneider |
camping_cabin | golf_course | middle_eastern_restaurant | telecommunications_service_provider |
cell_phone_store | greek_restaurant | Motel | thai_restaurant |
child_care_agency | grocery_store | national_park | transit_depot |
chinese_restaurant | guest_house | park_and_ride | truck_stop |
coffee_shop | hair_salon | performing_arts_theater | turkish_restaurant |
community_center | hamburger_restaurant | pizza_restaurant | vegan_restaurant |
Berater | Hubschrauberlandeplatz | Spielplatz | vegetarian_restaurant |
convention_center | hiking_area | Vorschule | vietnamese_restaurant |
Hütte | historical_landmark | private_guest_room | visitor_center |
courier_service | home_improvement_store | ramen_restaurant | wedding_venue |
cultural_center | Jugendherberge | resort_hotel | Großhändler |
dental_clinic | hotel | rest_stop |
Neben diesen neuen Typen wurden auch die folgenden Typen für die Places API (New) aus Tabelle 2 nach Tabelle A für die Places API (New) verschoben. Das bedeutet, dass Sie diese Typen jetzt in einer Suche verwenden können:
country
administrative_area_level_1
administrative_area_level_2
postal_code
locality