Package google.maps.areainsights.v1

Index

AreaInsights

Dienstdefinition für den Places Aggregate RPC.

ComputeInsights

rpc ComputeInsights(ComputeInsightsRequest) returns (ComputeInsightsResponse)

Mit dieser Methode können Sie Statistiken zu Gebieten mithilfe verschiedener Filter abrufen, z. B. nach Gebiet, Ortstyp, Betriebsstatus, Preisniveau und Bewertungen. Derzeit werden die Statistiken „Anzahl“ und „Orte“ unterstützt. Mithilfe von Statistiken vom Typ „Anzahl“ können Sie Fragen wie „Wie viele Restaurants gibt es in Kalifornien, die geöffnet sind, preiswert sind und eine durchschnittliche Bewertung von mindestens 4 Sternen haben?“ beantworten. Weitere Informationen finden Sie unter insight enum. Mithilfe der Daten zu „Orten“ können Sie ermitteln, welche Orte dem angeforderten Filter entsprechen. Mit diesen Ortsressourcennamen können Kunden dann über die Places API weitere Details zu den einzelnen Orten abrufen.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

ComputeInsightsRequest

Anfrage für den ComputeInsights-RPC.

Felder
insights[]

Insight

Erforderlich. Zu berechnende Statistiken Derzeit werden nur INSIGHT_COUNT und INSIGHT_PLACES unterstützt.
filter

Filter

Erforderlich. Statistikfilter

ComputeInsightsResponse

Antwort für die ComputeInsights-RPC.

Felder
place_insights[]

PlaceInsight

Ergebnis für „Insights.INSIGHT_PLACES“
count

int64

Ergebnis für „Statistiken.INSIGHT_COUNT“.

Filter

Filter für die ComputeInsights-RPC.

Felder
location_filter

LocationFilter

Erforderlich. Die Ergebnisse werden auf Orte im durch die Standortfilter angegebenen Gebiet beschränkt.
type_filter

TypeFilter

Erforderlich. Ortstypfilter
operating_status[]

OperatingStatus

Optional. Die Ergebnisse werden auf Orte beschränkt, deren Betriebsstatus in dieser Liste enthalten ist. Wenn „operating_status“ nicht festgelegt ist, wird „OPERATING_STATUS_OPERATIONAL“ als Standard verwendet.
price_levels[]

PriceLevel

Optional. Die Ergebnisse werden auf Orte beschränkt, deren Preisniveau in dieser Liste enthalten ist. Wenn price_levels nicht festgelegt ist, werden alle Preisstufen in die Ergebnisse einbezogen.
rating_filter

RatingFilter

Optional. Die Ergebnisse werden auf Orte beschränkt, deren durchschnittliche Nutzerbewertungen im durch „rating_filter“ angegebenen Bereich liegen. Wenn „rating_filter“ nicht festgelegt ist, werden alle Bewertungen in das Ergebnis eingeschlossen.

Insight

Verfügbare Daten

Enums
INSIGHT_UNSPECIFIED Nicht angegeben.
INSIGHT_COUNT

Statistik „Zählen“

Wenn diese Statistik angegeben ist, gibt ComputeInsights die Anzahl der Orte zurück, die den angegebenen Filterkriterien entsprechen.

Beispielanfrage:

{
  "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
    }
  }
}

Beispielantwort:

{
  "count": 1234
}
INSIGHT_PLACES

Rückgabeorte

Wenn diese Statistik angegeben ist, gibt ComputeInsights Orts-IDs zurück, die den angegebenen Filterkriterien entsprechen.

Beispielanfrage:

{
  "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
    }
  }
}

Beispielantwort:

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

LocationFilter

Standortfilter

Gibt den Bereich an, der für die Erkenntnis von Interesse ist.

Felder
Union-Feld area. Eine der folgenden Optionen muss angegeben werden. Für area ist nur einer der folgenden Werte zulässig:
circle

Circle

Fläche als Kreis
region

Region

Gebiet als Region
custom_area

CustomArea

Benutzerdefinierter Bereich, der durch ein Polygon festgelegt ist.

Kreis

Ein Kreis wird durch einen Mittelpunkt und einen Radius in Metern definiert.

Felder
radius

int32

Optional. Der Radius des Kreises in Metern
Union-Feld center. Der Mittelpunkt des Kreises. Für center ist nur einer der folgenden Werte zulässig:
lat_lng

LatLng

Breiten- und Längengrad des Mittelpunkts des Kreises.
place

string

Format:Muss das Format places/PLACE_ID haben, wobei PLACE_ID die eindeutige Kennung eines Orts ist. Beispiel: places/ChIJgUbEo8cfqokR5lP9_Wh_DaM.

CustomArea

Benutzerdefiniertes Gebiet

Felder
polygon

Polygon

Erforderlich. Der benutzerdefinierte Bereich als Polygon

Polygon

