Skrócone informacje o Places API (starsza wersja)

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

Places API (starsza wersja): typowe błędy

  • Problem: jeśli żądanie informacji o miejscu (starsza wersja) pomija parametr fields lub nie określa żadnych pól, interfejs API zwraca wszystkie pola i nalicza za nie opłaty. Rozwiązanie: zawsze ustawiaj parametr fields lub 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_reference w 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 parametr photo_reference z 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_DENIED z 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: pole business_status. Zobacz przewodnik po migracji.
  • Pole odpowiedzi reference: wycofane 3 września 2019 r. Zastąpienie: pole place_id. Zobacz przewodnik po migracji.
  • Parametr żądania wyszukiwania w pobliżu (starsza wersja) name: wycofany. Zamiana: parametr keyword. Zobacz przewodnik po migracji.