Omówienie migracji

Pakiet SDK Miejsc na iOS (nowy) zapewnia większą wydajność i nowy model cenowy, dlatego warto zaktualizować aplikacje, które korzystają z pakietu SDK Miejsc na iOS (starszego). Więcej informacji o porównywaniu funkcji znajdziesz w artykule Wybieranie pakietu SDK.

Z tego przewodnika dowiesz się, jakie są najważniejsze różnice między pakietem Places SDK na iOS (nowym) a pakietem Places SDK na iOS (starszym) oraz jak wprowadzić niezbędne zmiany.

Sprawdzone metody dotyczące płatności w przypadku migracji

Te wskazówki obowiązują, jeśli Twoje wykorzystanie interfejsu API jest wystarczająco wysokie, aby przejść na ceny drugiego poziomu. Podczas przechodzenia na nowszą wersję interfejsu API obciążamy Cię też za inny kod SKU. Aby uniknąć wzrostu kosztów w miesiącu przejścia na nowe interfejsy API, zalecamy jak najszybsze wdrożenie ich w środowisku produkcyjnym. Dzięki temu w miesiącu migracji osiągniesz najbardziej opłacalne miesięczne progi cenowe. Informacje o poziomach cenowych znajdziesz na stronie z cennikiem i w najczęstszych pytaniach dotyczących cen.

Błąd: kGMSPlacesRateLimitExceeded

Places API (nowość)

Pakiet SDK Miejsc na iOS korzysta z usługi Places API. Aby korzystać z funkcji pakietu Places SDK na iOS (nowego), musisz najpierw włączyć Places API (nowy) w projekcie Google Cloud. Więcej informacji znajdziesz w artykule Konfigurowanie projektu Google Cloud.

Następnie musisz sprawdzić, czy Places API (nowość) zostało dodane do listy autoryzowanych interfejsów API w kluczu używanym przez Twoją aplikację. Więcej informacji znajdziesz w artykule Korzystanie z kluczy interfejsu API.

Sprawdzanie, czy masz wystarczający limit w Places API (nowość)

Sprawdź, czy w pakiecie SDK Miejsc na iOS (nowym) masz wystarczający limit, aby pokryć bieżący ruch w pakiecie SDK Miejsc na iOS. Informacje o sprawdzaniu limitów i limitów wykorzystania oraz zarządzaniu nimi znajdziesz w artykule Limity i alerty dotyczące limitów. Zwróć uwagę na różnice między tymi 2 interfejsami API:

  • Limit pakietu SDK Miejsc na iOS (starszego) zależy od limitu usługi Places API. Jest to suma wszystkich metod interfejsu Places API.
  • Limit pakietu Places SDK na iOS (nowego) zależy od limitu usługi Places API (nowej). Każda metoda interfejsu API ma oddzielny limit.

Sprawdzanie, czy wynegocjowana umowa obejmuje Places API (nowość)

Jeśli masz wynegocjowaną umowę, sprawdź, czy obejmuje ona interfejs Places API (nowy) z oczekiwanymi cenami. Jeśli nie, skontaktuj się z osobą kontaktową w zespole sprzedaży Google lub z partnerem, aby omówić, jak możesz uwzględnić ten interfejs API.

Ogólne zmiany

Oto niektóre ogólne zmiany, które dotyczą wielu interfejsów API:

  • Korzysta z nowego modelu cenowego. Informacje o cenach wszystkich interfejsów API znajdziesz w artykule Cennik pakietu Places SDK na iOS (nowy).

  • Szczegóły miejsca, Wyszukiwanie w pobliżu i  Wyszukiwanie tekstowe wymagają masek pól, aby określić, które pola mają być zwracane w odpowiedzi.

  • GMSPlacesClient zawiera nowe metody wywoływania tych nowych interfejsów API.

  • Dodaliśmy nowe klasy, aby zdefiniować żądanie do każdego z nowych interfejsów API.

  • Odpowiedź GMSPlace zawiera nową właściwość reviews typu GMSPlaceReview. Gdy aplikacja wyświetla informacje uzyskane z instancji GMSPlace, takie jak zdjęcia i opinie, musi też wyświetlać wymagane atrybucje.

    Więcej informacji znajdziesz w dokumentacji dotyczącej atrybucji.

Zmiany dotyczące interfejsu API

W tej sekcji znajdziesz przewodniki po migracji dla poszczególnych interfejsów API: