Przegląd

Places Aggregate API to usługa, która dostarcza statystyki dotyczące miejsc w określonym obszarze na podstawie kryteriów takich jak lokalizacja, typ, status działalności, poziom cen i oceny użytkowników. Ta usługa może pomóc w analizowaniu gęstości określonych typów miejsc w pobliżu danej lokalizacji oraz w odpowiadaniu na pytania takie jak "Ile restauracji z 5 gwiazdkami i cenami $$$ znajduje się w promieniu 5 km od tej lokalizacji?"

Wyniki są zwracane jako zagregowane liczby lub zidentyfikowane identyfikatory miejsc w obszarze zainteresowania. Użytkownicy mogą używać interfejsu Place Details API, aby uzyskać więcej informacji o tych identyfikatorach miejsc.

Dlaczego warto korzystać z Places Aggregate API

Places Aggregate API umożliwia użytkownikom podejmowanie decyzji opartych na danych na podstawie wyczerpujących informacji o różnych miejscach. Wykorzystuje dokładne i aktualne modele miejsc, które obsługują te kluczowe przypadki użycia:

  • Firmy: analizowanie konkurencji i potencjalnych lokalizacji nowych oddziałów.
  • Programiści: tworzenie aplikacji, które zapewniają spersonalizowane rekomendacje.
  • Badacze: badanie trendów i wzorców w określonych obszarach.

Co możesz robić za pomocą Places Aggregate API

Za pomocą Places Aggregate API możesz uzyskać te informacje:

  • Liczby: pobieranie liczby miejsc, które spełniają Twoje kryteria.
  • Identyfikatory miejsc: pobieranie identyfikatorów miejsc, które spełniają Twoje kryteria.

Możesz też użyć filtrowania , aby zawęzić wyszukiwanie na podstawie różnych atrybutów, takich jak typy miejsc, godziny otwarcia, poziomy cen i oceny klientów.

Przykłady

W tej sekcji opisujemy przykładowe przypadki użycia Places Aggregate API i podajemy działający kod dla każdego przykładu.

Otwieranie nowej kawiarni

Właściciel restauracji chce otworzyć nową kawiarnię. Aby to zrobić, najpierw chce zobaczyć, gdzie znajdują się kawiarnie, aby zidentyfikować obszary o wysokim i niskim zagęszczeniu i na tej podstawie podjąć decyzję biznesową. Places Aggregate API może pomóc w analizowaniu liczby kawiarni w określonym promieniu na podstawie atrybutów takich jak stan działania, poziomy cen i oceny klientów, aby podjąć decyzję na podstawie danych o tym, gdzie otworzyć kolejną lokalizację.

Zobacz przykład

Mapa San Francisco z ocenami rozrywki według kodów pocztowych.

Firma inwestująca w nieruchomości

Firma inwestująca w nieruchomości chce ulepszyć swoje modele finansowe i dokładnie określić zwrot z inwestycji w planowane inwestycje w nieruchomości. Za pomocą Places Aggregate API może zbierać szczegółowe dane o udogodnieniach w pobliżu potencjalnych nieruchomości inwestycyjnych, takich jak bankomaty, szpitale, stacje transportu publicznego i sklepy spożywcze, aby poznać udogodnienia w pobliżu potencjalnych nieruchomości inwestycyjnych.

Usługa dostawy detalicznej

Podczas rozszerzania działalności na nowe miasto usługa dostawy detalicznej musi określić liczbę kierowców, których należy przydzielić do regionu na podstawie gęstości popularnych miejsc docelowych, takich jak restauracje, sklepy spożywcze i sklepy z alkoholem. Za pomocą interfejsu API usługa dostawy zlicza łączną liczbę tych placówek w całym mieście, aby móc skutecznie planować i przydzielać zasoby.

Zobacz przykład

Mapa cieplna restauracji w Mountain View według liczby klientów.

Jak działa Places Aggregate API

Places Aggregate API umożliwia określanie filtrów, aby zawęzić kryteria wyszukiwania. Po wybraniu typu statystyki INSIGHT_COUNT lub INSIGHT_PLACES możesz dodać kryteria filtrowania, w tym:

  • Lokalizacja: zdefiniuj obszar zainteresowania za pomocą okręgów, regionów lub niestandardowych wielokątów.
  • Typ: określ typy miejsc, które Cię interesują.
  • Stan działania: filtruj miejsca na podstawie ich stanu działania.
  • Poziomy cen: filtruj miejsca na podstawie poziomów cen.
  • Oceny: filtruj miejsca na podstawie ocen użytkowników.

Odpowiedź interfejsu API, czyli obiekt ComputeInsightsResponse, zawiera wyniki statystyk żądania. Jeśli na przykład wybierzesz INSIGHT_COUNT, odpowiedź będzie zawierać łączną liczbę miejsc, a jeśli wybierzesz INSIGHT_PLACES, odpowiedź będzie zawierać listę identyfikatorów miejsc.

Jak korzystać z Places Aggregate API

1 Konfiguracja Zacznij od skonfigurowania projektu Google Cloud i wykonaj kolejne instrukcje.
2 Wyślij prośbę o podanie liczby pasujących miejsc. Zapoznaj się z sekcją Wysyłanie pierwszego żądania.
3 Dowiedz się więcej o parametrach żądania. Zapoznaj się z sekcją Parametry żądania.

Co dalej?