Panoramica

L'API Places Aggregate è un servizio che fornisce approfondimenti sui luoghi all'interno di un'area specificata in base a criteri quali posizione, tipo, stato operativo, livello di prezzo e valutazioni degli utenti. Questo servizio può aiutarti ad analizzare la densità di tipi di luoghi specifici intorno a una determinata posizione e rispondere a domande come "Quanti ristoranti con 5 stelle e tre simboli del dollaro si trovano in un raggio di 5 km da questa posizione?"

I risultati vengono restituiti come conteggi aggregati o come ID luogo identificati nell'area di interesse della ricerca. 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 chiave:

  • Attività: analizza la concorrenza e le potenziali sedi per nuove filiali.
  • Sviluppatori: crea applicazioni che forniscono consigli personalizzati.
  • Ricercatori: esaminano tendenze e modelli 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, livelli 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, vogliono prima visualizzare dove si trovano i punti di interesse dei caffè per identificare le aree di alta e bassa concentrazione e prendere una decisione aziendale. L'API Places Aggregate può aiutarti ad analizzare il numero di bar entro un raggio specifico in base ad attributi come lo stato di attività, i livelli di prezzo e le valutazioni dei clienti per prendere una decisione basata sui dati su dove aprire la prossima sede.

Visualizza l'esempio

Una mappa di San Francisco e i punteggi 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 degli investimenti immobiliari pianificati. Utilizzando l'API Places Aggregate, possono raccogliere dati dettagliati sui servizi nelle vicinanze di potenziali immobili di investimento, come bancomat, ospedali, stazioni di transito e negozi di alimentari, in modo da comprendere i servizi nelle vicinanze di potenziali immobili di investimento.

Servizio di consegna al dettaglio

Quando si espande in una nuova città, un servizio di consegna al dettaglio deve determinare il numero di autisti addetti alle consegne da assegnare a una regione in base alla densità di destinazioni di consumo popolari, come ristoranti, minimarket e negozi di liquori. Utilizzando l'API, il servizio di consegna conta il numero totale di questi stabilimenti in tutta la città in modo da poter pianificare e allocare le risorse in modo efficace.

Visualizza l'esempio

Una mappa termica 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 insight di 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 operativo.
  • 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'approfondimento 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 Inizia la configurazione. Inizia con Configurare il progetto Google Cloud e completa le istruzioni riportate di seguito.
2 Invia una richiesta per ottenere il conteggio dei luoghi corrispondenti. Consulta Effettuare la tua prima richiesta.
3 Scopri di più sui parametri di richiesta. Consulta Parametri della richiesta.

Passaggi successivi