SDK-Version auswählen

Version 8.5.0 des Places SDK for iOS unterstützt zwei SDK-Versionen: Das Places SDK for iOS ist das bisherige Places SDK for iOS (New) und ist die SDK-Version der nächsten Generation.

Nach der Veröffentlichung von Version 8.5.0 des Places SDK for iOS müssen Sie zuerst entscheiden, welches SDK Sie verwenden möchten. Dies gilt für Neu- oder Bestandskund*innen, die das SDK bereits verwenden. In diesem Leitfaden werden die wichtigsten Unterschiede zwischen den beiden SDKs beschrieben.

So wählen Sie Ihre SDK-Version aus

Das Places SDK for iOS basiert auf dem Dienst Places API. Bevor Sie das Places SDK for iOS verwenden können, müssen Sie den Places API-Dienst in Ihrem Google Cloud-Projekt aktivieren.

Die von Ihnen aktivierte Version des Places API-Dienstes steuert die von Ihrer App verwendete SDK-Version:

  • Places API: Das vorhandene Places SDK for iOS wird aktiviert. Wenn nur die Places API für das Projekt aktiviert ist, das mit dem API-Schlüssel für Ihre App verknüpft ist, haben Sie keinen Zugriff auf die neuen Funktionen, die ab Version 8.5.0 des Places SDK for iOS hinzugefügt wurden.

  • Places API (New): Aktiviert das Places SDK for iOS (New), einschließlich Text Search und aller neuen Funktionen, die unter Wichtige neue Funktionen des Places SDK for iOS (neu) beschrieben werden. Vorhandene Funktionen wie „Place Details“, „Place Photos“, „Current Place“ und „Place Autocomplete“ werden nicht aktiviert.

  • Beide: Aktiviert alle Funktionen für Places SDK for iOS (New) und Places SDK for iOS.

Weitere Informationen zur Auswahl des Places API-Dienstes finden Sie unter Google Cloud-Projekt einrichten.

Welches SDK wählen Sie aus?

So können Sie besser entscheiden, welche Version Sie auswählen sollten:

  1. Wenn Sie Neukunde sind und das Places SDK for iOS erst seit Kurzem verwenden, sollten Sie sowohl mit der Places API (New) als auch mit der Places API beginnen, um Zugriff auf alle Funktionen zu erhalten.

  2. Wenn Sie Bestandskunde sind, können Sie das vorhandene SDK weiterhin verwenden. Wenn Sie jedoch von den Leistungsverbesserungen und den Funktionsverbesserungen des Places SDK for iOS (New) profitieren möchten, können Sie das neue SDK verwenden.

    Für den Wechsel zum neuen SDK ist keine Migration erforderlich. Sie müssen das Places SDK for iOS (New) nur für den API-Schlüssel aktivieren, der in Ihrer App verwendet wird. Wenn Sie sowohl das vorhandene Places SDK for iOS als auch das Places SDK for iOS (New) verwenden, aktivieren Sie beide Versionen für Ihren API-Schlüssel. Weitere Informationen finden Sie unter API-Schlüssel verwenden.

Wichtige Funktionen, die dem Places SDK for iOS hinzugefügt wurden (neu)

In diesem Abschnitt werden die wichtigsten Funktionen beschrieben, die dem Places SDK for iOS (neu) hinzugefügt wurden.

Auf der Google Cloud-Standardplattform implementiert

Das Places SDK for iOS (New) ist in der Dienstinfrastruktur in Google Cloud implementiert. Diese Implementierung sorgt für eine sicherere und vertrauenswürdigere Plattform. Dieses Standarddesign sorgt für ein gewisses Maß an Konsistenz zwischen den SDKs. Dadurch wird die Effizienz der Entwicklung mit dem Places SDK for iOS (neu) verbessert.

Verbesserte Leistung

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

Die Textsuche gibt basierend auf einem String Informationen zu verschiedenen Orten zurück, z. B. „Pizza in Hamburg“, „Schuhgeschäfte in der Nähe von Hamburg“ oder „Hauptstraße 123“. Der Dienst gibt eine Liste von Orten zurück, die dem Textstring und ggf. der festgelegten Standortgewichtung entsprechen.

Vereinfachte Preisgestaltung

Mit dem Places SDK for iOS (New) wird die Preisgestaltung vereinfacht, sodass Sie nur für die Daten bezahlen, die Sie tatsächlich nutzen. Mithilfe von Feldlisten, auch Feldmasken genannt, vereinfachte Preisgestaltung.

Beim Places SDK for iOS und in der Textsuche können Sie mithilfe von Feldlisten die Liste der Felder steuern, die in der Antwort zurückgegeben werden sollen. Ihnen werden dann nur die angeforderten Daten in Rechnung gestellt. Die Verwendung einer Feldliste ist eine bewährte Methode, um sicherzustellen, dass Sie keine unnötigen Daten anfordern, wodurch unnötige Verarbeitungszeiten und Gebühren vermieden werden können.

Ausführliche Preisinformationen für beide SDKs findest du unter Nutzung und Abrechnung.

Erweiterte Ortstypen

Im neuen SDK werden die Ortstypen hinzugefügt, die in der folgenden Tabelle aufgeführt sind. Diese Typen werden als Teil der „Place Details“- und „Text Search“-Antworten zurückgegeben. Sie können diese neuen 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 Schneidern
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 hat die Places API (New) die folgenden Typen aus Tabelle B aus Tabelle A verschoben. Das bedeutet, dass Sie jetzt diese Typen als Teil einer Suche verwenden können:
  • country
  • administrative_area_level_1
  • administrative_area_level_2
  • postal_code
  • locality