Package google.maps.areainsights.v1

Indeks

AreaInsights

Definicja usługi dla wywołania RPC Places Aggregate.

ComputeInsights

rpc ComputeInsights(ComputeInsightsRequest) returns (ComputeInsightsResponse)

Ta metoda umożliwia pobieranie statystyk dotyczących obszarów za pomocą różnych filtrów, takich jak obszar, typ miejsca, stan działania, poziom cen i oceny. Obecnie dostępne są statystyki „liczba” i „miejsca”. Dzięki statystykom „liczba” możesz uzyskać odpowiedzi na pytania w rodzaju „Ile restauracji w Kalifornii jest czynnych, niedrogich i ma średnią ocenę co najmniej 4 gwiazdek” (więcej informacji znajdziesz w enumeracji insight). Dzięki statystykom dotyczącym „miejsc” możesz określić, które miejsca pasują do wybranego filtra. Klienci mogą następnie używać tych nazw zasobów miejsc do pobierania szczegółowych informacji o poszczególnych miejscach za pomocą interfejsu Places API.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

  • https://www.googleapis.com/auth/cloud-platform

ComputeInsightsRequest

Żądanie dotyczące interfejsu ComputeInsights RPC.

Pola
insights[]

Insight

Wymagane. Statystyki do obliczenia. Obecnie obsługiwane są tylko parametry INSIGHT_COUNT i INSIGHT_PLACES.
filter

Filter

Wymagane. Filtr statystyk.

ComputeInsightsResponse

Odpowiedź dla interfejsu ComputeInsights RPC.

Pola
place_insights[]

PlaceInsight

Wynik dla Insights.INSIGHT_PLACES.
count

int64

Wynik dla Insights.INSIGHT_COUNT.

Filtr

Filtry dostępne w RPC ComputeInsights.

Pola
location_filter

LocationFilter

Wymagane. Ogranicza wyniki do miejsc znajdujących się w obszarze określonym przez filtry lokalizacji.
type_filter

TypeFilter

Wymagane. Filtry typu miejsca.
operating_status[]

OperatingStatus

Opcjonalnie: Ogranicza wyniki do miejsc, których stan działania jest uwzględniony na tej liście. Jeśli parametr operating_status nie jest ustawiony, domyślnie używana jest wartość OPERATING_STATUS_OPERATIONAL.
price_levels[]

PriceLevel

Opcjonalnie: Ogranicza wyniki do miejsc, których poziom ceny jest uwzględniony na tej liście. Jeśli price_levels nie jest ustawiony, w wynikach uwzględniane są wszystkie poziomy cen.
rating_filter

RatingFilter

Opcjonalnie: Ogranicza wyniki do miejsc, których średnie oceny użytkowników mieszczą się w zakresie określonym przez parametr rating_filter. Jeśli parametr rating_filter nie jest ustawiony, w wyniku uwzględniane są wszystkie oceny.

Statystyki

Obsługiwane statystyki

Wartości w polu enum
INSIGHT_UNSPECIFIED Nie określono.
INSIGHT_COUNT

Statystyka „Liczba”.

Gdy ta funkcja jest określona, ComputeInsights zwraca liczbę miejsc pasujących do określonych kryteriów filtra.

Przykładowe żądanie:

{
  "insights": ["INSIGHT_COUNT"],
  "filter": {
    "locationFilter": {
      "region": {
        "place": "places/ChIJPV4oX_65j4ARVW8IJ6IJUYs"
      }
    },
    "typeFilter": {
      "includedTypes": ["restaurant"]
    },
    "operatingStatus": ["OPERATING_STATUS_OPERATIONAL"],
    "priceLevels": [
      "PRICE_LEVEL_FREE",
      "PRICE_LEVEL_INEXPENSIVE"
    ],
    "ratingFilter": {
      "minRating": 4.0
    }
  }
}

Przykładowa odpowiedź:

{
  "count": 1234
}
INSIGHT_PLACES

Miejsca zwrotu

Gdy ta statystyka jest określona, ComputeInsights zwraca identyfikatory miejsc pasujące do określonych kryteriów filtra.

Przykładowe żądanie:

{
  "insights": ["INSIGHT_PLACES"],
  "filter": {
    "locationFilter": {
      "region": {
        "place": "places/ChIJPV4oX_65j4ARVW8IJ6IJUYs"
      }
    },
    "typeFilter": {
      "includedTypes": ["restaurant"]
    },
    "operatingStatus": ["OPERATING_STATUS_OPERATIONAL"],
    "priceLevels": [
      "PRICE_LEVEL_FREE",
      "PRICE_LEVEL_INEXPENSIVE"
    ],
    "ratingFilter": {
      "minRating": 4.0
    }
  }
}

Przykładowa odpowiedź:

{
  "placeInsights": [
    {"place": "places/ABC"},
    {"place": "places/PQR"},
    {"place": "places/XYZ"}
  ]
}

LocationFilter

Filtry lokalizacji.

Określa obszar, który Cię interesuje.

Pola
Pole unii area. Musisz podać jeden z tych elementów. area może być tylko jednym z tych elementów:
circle

Circle

Pole koła.
region

Region

Obszar jako region.
custom_area

CustomArea

Obszar niestandardowy określony przez wielokąt.

Okrąg

