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:
- Tworzysz natywną aplikację na Androida. Zamiast tego użyj pakietu SDK Miejsc na Androida.
- Tworzysz natywną aplikację na iOS. Zamiast tego użyj pakietu Places SDK na iOS.
- Tworzysz aplikację internetową na przeglądarkę i chcesz, aby biblioteka Miejsc była wczytywana w języku JavaScript. Zamiast tego użyj Maps JavaScript API.
Places API (nowość): konfiguracja
- Usługa do włączenia:
places.googleapis.com - Uwierzytelnianie: klucz interfejsu API, OAuth 2.0
- Pierwsze kroki: skonfiguruj Places API (nowość)
- Dokumentacja: dokumentacja Places API (New)
- Ceny: użycie i rozliczenia Places API (nowość)
- Zasady: Zasady dotyczące Places API (New)
- Informacje o wersji: informacje o wersji Places API (nowość)
Oficjalne pakiety Places API (nowość):
- npm:
@googlemaps/places - pypi:
google-maps-places - go:
cloud.google.com/go/maps
Places API (nowość): produkty powiązane
- Zastępuje: Places API (starsza wersja)
- Często używane z: Geocoding API, Routes API, Address Validation API
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
fieldslub$fieldsalbo nagłówkaX-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
PlacesServicew projekcie bez włączonego starszego interfejsu API, kończy się błędemLegacyApiNotActivatedMapError. 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 400INVALID_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 poleid(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
- Zwracanie podsumowania opinii użytkowników wygenerowanego przez AI dla określonego identyfikatora miejsca w Google.
- Zwracanie podsumowania miejsca opartego na AI, które zawiera informacje o okolicy i udogodnieniach wokół określonego identyfikatora miejsca w Google dla stacji ładowania pojazdów elektrycznych.
Places API (nowość): Places
- Zwracaj listę miejsc i informacje o miejscach na podstawie ciągu zapytania.
- Zwracanie listy miejsc i informacji o miejscach w pobliżu określonej lokalizacji.
- Zwracaj wyniki autouzupełniania dotyczące miejsc na podstawie ciągu zapytania.
- Zwracanie szczegółowych informacji o konkretnym miejscu.
- Zwracanie zdjęć konkretnego miejsca Uwaga: przy każdym zdjęciu wyświetlaj informacje o autorze (imię i nazwisko autora połączone z identyfikatorem URI jego profilu). The Places policies for each platform require this, for example /maps/documentation/javascript/policies#photo-attributions and /maps/documentation/places/web-service/policies#photos-and-review.
- Zmień rozmiar zdjęć miejsc.
- Zwracanie ocen i opinii o konkretnym miejscu. Uwaga: w usłudze internetowej Places API (nowej) informacje o miejscu to żądanie HTTP GET wysyłane do https://places.googleapis.com/v1/places/{placeId} z X-Goog-FieldMask (np. rating,userRatingCount,reviews). Wyszukiwanie tekstowe, wyszukiwanie w pobliżu i autouzupełnianie używają metody POST. Na Androidzie przekaż Place.Field.RATING, USER_RATING_COUNT i REVIEWS do PlacesClient.fetchPlace(). Na iOS przekaż GMSPlacePropertyRating, GMSPlacePropertyUserRatingsTotal i GMSPlacePropertyReviews w GMSFetchPlaceRequest.
- Określ pola danych uwzględniane w odpowiedziach dotyczących informacji o miejscu.
- Określ typy miejsc, które mają być uwzględniane w odpowiedziach z informacjami o miejscu.
- Zwróć identyfikator URI, aby otworzyć stronę z informacjami o miejscu w Mapach Google.
- Zwróć identyfikator URI, aby otworzyć stronę ze wskazówkami dojazdu do miejsca w Mapach Google.
- Zwraca identyfikator URI, który otwiera stronę „Napisz opinię” w Mapach Google dla danego miejsca.
- Zwraca identyfikator URI, który otwiera stronę z opiniami o miejscu w Mapach Google.
- Zwraca identyfikator URI, który otwiera stronę ze zdjęciami miejsca w Mapach Google.
- Zwracanie podsumowania przeglądu od AI dotyczącego konkretnego miejsca.
- Zwracanie wygenerowanego przez AI podsumowania opisującego miejsca w pobliżu określonej lokalizacji.
- Zwracanie informacji o miejscach na podstawie ciągu zapytania, które znajdują się na wstępnie zdefiniowanej trasie.
- Zwracanie odległości, czasu podróży i identyfikatora URI wskazówek dojazdu do miejsc wyszukiwanych tekstowo na podstawie zestawu współrzędnych szerokości i długości geograficznej.
- Zwracaj odległość, czas podróży i identyfikator URI wskazówek dojazdu do miejsc w pobliżu na podstawie współrzędnych szerokości i długości geograficznej.
- Zwracaj odległość, czas podróży i identyfikator URI wskazówek dojazdu między miejscem początkowym wstępnie zdefiniowanej trasy a każdym z miejsc zwróconych na podstawie ciągu zapytania, które również znajdują się na trasie.
- Zwracanie odległości, czasu podróży i identyfikatora URI wskazówek dojazdu między każdym z miejsc zwróconych na podstawie ciągu zapytania, które znajdują się na wstępnie zdefiniowanej trasie, a miejscem docelowym trasy.