Wprowadzenie
Interfejs Places API (nowy) zapewnia lepszą wydajność i nowy model cenowy, dlatego warto zaktualizować aplikacje, które korzystają z interfejsu Places API (starsza wersja). Więcej informacji o porównywaniu funkcji znajdziesz w artykule Wybieranie interfejsu API.
Z tego przewodnika dowiesz się, jakie są najważniejsze różnice między Places API (nowym) a Places API (starszą wersją) oraz jak wprowadzić niezbędne zmiany.
Sprawdzone metody dotyczące płatności podczas migracji
Te wskazówki mają zastosowanie, jeśli wykorzystanie interfejsu API jest na tyle wysokie, że kwalifikuje się do cen na drugim poziomie. Podczas migracji do nowszej wersji interfejsu API opłaty są naliczane za inny kod SKU. Aby uniknąć wzrostu kosztów w miesiącu przejścia, zalecamy przejście na nowe interfejsy API w środowisku produkcyjnym jak najbliżej początku miesiąca. Dzięki temu w miesiącu migracji uzyskasz najbardziej opłacalne poziomy cen miesięcznych. Informacje o poziomach cen znajdziesz na stronie z cenami i w odpowiedziach na najczęstsze pytania dotyczące cen.
Włączanie Places API (nowość)
Aby korzystać z funkcji Places API (New), musisz najpierw włączyć Places API (New) w projekcie Google Cloud. Więcej informacji znajdziesz w artykule o konfigurowaniu projektu Google Cloud.
Następnie musisz się upewnić, że do klucza interfejsu API używanego przez aplikację dodano Places API (nowość). Więcej informacji znajdziesz w artykule o używaniu kluczy interfejsu API.
Ogólne zmiany
Oto niektóre ogólne zmiany, które dotyczą wielu interfejsów API:
- Wszystkie nowe interfejsy API obsługują zarówno klucze interfejsu API, jak i tokeny OAuth jako mechanizm uwierzytelniania.
- Jako format odpowiedzi obsługiwany jest tylko JSON.
- Maskowanie pól jest wymagane przez funkcje informacje o miejscu (nowa wersja), Wyszukiwanie w pobliżu (nowa wersja) i Wyszukiwanie tekstowe (nowa wersja), aby określić, które pola mają być zwracane w odpowiedzi. Więcej informacji znajdziesz w artykule FieldMask.
- Nowe interfejsy API Wyszukiwanie w pobliżu i Wyszukaj tekst zwracają teraz pełne informacje o miejscu, które odpowiadają informacjom zwracanym przez Szczegóły miejsca (nowa wersja).
- Format odpowiedzi JSON w interfejsach API Szczegóły miejsca (nowe), Wyszukiwanie w pobliżu (nowe) i Wyszukiwanie tekstowe (nowe) zmienił się w porównaniu z formatem dotychczasowych interfejsów API. Więcej informacji znajdziesz w artykule Migracja odpowiedzi interfejsu Places API.
Zmiany dotyczące interfejsów API
W tej sekcji znajdziesz te przewodniki po migracji dotyczące poszczególnych interfejsów API:
- Przejście na wyszukiwanie w pobliżu (nowa wersja)
- Migracja do usługi Wyszukaj tekst (New)
- Migracja do usługi Informacje o miejscu (nowej)
- Migracja do usługi Place Photos (New)
- Migracja do autouzupełniania (nowość)