Die Funktionen des Places SDK for iOS, die in Ihrem Apps basieren auf einer Kombination aus der SDK-Versionsnummer (z.B. 9.0.0), die Sie in den Paketabhängigkeiten und die für Ihren API-Schlüssel aktivierten APIs angeben. In diesem Leitfaden werden die Unterschiede zwischen den Versionen erläutert und es wird erklärt, wie Sie auswählen, welche Version Versionen sind in Ihrer App aktiviert.
SDK-Versionsnummern
Die Versionsnummer des SDKs, das Sie in den Paketabhängigkeiten angeben können Sie festlegen, ob Ihre App Zugriff auf Funktionen hat, die in einem für eine bestimmte Veröffentlichung. „Autocomplete (New)“ ist beispielsweise nur im SDK verfügbar Version 9.0.0 oder höher.
Weitere Informationen zu den Änderungen in den einzelnen SDK-Versionen finden Sie in der Places Versionshinweise zum SDK für iOS.
Places API-Versionen für das Places SDK for iOS
Neben der SDK-Versionsnummer müssen Sie auch die Places- API-Dienst, den das SDK in der Google Cloud Console aufruft: entweder Places API oder Places API (neu). Zusammen mit der SDK-Versionsnummer auswählen, welche Version bestimmter Funktionen in Ihrer App verfügbar ist, wie „Autocomplete“ oder „Autocomplete (New)“. Sie können zwar nur ein SDK angeben, Versionsnummer angezeigt wird, können Sie sowohl die Places API als auch die Places API (New) auf Ihrem API-Schlüssel verwenden. In den meisten Fällen werden Sie jedoch die Places API (New) und verwenden Sie die (neuen) Versionen der SDK-Funktionen in Ihrer App.
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 beides. Weitere Informationen finden Sie unter Aktivieren APIs
- Aktivieren Sie in den Einschränkungen für API-Schlüssel die Places API, Places API (New) oder beides. Weitere Informationen finden Sie unter API einschränken Schlüssel.
- Geben Sie bei der Installation des SDK die Versionsnummer an. Weitere Informationen Siehe Xcode-Projekt einrichten.
Weitere Informationen zur Auswahl des Places API-Dienstes finden Sie unter Google Cloud-Projekt.
SDK-Funktionen, die in den einzelnen Versionen verfügbar sind
Die folgende Tabelle zeigt, welche SDK- und API-Versionen für das jeweilige SDK erforderlich sind Funktion:
| Funktion | 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, mit der Places API (New) und dem neuen SDK beginnen.
- Wenn Sie bereits Kunde sind, können Sie das vorhandene SDK weiterhin verwenden. Aber um von den Leistungsverbesserungen und der Funktion zu profitieren, Verbesserungen des Places SDK for iOS (New) verwenden, sollten Sie die Places API aktivieren. (Neu) und verwenden Sie das neue SDK. Beim Wechsel zu führen Sie einfach die Schritte unter SDK-Version und API auswählen Dienste.
- Mit der Places API (New) werden einige vorhandene
Funktionen wie Aktuelle
Ort,
GMSPlace.isOpenundGMSPlaceisOpenAtDate
Verwenden der Vorabversion von GooglePlacesSwift
Die folgenden Schritte sind erforderlich, um GooglePlacesSwift zu verwenden:
- Places API aktivieren (Neu).
- Fügen Sie den GooglePlacesSwiftSDK zu Ihren Abhängigkeiten.
- Initialisieren Sie den Places-Client mit
PlacesClient
Weitere Informationen zu GooglePlacesSwift finden Sie in der Referenz Dokumentation.
Zu den neuen APIs migrieren
Wenn Sie eine vorhandene API verwenden und zur neuen API migrieren möchten, lesen Sie den Abschnitt folgende 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 hinzugefügt wurden. (Neu).
Implementierung auf der Google Cloud-Standardplattform
Das Places SDK for iOS (New) ist im Dienst Infrastruktur in Google Cloud. Diese Implementierung bietet eine sicherere und vertrauenswürdigere Plattform. Dieses Standarddesign sorgt für ein einheitliches Design der SDKs, die die Effizienz der Entwicklung mit dem Places SDK for iOS (Neu).
Verbesserte Leistung
Das Places SDK for iOS (New) bietet eine verbesserte Leistung, sodass lohnt es sich, Apps zu ersetzen, die das vorhandene SDK nutzen.
Neue Funktionen
Das Places SDK for iOS (New) enthält die aktuellen Versionen der alle 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 zahlen Sie nur für die Daten, die Sie tatsächlich nutzen. Vereinfachte Preisgestaltung wird mithilfe des Felds Listen, die auch als Feldmasken bezeichnet werden.
Mit dem Places SDK for iOS und „Text Search“ verwenden Sie Feldlisten, um die Liste der , die in der Antwort zurückgegeben werden sollen. Ihnen werden dann nur die Daten angefordert. Die Verwendung einer Feldliste ist eine gute Designpraxis, um sicherzustellen, unnötige Daten anzufordern, um unnötige Verarbeitungszeiten zu vermeiden Abrechnungsgebühren.
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 sind die als Teil der Place Details- und Text Search-Antwort. Sie können diese neuen Typen auch verwenden, und die vorhandenen Typen in einer Suche mit „Text Search“. Die neuen Typen sind in der Tabelle A:
| 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 | Bauernhof | 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 im Rahmen der Places API (New) auch folgende Typen verschoben: aus Tabelle 2 für das Places API bis Tabelle A für die Places API (New). Das bedeutet, dass Sie diese Typen jetzt als Teil eines Suchen:
countryadministrative_area_level_1administrative_area_level_2postal_codelocality