Interfejs Places API (nowy) zapewnia lepszą wydajność i nowy model cen, dlatego warto zaktualizować aplikacje, które korzystają z interfejsu Places API. Więcej informacji o porównywaniu funkcji znajdziesz w artykule Wybieranie interfejsu API.
Z tego przewodnika dowiesz się, jakie są główne różnice między interfejsem Places API (nowy) a interfejsem Places API oraz jak wprowadzić niezbędne zmiany.
Sprawdzone metody dotyczące płatności w przypadku migracji
Te wskazówki obowiązują, jeśli korzystanie z interfejsu API jest na tyle intensywne, że kwalifikuje się do cen drugiego poziomu. Podczas migracji do nowszej wersji interfejsu API płacisz też za inny kod SKU. Aby uniknąć zwiększonych kosztów w miesiącu przejścia, zalecamy przejście na nowe interfejsy API w wersji produkcyjnej możliwie jak najbliżej początku miesiąca. Dzięki temu w miesiącu migracji będziesz korzystać z najbardziej opłacalnych poziomów cen miesięcznych. Informacje o poziomach cen znajdziesz na tej stronie oraz w artykule z odpowiedziami na najczęstsze pytania dotyczące cen.
Włączanie interfejsu Places API (nowość)
Aby korzystać z funkcji interfejsu Places API (New), musisz najpierw włączyć interfejs Places API (New) w projekcie Google Cloud. Więcej informacji znajdziesz w artykule Konfigurowanie projektu Google Cloud.
Następnie musisz dodać Places API (New) do klucza interfejsu API używanego przez aplikację. Więcej informacji znajdziesz w artykule Korzystanie z kluczy interfejsu API.
Ogólne zmiany
Oto kilka ogólnych zmian, które dotyczą wielu interfejsów API:
- Wszystkie nowe interfejsy API obsługują mechanizm uwierzytelniania oparty na kluczach API i OAuth.
- Jako format odpowiedzi obsługiwany jest tylko JSON.
- Maskowanie pól jest wymagane przez funkcje Szczegóły miejsca (nowa), Wyszukiwanie w pobliżu (nowa) i Wyszukiwanie tekstowe (nowa), aby określić, które pola mają być zwracane w odpowiedzi. Więcej informacji znajdziesz w artykule FieldMask.
- Interfejsy wyszukiwania w pobliżu (nowy) i wyszukiwania tekstowego (nowy) zwracają teraz pełne informacje o miejscu, aby pasowały do informacji o miejscu zwracanych przez interfejs Szczegóły miejsca (nowy).
- Format odpowiedzi w formacie JSON w przypadku interfejsów API Szczegóły miejsca (nowy), Wyszukiwanie w pobliżu (nowy) i Wyszukiwanie tekstu (nowy) został zmieniony w stosunku do formatu istniejących interfejsów API. Więcej informacji znajdziesz w artykule Migracja odpowiedzi interfejsu Places API.
Zmiany dotyczące interfejsu API
W tej sekcji znajdziesz te przewodniki dotyczące migracji dla poszczególnych interfejsów API: