Parametry żądania

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 prefiksu places/.
  • 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 kolumny operating_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).