Pakiet SDK Miejsc na Androida (nowy) zapewnia większą wydajność i nowy model cenowy, dlatego warto zaktualizować aplikacje, które korzystają z pakietu SDK Miejsc na Androida (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 Androida (nowym) a pakietem Places SDK na Androida (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.
Włączanie Places API (nowość)
Pakiet SDK Miejsc na Androida (starsza wersja) korzysta z usługi Places API. Aby korzystać z funkcji pakietu Places SDK na Androida (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 dodać Places API (nowość) do listy autoryzowanych interfejsów API w kluczu używanym przez aplikację. Więcej informacji znajdziesz w artykule Używanie kluczy interfejsu API.
Sprawdzanie, czy masz wystarczający limit w Places API (nowość)
Sprawdź, czy w Places API (nowość) masz wystarczający limit, aby obsłużyć bieżący ruch. Informacje o sprawdzaniu limitów i zarządzaniu nimi znajdziesz w artykule Limity przydziału i alerty dotyczące limitów.
Zwróć uwagę na różnicę:
- Limit pakietu SDK Miejsc na Androida (starszego) zależy od limitu usługi Places API. Jest to suma wszystkich metod interfejsu Places API.
- Limit pakietu SDK Miejsc na Androida (nowego) zależy od limitu usługi Places API (nowej). Każda metoda interfejsu API ma osobny 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 Google ds. sprzedaży 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 Pakiet SDK Miejsc na Androida (nowy).
Musisz zainicjować aplikację, wywołując metodę
Places.initializeWithNewPlacesApiEnabled()
. Więcej informacji o wybieraniu usługi Places API znajdziesz w artykule Konfigurowanie projektu Google Cloud.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.
Dodano nowe klasy, aby zdefiniować żądania lub dodać nowe pola do odpowiedzi.
Obiekt odpowiedzi
Place
zawiera nową metodęgetReviews()
, która zwraca listę obiektówReview
. Gdy aplikacja wyświetla informacje uzyskane z obiektuPlace
, 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:
- Migracja z interfejsu Place Details (starsza wersja) do interfejsu Place Details (nowa wersja)
- Przejście z Place Photo (starsza wersja) na Place Photo (nowa wersja)
- Migracja z autouzupełniania (starsza wersja) do autouzupełniania (nowa wersja)
- Migracja z funkcji „Aktualne miejsce” (starsza wersja) do funkcji „Wyszukiwanie w pobliżu” (nowa)