Od października 2026 r. nie będzie już można włączać interfejsu Places API (starszej wersji) w nowych projektach w chmurze Google. Istniejące projekty są nadal w pełni obsługiwane. Aby korzystać z nowych funkcji i większej wydajności, przejdź na Places API (New).
Places API (starsza wersja): najważniejsze informacje
- Usługa: Places API (starsza wersja)
- Inne nazwy: Places API (starsza wersja usługi internetowej), usługa internetowa Places API (maps/api/place)
- Kategoria: Miejsca
- Platforma: usługa internetowa (REST)
- Działa na: serwerze (kod backendu)
- Etap uruchomienia: GA
- Cykl życia: starsza wersja
- Zastąpiony przez: Places API (nowość)
- Omówienie: omówienie Places API (starsza wersja)
Places API (starsza wersja): kiedy używać
Używaj Places API (starszej wersji), gdy:
- Utrzymujesz istniejący projekt, który ma już włączony interfejs Places API (starsza wersja) i wywołuje punkty końcowe
maps.googleapis.com/maps/api/place. - Aby zachować działanie dotychczasowych wywołań funkcji Znajdź miejsce, Wyszukiwanie w pobliżu, Wyszukaj tekst, Szczegóły, Zdjęcia lub Autouzupełnianie (starsza wersja) podczas migracji, musisz je zachować.
Nie używaj Places API (starsza wersja), gdy:
- Rozpoczynasz nowy projekt Google Cloud. Od października 2026 r. nie będzie można włączać interfejsu Places API (starszej wersji) w nowych projektach. Zamiast tego użyj Places API (nowość).
- Potrzebujesz nowych funkcji, uwierzytelniania OAuth lub masek pól w przypadku wyszukiwania w pobliżu i wyszukiwania tekstowego, aby płacić tylko za pola, o które prosisz. Zamiast tego użyj Places API (nowość).
- W nowym kodzie potrzebujesz funkcji Znajdź miejsce (starsza wersja) lub Autouzupełnianie zapytania (starsza wersja). Zastępują je funkcje Wyszukaj tekst (New) i Autocomplete (New). Zamiast tego użyj Places API (nowość).
Places API (starsza wersja): konfiguracja
- Usługa do włączenia:
places-backend.googleapis.com - Uwierzytelnianie: klucz interfejsu API
- Ceny: użycie i rozliczenia Places API (starsza wersja)
- Zasady: zasady dotyczące Places API (starsza wersja)
Places API (starsza wersja): typowe błędy
- Problem: jeśli żądanie informacji o miejscu (starsza wersja) pomija parametr
fieldslub nie określa żadnych pól, interfejs API zwraca wszystkie pola i nalicza za nie opłaty. Rozwiązanie: zawsze ustawiaj parametrfieldslub przejdź na informacje o miejscu (nowe) z maską pola. Zobacz /maps/documentation/places/web-service/legacy/details. - Problem: wyszukiwanie w pobliżu (starsza wersja) i wyszukiwanie tekstowe (starsza wersja) nie obsługują określania, które pola mają być zwracane. Zawsze zwracają stały zestaw pól (podzbiór pól informacji o miejscu) i wywołują kody SKU danych podstawowych, danych kontaktowych i danych o atmosferze. Rozwiązanie: przejdź na wyszukiwanie w pobliżu (nowe) lub wyszukiwanie tekstowe (nowe) z maską pola albo użyj funkcji Znajdź miejsce (starsza wersja) z parametrem
fields, aby żądać tylko potrzebnych pól i płacić tylko za nie. Zobacz /maps/billing-and-pricing/sku-details/legacy#places_nearby-search-legacy-pro-sku. - Problem: nie można zapisać
photo_referencew pamięci podręcznej, a jego ważność może wygasnąć, co spowoduje, że zapisane odwołania przestaną działać. Rozwiązanie: zanim poprosisz o zdjęcie, pobierz nowy parametrphoto_referencez odpowiedzi na zapytanie o informacje o miejscu, Find Place, Wyszukiwanie w pobliżu lub Wyszukaj tekst. Zobacz /maps/documentation/places/web-service/legacy/photos. - Problem: wywołania interfejsu Places API (starszego typu) z projektu, w którym nie jest on włączony, zwracają błąd
REQUEST_DENIEDz komunikatem o błędzie „Wywołujesz interfejs API starszego typu, który nie jest włączony w Twoim projekcie…”. (LegacyApiNotActivatedMapError). Od października 2026 r. nie będzie można włączać interfejsu Places API (starszej wersji) w nowych projektach. Rozwiązanie: używaj Places API (nowego) w nowych projektach i przeprowadź migrację istniejących aplikacji. Podczas migracji możesz poprosić o krótkoterminową aktywację starszej wersji interfejsu API za pomocą formularza opinii na stronie starszej wersji. Zobacz /maps/legacy#LegacyApiNotActivatedMapError.
Places API (starsza wersja): starsze i wycofane funkcje
- Pole odpowiedzi
permanently_closed: wycofane 26 maja 2020 r. Zastąpienie: polebusiness_status. Zobacz przewodnik po migracji. - Pole odpowiedzi
reference: wycofane 3 września 2019 r. Zastąpienie: poleplace_id. Zobacz przewodnik po migracji. - Parametr żądania wyszukiwania w pobliżu (starsza wersja)
name: wycofany. Zamiana: parametrkeyword. Zobacz przewodnik po migracji.