SDK-Version auswählen

Welche Funktionen des Places SDK for iOS in Ihrer App verfügbar sind, wird durch eine Kombination aus der SDK-Versionsnummer (z.B. 9.0.0), die Sie in Ihren Paketabhängigkeiten angeben, und den APIs bestimmt, die für Ihren API-Schlüssel aktiviert sind. In diesem Leitfaden werden die Unterschiede zwischen den Versionen erläutert und Sie erfahren, wie Sie auswählen, welche Versionen in Ihrer App aktiviert werden sollen.

SDK-Versionsnummern

Die Versionsnummer des SDKs, die Sie in Ihren Paketabhängigkeiten angeben, bestimmt, ob Ihre App Zugriff auf Funktionen hat, die in einer bestimmten Version hinzugefügt wurden. „Autocomplete (New)“ ist beispielsweise nur in der SDK-Version 9.0.0 oder höher 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

Sie müssen nicht nur eine SDK-Versionsnummer angeben, sondern auch den Places API-Dienst auswählen, den das SDK in der Google Cloud Console aufruft: entweder „Places API“ oder „Places API (neu)“. Zusammen mit der SDK-Versionsnummer bestimmt der 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 sowohl die Places API als auch die Places API (neu) gleichzeitig für Ihren API-Schlüssel aktivieren. In den meisten Fällen sollten Sie jedoch die Places API (Neu) aktivieren und die (Neu)-Versionen der SDK-Funktionen in Ihrer App verwenden.

SDK-Version und API-Dienste auswählen

So wählen Sie aus, welche SDK-Funktionen in Ihrer App verfügbar sind:

  1. Aktivieren Sie in Ihrem Google Cloud-Projekt die Places API, die Places API (neu) oder beide. Weitere Informationen finden Sie unter APIs aktivieren.
  2. Aktivieren Sie in den API-Schlüsseleinschränkungen die Places API, die Places API (neu) oder beide. Weitere Informationen finden Sie unter API-Schlüssel einschränken.
  3. Geben Sie beim Installieren des SDKs 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.

In den einzelnen Versionen verfügbare SDK-Funktionen

In der folgenden Tabelle sehen Sie, welche SDK- und API-Versionen für die einzelnen SDK-Funktionen erforderlich sind:

Places SDK for iOS (neu) Mindest-SDK-Version Places SDK for iOS Mindest-SDK-Version
Ortsdetails (neu) 9.0.0 Place Details 3.0.0
Ortsfoto (neu) 9.0.0 Ortsfoto 3.0.0
Text Search (Neu) 8.5.0
Nearby Search (Neu) 9.0.0
Automatische Vervollständigung (neu) 9.0.0 Automatische Vervollständigung 3.0.0
Find Current Place 3.0.0

Überlegungen bei der Auswahl der zu aktivierenden Versionen

  • Wenn Sie ein neuer Kunde sind und gerade erst mit dem Places SDK for iOS beginnen, beginnen Sie mit der Places API (neu) und dem neuen SDK.
  • Wenn Sie bereits Kunde sind, können Sie das vorhandene SDK weiterhin verwenden. Wenn Sie jedoch die Leistungsverbesserungen und Funktionserweiterungen des Places SDK for iOS (neu) nutzen möchten, sollten Sie die Places API (neu) aktivieren und das neue SDK verwenden. Für die Umstellung auf das neue SDK ist keine Migration erforderlich. Folgen Sie einfach der Anleitung unter SDK-Version und API-Dienste auswählen.
  • Mit der Places API (New) sind einige vorhandene Funktionen wie Current Place, GMSPlace.isOpen und GMSPlace.isOpenAtDate nicht verfügbar.

Places Swift SDK for iOS verwenden (Vorabversion)

Für die Verwendung des Places Swift SDK for iOS (Vorabversion) sind die folgenden Schritte erforderlich:

  1. Aktivieren Sie die Places API (New).
  2. Fügen Sie Ihren Abhängigkeiten das Places Swift SDK for iOS (Vorabversion) hinzu.
  3. Initialisieren Sie den Places-Client mit PlacesClient.

Weitere Informationen zum Places Swift SDK for iOS (Vorabversion) finden Sie in der Übersicht oder im Migrationsleitfaden.

Zu den neuen APIs migrieren

Wenn Sie eine vorhandene API verwenden und zur neuen API migrieren möchten, lesen Sie die folgenden Migrationsleitfäden für die einzelnen APIs:

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).

Auf der Google Cloud-Standardplattform implementiert

Das Places SDK for iOS (neu) ist in der Dienstinfrastruktur von Google Cloud implementiert. Diese Implementierung sorgt für eine sicherere und vertrauenswürdigere Plattform. Dieses Standarddesign sorgt für Einheitlichkeit zwischen den SDKs und verbessert die Effizienz der Entwicklung mit dem Places SDK for iOS (neu).

Verbesserte Leistung

Das Places SDK for iOS (neu) bietet eine verbesserte Leistung. Daher lohnt es sich, Apps zu ersetzen, in denen das vorhandene SDK verwendet wird.

Neue Funktionen

Das Places SDK for iOS (neu) enthält die neuesten Versionen aller SDK-Funktionen:

Transparente Kosten

Mit dem Places SDK for iOS (neu) sind die Preise vereinfacht, sodass Sie nur für die Daten bezahlen, die Sie verwenden. Transparente Preise werden mithilfe von Feldlisten implementiert, die auch als Feldmasken bezeichnet werden.

Mit dem Places SDK for iOS und der Text Search können Sie mithilfe von Feldlisten festlegen, welche Felder in der Antwort zurückgegeben werden. Ihnen werden dann nur die angeforderten Daten in Rechnung gestellt. Mit einer Feldliste lässt sich verhindern, dass unnötige Daten angefordert werden, was wiederum hilft, unnötige Verarbeitungszeiten und Gebühren zu vermeiden.

Ausführliche Preisinformationen für beide SDKs finden Sie unter Nutzung und Abrechnung.

Erweiterte Ortstypen

Das neue SDK fügt die in der folgenden Tabelle aufgeführten Ortstypen hinzu. Diese Typen werden im Rahmen der Antwort „Place Details“ und „Text Search“ zurückgegeben. Sie können diese neuen Typen und die vorhandenen Typen auch in einer Suche mit der Textsuche 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 Bauernhof korean_restaurant sporting_goods_store
barber_shop Agrotourismus 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 anpassen
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 playground 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 in der Places API (neu) die folgenden Typen aus Tabelle 2 der Places API in Tabelle A der Places API (neu) verschoben. Sie können also jetzt folgende Typen in Suchanfragen verwenden:

  • country
  • administrative_area_level_1
  • administrative_area_level_2
  • postal_code
  • locality