Package google.maps.areainsights.v1

Indice

AreaInsights

Definizione del servizio per l'RPC aggregata di Places.

ComputeInsights

rpc ComputeInsights(ComputeInsightsRequest) returns (ComputeInsightsResponse)

Questo metodo ti consente di recuperare informazioni sulle aree utilizzando una serie di filtri, ad esempio area, tipo di luogo, stato di funzionamento, livello di prezzo e valutazioni. Al momento sono supportati gli approfondimenti "conteggio" e "luoghi". Con gli approfondimenti "conteggio" puoi rispondere a domande come "Quanti ristoranti operativi, economici e con una valutazione media di almeno 4 stelle si trovano in California?" (per maggiori dettagli, consulta l'enum insight). Con gli approfondimenti "Luoghi", puoi determinare quali luoghi corrispondono al filtro richiesto. I client possono quindi utilizzare questi nomi di risorse dei luoghi per recuperare ulteriori dettagli su ogni singolo luogo utilizzando l'API Places.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

ComputeInsightsRequest

Richiesta per l'RPC ComputeInsights.

Campi
insights[]

Insight

Obbligatorio. Approfondimenti da calcolare. Al momento sono supportati solo INSIGHT_COUNT e INSIGHT_PLACES.
filter

Filter

Obbligatorio. Filtro degli approfondimenti.

ComputeInsightsResponse

Risposta per l'RPC ComputeInsights.

Campi
place_insights[]

PlaceInsight

Risultato per Insights.INSIGHT_PLACES.
count

int64

Risultato per Insights.INSIGHT_COUNT.

Filtro

Filtri per l'RPC ComputeInsights.

Campi
location_filter

LocationFilter

Obbligatorio. Consente di limitare i risultati ai luoghi che si trovano nell'area specificata dai filtri posizione.
type_filter

TypeFilter

Obbligatorio. Filtri per tipo di luogo.
operating_status[]

OperatingStatus

Facoltativo. Limita i risultati ai luoghi il cui stato di funzionamento è incluso in questo elenco. Se operating_status non è impostato, per impostazione predefinita viene utilizzato OPERATING_STATUS_OPERATIONAL.
price_levels[]

PriceLevel

Facoltativo. Limita i risultati ai luoghi il cui livello di prezzo è incluso in questo elenco. Se price_levels non è impostato, tutti i livelli di prezzo sono inclusi nei risultati.
rating_filter

RatingFilter

Facoltativo. Limita i risultati ai luoghi le cui valutazioni medie degli utenti rientrano nell'intervallo specificato da rating_filter. Se rating_filter non è impostato, tutte le valutazioni sono incluse nel risultato.

Insight

Approfondimenti supportati.

Enum
INSIGHT_UNSPECIFIED Non specificato.
INSIGHT_COUNT

Approfondimento sul conteggio.

Quando viene specificato questo insight, ComputeInsights restituisce il numero di località che corrispondono ai criteri di filtro specificati.

Esempio di richiesta:

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

Risposta di esempio:

{
  "count": 1234
}
INSIGHT_PLACES

Luoghi di reso

Quando viene specificato questo approfondimento, ComputeInsights restituisce gli ID dei luoghi corrispondenti ai criteri di filtro specificati.

Esempio di richiesta:

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

Risposta di esempio:

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

LocationFilter

Filtri di località.

Specifica l'area di interesse per l'approfondimento.

Campi
Campo unione area. Deve essere specificato uno dei seguenti valori. area può essere solo uno dei seguenti:
circle

Circle

Area come cerchio.
region

Region

Area come regione.
custom_area

CustomArea

Area personalizzata specificata da un poligono.

Cerchio

Un cerchio è definito da un punto centrale e da un raggio in metri.

Campi
radius

int32

Facoltativo. Il raggio del cerchio in metri
Campo unione center. Il centro del cerchio. center può essere solo uno dei seguenti:
lat_lng

LatLng

La latitudine e la longitudine del centro del cerchio.
place

string

Formato: deve essere nel formato places/PLACE_ID, dove PLACE_ID è l'identificatore univoco di un luogo. Ad esempio: places/ChIJgUbEo8cfqokR5lP9_Wh_DaM.

CustomArea

Area personalizzata.

Campi
polygon

Polygon

Obbligatorio. L'area personalizzata rappresentata come un poligono

Poligono

Un poligono è rappresentato da una serie di coordinate collegate in una sequenza ordinata in senso antiorario. Le coordinate formano un anello chiuso e definiscono una regione riempita. Le coordinate prima e ultima sono equivalenti e devono contenere valori identici. Il formato è una versione semplificata dei poligoni GeoJSON (supportiamo solo un anello esterno antiorario).

Campi
coordinates[]

LatLng

Facoltativo. Le coordinate che definiscono il poligono.

Regione

Una regione è un confine geografico, ad esempio città, codici postali, contee, stati e così via.

Campi
Campo unione region. Definisce una regione geografica. È possibile specificare un solo tipo di regione (ad es. luogo) alla volta. region può essere solo uno dei seguenti:
place

string

L'identificatore univoco di una specifica regione geografica.

OperatingStatus

Stato di attività del luogo.

Enum
OPERATING_STATUS_UNSPECIFIED Non specificato. Questo valore non deve essere utilizzato.
OPERATING_STATUS_OPERATIONAL Il luogo è operativo e aperto durante gli orari definiti.
OPERATING_STATUS_PERMANENTLY_CLOSED Il luogo non è più in attività.
OPERATING_STATUS_TEMPORARILY_CLOSED Il luogo è temporaneamente chiuso e dovrebbe riaprire in futuro.

PlaceInsight

Contiene informazioni su un luogo

Campi
place

string

L'identificatore univoco del luogo. Questo nome della risorsa può essere utilizzato per recuperare i dettagli del luogo utilizzando l'API Places.

PriceLevel

Il livello di prezzo del luogo.

Enum
PRICE_LEVEL_UNSPECIFIED Non specificato. Questo valore non deve essere utilizzato.
PRICE_LEVEL_FREE Il luogo offre servizi senza costi.
PRICE_LEVEL_INEXPENSIVE Il luogo offre servizi economici.
PRICE_LEVEL_MODERATE Il luogo offre servizi a prezzi moderati.
PRICE_LEVEL_EXPENSIVE Il luogo offre servizi costosi.
PRICE_LEVEL_VERY_EXPENSIVE Il luogo offre servizi molto costosi.

RatingFilter

Filtri per la valutazione media degli utenti.

Campi
min_rating

float

Facoltativo. Limita i risultati ai luoghi la cui valutazione media degli utenti è maggiore o uguale a min_rating. I valori devono essere compresi tra 1,0 e 5,0.
max_rating

float

Facoltativo. Limita i risultati ai luoghi la cui valutazione media degli utenti è strettamente inferiore o uguale a max_rating. I valori devono essere compresi tra 1,0 e 5,0.

TypeFilter

Filtri per tipo di luogo.

Sono supportati solo i tipi di luogo della Tabella A.

A un luogo può essere associato un solo tipo principale. Ad esempio, il tipo principale potrebbe essere "ristorante_messicano" o "steakhouse". Utilizza included_primary_types ed excluded_primary_types per filtrare i risultati in base al tipo principale di un luogo.

A un luogo possono essere associati anche più valori di tipo. Ad esempio, un ristorante potrebbe avere i seguenti tipi: "seafood_restaurant", "restaurant", "food", "point_of_interest", "establishment". Utilizza included_types ed excluded_types per filtrare i risultati nell'elenco dei tipi associati a un luogo.

Se una ricerca è specificata con più restrizioni di tipo, vengono restituiti solo i luoghi che soddisfano tutte le restrizioni. Ad esempio, se specifichi {"included_types": ["restaurant"], "excluded_primary_types": ["steak_house"]}, i luoghi restituiti forniscono servizi correlati a "ristorante", ma non operano principalmente come "steak_house".

Se sono presenti tipi in conflitto, ovvero un tipo compare sia in included_types che in excluded_types o in included_primary_types ed excluded_primary_types, viene restituito un errore INVALID_ARGUMENT.

Deve essere impostato uno dei valori included_types o included_primary_types.

Campi
included_types[]

string

Facoltativo. Tipi di luoghi inclusi.
excluded_types[]

string

Facoltativo. Tipi di luoghi esclusi.
included_primary_types[]

string

Facoltativo. Tipi di luoghi principali inclusi.
excluded_primary_types[]

string

Facoltativo. Tipi di luoghi principali esclusi.