Interfejs 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 „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 pobierać 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 na podstawie danych dzięki kompleksowym informacjom o różnych miejscach, które 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: mogą analizować 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: pobieraj 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 opisujemy przykładowe przypadki użycia interfejsu Places Aggregate API i zawieramy działający kod dla każdego przykładu.
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, przedziały cenowe i oceny klientów, aby podejmować decyzje oparte na danych dotyczące tego, gdzie otworzyć kolejną lokalizację.
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ługa dostawy w ramach handlu detalicznego
Podczas rozszerzania działalności na nowe miasto 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, 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.
Jak działa interfejs Places Aggregate API
Interfejs Places Aggregate API umożliwia określanie filtrów, aby zawęzić 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 na podstawie poziomów cen.
- Oceny: filtruj miejsca na podstawie ocen użytkowników.
Obiekt ComputeInsightsResponse w odpowiedzi interfejsu API zawiera wyniki analizy żądania. Jeśli np. 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 | Konfiguracja | Zacznij od sekcji Konfigurowanie projektu Google Cloud i wykonaj podane tam instrukcje. |
| 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?
- Sprawdź ceny i limity wykorzystania
- Wyświetl dokumentację API
- Zobacz najczęstsze pytania
- Sprawdź opcje pomocy