L'API Places Aggregate è un servizio che fornisce approfondimenti sui luoghi all'interno di un'area specificata in base a criteri quali località, tipo, stato di attività, livello di prezzo e valutazioni degli utenti. Questo servizio può aiutarti ad analizzare la densità di tipi di luoghi specifici in una determinata località e a rispondere a domande come "Quali o quanti ristoranti con 5 stelle e $$$ si trovano in un 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 ulteriori 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. Utilizza modelli di luoghi accurati e aggiornati e supporta i seguenti casi d'uso principali:
- Attività: analizza la concorrenza e le potenziali sedi per nuove filiali.
- Sviluppatori: crea applicazioni che forniscono consigli personalizzati.
- Ricercatori: esamina le tendenze e i pattern 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, vuole prima visualizzare i punti di interesse dei bar in modo da poter identificare le aree di alta e bassa concentrazione per prendere una decisione aziendale. L'API Places Aggregate può aiutarti ad analizzare il numero di bar in un raggio specifico in base ad attributi come stato operativo, livelli di prezzo e valutazioni dei clienti per prendere una decisione basata sui dati su dove aprire la prossima sede.
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, può 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 corrieri da assegnare a una regione in base alla densità delle destinazioni dei consumatori più richieste, come ristoranti, minimarket e negozi di liquori. Utilizzando l'API, il servizio di consegna conta il numero totale di questi esercizi in tutta la città in modo da poter pianificare e allocare le risorse in modo efficace.
Come funziona l'API Places Aggregate
L'API Places Aggregate consente di specificare i filtri per restringere i criteri di ricerca.
Dopo aver selezionato un tipo di approfondimento INSIGHT_COUNT o INSIGHT_PLACES, puoi aggiungere criteri di filtro, tra cui:
- Località: definisci l'area di interesse utilizzando cerchi, regioni o poligoni personalizzati.
- Tipo: specifica i tipi di luoghi che ti interessano.
- Stato operativo: 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 della risposta API ComputeInsightsResponse contiene i risultati di
l'approfondimento della richiesta. Ad esempio, se hai selezionato INSIGHT_COUNT, la risposta contiene il 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 Configura il progetto Google Cloud e completa le istruzioni riportate di seguito. |
| 2 | Effettua una richiesta per ottenere il conteggio dei luoghi corrispondenti. | Consulta Effettua la tua prima richiesta. |
| 3 | Scopri di più sui parametri della richiesta. | Consulta Parametri della richiesta. |
Passaggi successivi
- Esamina i prezzi e i limiti di utilizzo
- Visualizza il riferimento API
- Leggi le domande frequenti
- Esamina le opzioni di assistenza