Krótkie wprowadzenie do Places API (nowość)

Places API (New) to usługa sieciowa, która zwraca dane o lokalizacji w formacie JSON dotyczące firm, położeń geograficznych i ciekawych miejsc. Obsługuje wyszukiwanie tekstowe (nowe), wyszukiwanie w pobliżu (nowe), autouzupełnianie (nowe), informacje o miejscu (nowe) i zdjęcia miejsca (nowe).

Places API (nowość): najważniejsze informacje

  • Usługa: Places API (nowość)
  • Inna nazwa: Places API
  • Kategoria: Miejsca
  • Platforma: usługa internetowa (REST)
  • Działa na: serwerze (kod backendu)
  • Etap uruchomienia: GA
  • Cykl życia: aktywny
  • Omówienie: omówienie Places API (nowość)
  • Dostępność: cały świat. Projekty z adresami rozliczeniowymi w Europejskim Obszarze Gospodarczym korzystają z Warunków korzystania z usługi Google Maps Platform w Europejskim Obszarze Gospodarczym (obowiązujących od 8 lipca 2025 r.), zgodnie z którymi treści z interfejsu Places API inne niż szerokość i długość geograficzna oraz identyfikatory miejsc nie mogą być używane na żadnej mapie, chyba że za pomocą Places UI Kit. Podsumowania miejsc, opinii i obszarów oparte na AI są dostępne tylko w obsługiwanych językach i regionach.

Places API (nowość): kiedy warto z niego korzystać

Używaj Places API (nowego), gdy:

  • Musisz wyszukać miejsca z serwera za pomocą zapytania tekstowego (Wyszukiwanie tekstowe (nowe)) lub w pobliżu lokalizacji (Wyszukiwanie w pobliżu (nowe)).
  • Potrzebujesz podpowiedzi miejsc lub zapytań z backendu za pomocą autouzupełniania (nowego).
  • Masz identyfikator miejsca i potrzebujesz szczegółowych informacji, takich jak adres, numer telefonu, ocena, opinie lub zdjęcia.
  • Potrzebujesz podsumowań miejsc, opinii lub obszarów wygenerowanych przez AI.

Nie używaj Places API (nowego), gdy:

Places API (nowość): konfiguracja

Oficjalne pakiety Places API (nowość):

  • npm: @googlemaps/places
  • pypi: google-maps-places
  • go: cloud.google.com/go/maps

Places API (nowość): typowe błędy

  • Problem: Informacje o miejscu (nowa wersja), Wyszukiwanie w pobliżu (nowa wersja) i wyszukiwanie tekstowe (nowa wersja) nie mają domyślnej listy zwracanych pól. Żądania bez maski pola zwracają błąd. Rozwiązanie: przekaż maskę pola odpowiedzi za pomocą parametru fields lub $fields albo nagłówka X-Goog-FieldMask. Zobacz /maps/documentation/places/web-service/choose-fields.
  • Problem: jeśli token sesji autouzupełniania (nowej) zostanie pominięty lub ponownie użyty po zakończeniu sesji, każde żądanie będzie rozliczane osobno jako SKU: Autocomplete Requests. Rozwiązanie: wygeneruj nowy token sesji (zalecany jest UUID v4) dla każdej sesji i zakończ ją żądaniem dotyczącym informacji o miejscu (nowych) lub Weryfikacji adresów. Więcej informacji znajdziesz na stronie /maps/documentation/places/web-service/place-session-tokens.
  • Problem: istniejący lub wygenerowany przez AI kod, który wywołuje Places API (starsza wersja) lub Maps JavaScript API PlacesService w projekcie bez włączonego starszego interfejsu API, kończy się błędem LegacyApiNotActivatedMapError. Rozwiązanie: przenieś wywołania do Places API (nowego) i uwzględnij wymaganą maskę pola. Zobacz /maps/legacy#LegacyApiNotActivatedMapError.
  • Problem: przechowywane identyfikatory miejsc mogą stać się nieaktualne. W takim przypadku usługa informacje o miejscu (nowa) zwraca błąd NOT_FOUND (HTTP 404), a nieprawidłowo sformatowane lub obcięte identyfikatory zwracają błąd HTTP 400 INVALID_ARGUMENT. Rozwiązanie: odśwież przechowywane identyfikatory miejsc starsze niż 12 miesięcy, wysyłając żądanie dotyczące informacji o miejscu (nowe), które zawiera tylko pole id (bezpłatnie). Zobacz /maps/documentation/places/web-service/place-id#refresh-id.

Co możesz zrobić za pomocą Places API (nowość)

Zapoznaj się z przewodnikami po poszczególnych zadaniach, do których linki znajdziesz poniżej, lub porównaj usługi w Eksploratorze funkcji.

Places API (nowość): generatywna AI

Places API (nowość): Places