Panoramica

L'API Places Aggregate è un servizio che fornisce informazioni sui luoghi all'interno di un'area specificata in base a criteri quali posizione, tipo, stato di funzionamento, livello di prezzo e valutazioni degli utenti. Questo servizio può aiutarti ad analizzare la densità di tipi di luoghi specifici intorno a una determinata località e a rispondere a domande come "Quali o quanti ristoranti $$$ con valutazione di 5 stelle si trovano nel raggio di 5 km da questa località?"

I risultati vengono restituiti come conteggi aggregati o come ID luogo identificati nell'area di ricerca di interesse. Gli utenti possono utilizzare l'API Place Details per recuperare maggiori informazioni su questi ID luogo.

Perché utilizzare l'API Places Aggregate

L'API Places Aggregate consente agli utenti di prendere decisioni basate sui dati in base alle informazioni complete che fornisci su vari luoghi. Sfrutta modelli di luoghi accurati e aggiornati, che supportano i seguenti casi d'uso principali:

  • Attività: analizza la concorrenza e le potenziali sedi per nuovi sedi.
  • Sviluppatori: crea applicazioni che forniscono consigli personalizzati.
  • Ricercatori: esaminano tendenze e schemi ricorrenti in aree specifiche.

Cosa puoi fare con l'API Places Aggregate

Con l'API Places Aggregate puoi ottenere le seguenti informazioni:

  • Conteggi: recupera il numero di luoghi che corrispondono ai tuoi criteri.
  • ID luogo: recupera gli ID luogo di luoghi specifici che corrispondono ai tuoi criteri.

Puoi anche utilizzare i filtri per perfezionare la ricerca in base a vari attributi, come tipi di luoghi, orari di apertura, fasce di prezzo e valutazioni dei clienti.

Esempi

Questa sezione descrive un caso d'uso di esempio per l'API Places Aggregate e include il codice funzionante per ogni esempio.

Apertura di un nuovo bar

Il proprietario di un ristorante vuole aprire un nuovo bar. Per farlo, vuole prima visualizzare i punti di ritrovo dei caffè in modo da identificare le aree di alta e bassa concentrazione per prendere una decisione in merito alla sua attività. L'API Places Aggregate può aiutarti ad analizzare il numero di bar all'interno di un raggio specifico in base ad attributi come lo stato di funzionamento, i livelli di prezzo e le valutazioni dei clienti per prendere una decisione basata sui dati su dove aprire la prossima sede.

Visualizza Sample

Una mappa di San Francisco e i punteggi relativi ai servizi di intrattenimento per codice postale.

Società di investimento immobiliare

Una società di investimento immobiliare vuole migliorare i propri modelli finanziari e determinare con precisione il ROI sugli investimenti immobiliari pianificati. Utilizzando l'API Places Aggregate, possono raccogliere dati dettagliati sui servizi nelle vicinanze di potenziali proprietà da investire, come bancomat, ospedali, stazioni di trasporto pubblico e supermercati, in modo da comprendere i servizi nelle vicinanze di potenziali proprietà da investire.

Servizio di consegna al dettaglio

Quando si espande in una nuova città, un servizio di consegna al dettaglio deve determinare il numero di corrieri da allocare a una regione in base alla densità delle destinazioni più frequentate dai consumatori, come ristoranti, minimarket e negozi di liquori. Tramite l'API, il servizio di consegna conteggia il numero totale di questi stabilimenti in tutta la città per poter pianificare e allocare le risorse in modo efficace.

Visualizza Sample

Una mappa di calore dei ristoranti per volume a Mountain View.

Come funziona l'API Places Aggregate

L'API Places Aggregate ti consente di specificare filtri per restringere i criteri di ricerca. Dopo aver selezionato un tipo di informazione INSIGHT_COUNT o INSIGHT_PLACES, puoi aggiungere criteri di filtro, tra cui:

  • Posizione: definisci l'area di interesse utilizzando cerchi, regioni o poligoni personalizzati.
  • Tipo: specifica i tipi di luoghi che ti interessano.
  • Stato delle operazioni: filtra i luoghi in base al loro stato di operatività.
  • Livelli di prezzo: filtra i luoghi in base ai livelli di prezzo.
  • Valutazioni: filtra i luoghi in base alle valutazioni degli utenti.

L'oggetto ComputeInsightsResponse della risposta dell'API contiene i risultati dell'analisi della richiesta. Ad esempio, se hai selezionato INSIGHT_COUNT, la risposta contiene un numero totale di luoghi, mentre se hai selezionato INSIGHT_PLACES, la risposta contiene un elenco di ID luogo.

Come utilizzare l'API Places Aggregate

1 Esegui la configurazione. Inizia con Configurare il progetto Google Cloud e completa le istruzioni che seguono.
2 Invia una richiesta per ottenere il conteggio dei luoghi corrispondenti. Consulta Effettuare la prima richiesta.
3 Scopri di più sui parametri di richiesta. Consulta Parametri di richiesta.

Passaggi successivi