Okrąg jest definiowany przez punkt środkowy i promień w metrach.

Pola
radius

int32

Opcjonalnie: Promień koła w metrach
Pole unii center. środek koła, center może być tylko jednym z tych elementów:
lat_lng

LatLng

Szerokość i długość geograficzna środka koła.
place

string

Format: musi mieć format places/PLACE_ID, gdzie PLACE_ID to unikalny identyfikator miejsca. Na przykład: places/ChIJgUbEo8cfqokR5lP9_Wh_DaM.

CustomArea

Obszar niestandardowy.

Pola
polygon

Polygon

Wymagane. Obszar niestandardowy reprezentowany przez wielokąt

Wielokąt

Wielokąt jest reprezentowany przez serię połączonych współrzędnych w kolejności przeciwnej do ruchu wskazówek zegara. Współrzędne tworzą zamkniętą pętlę i określają wypełniony obszar. Pierwsze i ostatnie współrzędne są równoważne i muszą zawierać identyczne wartości. Jest to uproszczona wersja wielokątów GeoJSON (obsługujemy tylko 1 zewnętrzny pierścień przeciwny do ruchu wskazówek zegara).

Pola
coordinates[]

LatLng

Opcjonalnie: Współrzędne definiujące wielokąt.

Region

Region to granica geograficzna, np. miasto, kod pocztowy, hrabstwo, stan itp.

Pola
Pole unii region. Określa region geograficzny. Możesz określić tylko jeden typ regionu (np. miejsce). region może być tylko jednym z tych elementów:
place

string

Unikalny identyfikator konkretnego regionu geograficznego.

OperatingStatus

Stan działania miejsca.

Wartości w polu enum
OPERATING_STATUS_UNSPECIFIED Nie określono. Nie należy używać tej wartości.
OPERATING_STATUS_OPERATIONAL Miejsce jest czynne i otwarte w określonych godzinach.
OPERATING_STATUS_PERMANENTLY_CLOSED Miejsce nie działa już.
OPERATING_STATUS_TEMPORARILY_CLOSED Miejsce jest tymczasowo zamknięte i spodziewamy się, że zostanie ponownie otwarte w przyszłości.

PlaceInsight

Zawiera informacje o miejscu

Pola
place

string

Unikalny identyfikator miejsca. Za pomocą tego identyfikatora zasobu możesz pobierać szczegóły dotyczące miejsca za pomocą interfejsu Places API.

PriceLevel

Poziom cen w danym miejscu.

Wartości w polu enum
PRICE_LEVEL_UNSPECIFIED Nie określono. Nie należy używać tej wartości.
PRICE_LEVEL_FREE Miejsce oferuje bezpłatne usługi.
PRICE_LEVEL_INEXPENSIVE Miejsce oferuje niedrogie usługi.
PRICE_LEVEL_MODERATE Miejsce oferuje usługi w rozsądnych cenach.
PRICE_LEVEL_EXPENSIVE Miejsce oferuje drogie usługi.
PRICE_LEVEL_VERY_EXPENSIVE Miejsce oferuje bardzo drogie usługi.

RatingFilter

Filtry średniej oceny użytkowników.

Pola
min_rating

float

Opcjonalnie: Ogranicza wyniki do miejsc, których średnia ocena użytkowników jest większa lub równa min_rating. Wartości muszą się mieścić w przedziale od 1,0 do 5,0.
max_rating

float

Opcjonalnie: Ogranicza wyniki do miejsc, których średnia ocena użytkowników jest mniejsza lub równa wartości max_rating. Wartości muszą się mieścić w przedziale od 1,0 do 5,0.

TypeFilter

Filtry typu miejsca.

Obsługiwane są tylko typy miejsc z tabeli a.

Z miejscem może być powiązany tylko jeden podstawowy typ. Na przykład główny typ może być „mexican_restaurant” lub „steak_house”. Użyj atrybutów included_primary_types i excluded_primary_types, aby filtrować wyniki według głównego typu miejsca.

Z miejscem może być też powiązanych wiele wartości typu. Na przykład restauracja może mieć te typy: „seafood_restaurant”, „restaurant”, „food”, „point_of_interest”, „establishment”. Użyj atrybutów included_types i excluded_types, aby filtrować wyniki na liście typów powiązanych z miejscem.

Jeśli wyszukiwanie jest określone z wieloma ograniczeniami typu, zwracane są tylko miejsca, które spełniają wszystkie ograniczenia. Jeśli na przykład podasz {"included_types": ["restaurant"], "excluded_primary_types": ["steak_house"]}, zwrócone miejsca oferują usługi związane z „restauracją”, ale nie działają głównie jako „steak_house”.

Jeśli występują jakieś sprzeczne typy, np. typ występuje zarówno w typach included_types i excluded_types, jak i w typach included_primary_types i excluded_primary_types, zwracany jest błąd INVALID_ARGUMENT.

Musisz ustawić jeden z parametrów included_types lub included_primary_types.

Pola
included_types[]

string

Opcjonalnie: Uwzględnione typy miejsc.
excluded_types[]

string

Opcjonalnie: Wykluczone typy miejsc.
included_primary_types[]

string

Opcjonalnie: Uwzględnione podstawowe typy miejsc
excluded_primary_types[]

string

Opcjonalnie: Wykluczone podstawowe typy miejsc