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 występowania określonych typów miejsc w pobliżu danej lokalizacji i odpowiadaniu na pytania takie jak „Jakie lub ile restauracji z 5 gwiazdkami i cenami na poziomie $$$ znajduje się w promieniu 5 km od tej lokalizacji?”.

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

Dlaczego warto korzystać z interfejsu Places Aggregate API

Interfejs Places Aggregate API umożliwia użytkownikom podejmowanie decyzji opartych na danych na podstawie kompleksowych informacji o różnych miejscach, które im udostępniasz. 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.
  • Deweloperzy: tworzenie aplikacji, które zapewniają spersonalizowane rekomendacje.
  • Badacze: analizują trendy i wzorce w określonych obszarach.

Możliwości interfejsu Places Aggregate API

Interfejs Places Aggregate API umożliwia uzyskanie tych informacji:

  • Liczby: pobierz liczbę miejsc, które spełniają Twoje kryteria.
  • Identyfikatory miejsc: pobierz identyfikatory 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, przedziały cenowe i oceny klientów.

Przykłady

W tej sekcji znajdziesz przykłady zastosowań interfejsu Places Aggregate API oraz działający kod dla każdego z nich.

Otwieranie nowej kawiarni

Właściciel restauracji chce otworzyć nową kawiarnię. Najpierw chcą zobaczyć, gdzie znajdują się kawiarnie, aby zidentyfikować obszary o wysokim i niskim zagęszczeniu i na tej podstawie podjąć decyzję biznesową. Interfejs 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 podejmować decyzje oparte na danych dotyczące tego, 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ć ROI z planowanych inwestycji w nieruchomości. Korzystając z interfejsu Places Aggregate API, mogą 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ługi dostawy w handlu detalicznym

Podczas wchodzenia na rynek nowego miasta firma świadcząca usługi dostawy detalicznej musi określić liczbę kierowców, których należy przydzielić do danego regionu na podstawie gęstości popularnych miejsc docelowych konsumentów, takich jak restauracje, sklepy osiedlowe 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 interfejs Places Aggregate API

Interfejs Places Aggregate API umożliwia określanie filtrów, które zawężają kryteria wyszukiwania. Po wybraniu typu statystyk INSIGHT_COUNT lub INSIGHT_PLACES możesz dodać kryteria filtrowania, w tym:

  • Lokalizacja: określ 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łalności: filtruj miejsca na podstawie ich stanu działalności.
  • Poziomy cen: filtruj miejsca według poziomów cen.
  • Oceny: filtruj miejsca na podstawie ocen użytkowników.

Obiekt odpowiedzi interfejsu API ComputeInsightsResponse zawiera wyniki analizy żą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 interfejsu Places Aggregate API

1 Skonfiguruj konto. Zacznij od skonfigurowania projektu Google Cloud i postępuj zgodnie z dalszymi instrukcjami.
2 Wyślij prośbę o podanie liczby pasujących miejsc. Zobacz Przesyłanie pierwszej prośby.
3 Więcej informacji o parametrach żądania Zobacz parametry żądania.

Co dalej?