Ein Polygon wird durch eine Reihe verbundener Koordinaten in einer gegen den Uhrzeigersinn geordneten Reihenfolge dargestellt. Die Koordinaten bilden einen geschlossenen Kreis und definieren einen ausgefüllten Bereich. Die erste und die letzte Koordinate sind gleichwertig und müssen identische Werte enthalten. Das Format ist eine vereinfachte Version von GeoJSON-Polygonen. Wir unterstützen nur einen Außenring gegen den Uhrzeigersinn.

Felder
coordinates[]

LatLng

Optional. Die Koordinaten, die das Polygon definieren.

Region

Eine Region ist eine geografische Grenze wie Städte, Postleitzahlen, Landkreise oder Bundesländer.

Felder
Union-Feld region. Definiert eine geografische Region. Es kann jeweils nur ein Regionstyp (z.B. Ort) angegeben werden. Für region ist nur einer der folgenden Werte zulässig:
place

string

Die eindeutige Kennung einer bestimmten Region.

OperatingStatus

Öffnungsstatus des Orts.

Enums
OPERATING_STATUS_UNSPECIFIED Nicht angegeben. Dieser Wert sollte nicht verwendet werden.
OPERATING_STATUS_OPERATIONAL Der Ort ist in Betrieb und zu den angegebenen Zeiten geöffnet.
OPERATING_STATUS_PERMANENTLY_CLOSED Das Unternehmen ist nicht mehr in Betrieb.
OPERATING_STATUS_TEMPORARILY_CLOSED Der Ort ist vorübergehend geschlossen und wird voraussichtlich in Zukunft wiedereröffnet.

PlaceInsight

Enthält Informationen zu einem Ort

Felder
place

string

Die eindeutige Kennung des Orts. Mit diesem Ressourcennamen können Sie mit der Places API Details zum Ort abrufen.

PriceLevel

Preisniveau des Orts.

Enums
PRICE_LEVEL_UNSPECIFIED Nicht angegeben. Dieser Wert sollte nicht verwendet werden.
PRICE_LEVEL_FREE Der Ort bietet kostenlose Dienstleistungen an.
PRICE_LEVEL_INEXPENSIVE Der Ort bietet günstige Dienstleistungen an.
PRICE_LEVEL_MODERATE Der Ort bietet Dienstleistungen zu günstigen Preisen an.
PRICE_LEVEL_EXPENSIVE Der Ort bietet teure Dienstleistungen an.
PRICE_LEVEL_VERY_EXPENSIVE Der Ort bietet sehr teure Dienstleistungen an.

RatingFilter

Filter für die durchschnittliche Nutzerbewertung

Felder
min_rating

float

Optional. Die Ergebnisse werden auf Orte mit einer durchschnittlichen Nutzerbewertung beschränkt, die mindestens „min_rating“ entspricht. Die Werte müssen zwischen 1,0 und 5,0 liegen.
max_rating

float

Optional. Die Ergebnisse werden auf Orte beschränkt, deren durchschnittliche Nutzerbewertung kleiner oder gleich max_rating ist. Die Werte müssen zwischen 1,0 und 5,0 liegen.

TypeFilter

Ortstypfilter

Es werden nur Ortstypen aus Tabelle a unterstützt.

Einem Ort kann nur ein primärer Typ zugeordnet werden. Der primäre Typ kann beispielsweise „mexican_restaurant“ oder „steak_house“ sein. Mit den Parametern „included_primary_types“ und „excluded_primary_types“ können Sie die Ergebnisse nach dem primären Typ eines Orts filtern.

Einem Ort können auch mehrere Typwerte zugewiesen sein. Ein Restaurant kann beispielsweise die folgenden Typen haben: „seafood_restaurant“, „restaurant“, „food“, „point_of_interest“ und „establishment“. Mit „included_types“ und „excluded_types“ können Sie die Ergebnisse in der Liste der Typen filtern, die mit einem Ort verknüpft sind.

Wenn für eine Suche mehrere Einschränkungen des Typs angegeben sind, werden nur Orte zurückgegeben, die alle Einschränkungen erfüllen. Wenn Sie beispielsweise {"included_types": ["restaurant"], "excluded_primary_types": ["steak_house"]} angeben, werden Orte zurückgegeben, die Dienstleistungen im Zusammenhang mit „Restaurants“ anbieten, aber nicht in erster Linie als „Steakhaus“ geführt werden.

Wenn es zu Konflikten kommt, d.h. ein Typ sowohl in „included_types“ als auch in „excluded_types“ oder in „included_primary_types“ als auch in „excluded_primary_types“ enthalten ist, wird der Fehler INVALID_ARGUMENT zurückgegeben.

Es muss eine der Optionen „included_types“ oder „included_primary_types“ festgelegt werden.

Felder
included_types[]

string

Optional. Eingeschlossene Ortstypen
excluded_types[]

string

Optional. Ausgeschlossene Ortstypen
included_primary_types[]

string

Optional. Eingeschlossene primäre Ortstypen
excluded_primary_types[]

string

Optional. Ausgeschlossene primäre Ortstypen