Ten dokument zawiera jasny opis wszystkich parametrów Places Insights API. Omówimy każdy z nich szczegółowo, oferując szczegółowe analizy wskazówki, które pomogą Ci w korzystaniu z tego narzędzia w kontekście danych geograficznych.
Interfejs Places Insights API umożliwia wykonywanie kilku kluczowych funkcji:
- Policz miejsca: określ liczbę miejsc spełniających określone kryteria. takie jak typ lokalizacji, stan działalności, poziom cen i oceny.
- Pobierz informacje o miejscach: możesz uzyskać nazwy miejsc spełniających kryteria określonych filtrów, a następnie pobierz bardziej szczegółowe informacje za pomocą Places API.
- Elastyczne filtrowanie: możesz stosować kompleksowe filtry, aby uzyskiwać dokładne statystyki.
Dostępne filtry:
- obszar geograficzny (koło, region lub niestandardowy wielokąt);
- Typy miejsc
- Stan działania
- Poziomy cen
- Zakresy ocen
Wymagane parametry
W tej sekcji omawiamy parametry wymagane przy wysyłaniu żądania do Places Insights API. Każde żądanie musi zawierać te informacje:
- Rodzaj statystyk.
- Filtr lokalizacji i filtr typu.
Statystyki
Określa typ statystyk, które chcesz obliczyć. Te typy statystyk są obsługiwane:
INSIGHT_COUNT
: zwraca liczbę miejsc spełniających kryteria filtra.INSIGHT_PLACES
: zwraca identyfikatory miejsc pasujące do kryteriów filtra.
Uwaga: jeśli wybierzesz tę opcję, interfejs Places Insights API zwróci identyfikatory miejsc.
tylko wtedy, gdy count
ma wartość 100 lub mniejszą.
Filtr
Określa kryteria filtrowania miejsc. Jako minimum musisz podać
LocationFilter
i TypeFilter
.
Filtr lokalizacji
Istnieją następujące typy filtrów lokalizacji:
circle
: określa obszar w postaci koła ze środkiem i promieniem.region
: określa obszar jako region.custom_area
: definiuje obszar jako wielokąt niestandardowy.
Okrąg
Jeśli obszar geograficzny został określony w formie koła, musisz podać center
i radius
. Środek może być szerokością i długością geograficzną lub miejscem
Identyfikator środka okręgu.
- pośrodku:
lat_lng
: szerokość i długość geograficzna środka okręgu. Szerokość geograficzna musi być liczbą z zakresu od -90 do 90 włącznie. Długość geograficzna musi być liczbą od -180 do 180 włącznie.place
: identyfikator miejsca pośrodku okręgu. Pamiętaj, że tylko punkt miejsca są obsługiwane. Ten ciąg musi zaczynać się od prefiksuplaces/
.
radius
: promień okręgu w metrach. Ta liczba musi być liczbą dodatnią.
Region
Obszar możesz określić jako region za pomocą parametru place
. Użyj identyfikatora miejsca
reprezentującego obszar geograficzny (np. obszar reprezentowany przez
wielokąt). Na przykład identyfikator miejsca Warszawa, mazowieckie to
places/ChIJ4dG5s4K3wogRY7SWr4kTX6c
Nieobsługiwane typy regionów | |
---|---|
establishment |
place_of_worship |
floor |
post_box |
food |
postal_code_suffix |
general_contractor |
room |
geocode |
street_address |
health |
street_number |
intersection |
sublocality_level_5 |
landmark |
subpremise |
Za pomocą pola types
z wywołania Geocoding API możesz określić
typu lokalizacji lub adresu powiązanego z identyfikatorem miejsca (np. czy jest to
miasta, dzielnicy lub kraju.
Obszar niestandardowy
Określa obszar niestandardowego wielokąta za pomocą współrzędnych.
Wejdź na https://geojson.io/, aby narysować wielokąt niestandardowy. wprowadzić je do żądania. wielokąt musi mieć co najmniej 4, gdzie pierwsza i ostatnia współrzędne są identyczne. Oprócz pierwszej i ostatniej współrzędnej nie mogą występować żadne inne zduplikowane współrzędne. Na przykład:
"coordinates":[ { "latitude":37.776, "longitude":-122.666 }, { "latitude":37.130, "longitude":-121.898 }, { "latitude":37.326, "longitude":-121.598 }, { "latitude":37.912, "longitude":-122.247 }, { "latitude":37.776, "longitude":-122.666 } ]
Filtr typu
Określa typy miejsc do uwzględnienia lub wykluczenia. Aby wyświetlić listę zarówno
i dodatkowe typy miejsc obsługiwane przez interfejs Places Insights API. Patrz Tabela
A w przewodniku Typy miejsc dla interfejsu Places API
(Nowość). Co najmniej 1 typ included_types
lub included_primary_types
musi być
dołączono.
included_types
: lista uwzględnionych typów miejsc.excluded_types
: lista wykluczonych typów miejsc.included_primary_types
: lista obsługiwanych głównych typów miejsc.excluded_primary_types
: lista wykluczonych głównych miejsc.
Więcej informacji na temat działania filtrów typów i typów miejsc znajdziesz w sekcji Więcej informacji na temat typu filtrów.
Parametry opcjonalne
Pozostałe 3 filtry są opcjonalne:
operating_status
: określa stany miejsc do uwzględnienia lub wykluczenia. Domyślnie filtrowane jest według kolumnyoperating_status: OPERATING_STATUS_OPERATIONAL
(jedna konkretna wartość).price_levels
: określa poziomy cen miejsc. Wartość domyślna to „nie” filtrowanie (w wynikach uwzględniane są wszystkie poziomy cenowe).rating_filter
: określa zakres ocen miejsc. Wartość domyślna to „nie” filtrowanie (w wynikach wyświetlane są wszystkie oceny).
Stan działania
Filtruj na podstawie stanu działalności (np. operacyjnego lub tymczasowego zamknięte).
Poziom cen
Filtruj na podstawie poziomu cen (np. bezpłatny, umiarkowany lub drogi).
Filtr: oceny
Filtruje miejsca na podstawie ich średnich ocen użytkowników. Oba te pola są są opcjonalne, więc jeśli zostaną pominięte, domyślnie będą zawierały też miejsca które nie mają oceny.
min_rating
: minimalna średnia ocena użytkowników (między 1,0 a 5,0).max_rating
: maksymalna średnia ocena użytkowników (od 1,0 do 5,0).