Documentazione

Come funziona PlaceGrid

Regioni e tipi di luogo, la ricerca di prova gratuita, filtri, arricchimento, risultati, esportazione e prezzi: tutto il prodotto in una pagina, anche in Markdown per la tua IA.

Inizia ora Markdown pulito per agenti IA

I luoghi di Google Maps di qualsiasi regione, con i contatti pubblicati sui loro siti: trovati, filtrati, arricchiti ed esportati in un’unica web app.

PlaceGrid trova tutte le attività dei tipi che scegli all’interno di confini di regione presi dalla mappa, ti dice quante sono e quanto costeranno prima di addebitare qualsiasi cosa, e aggiunge a ogni luogo ciò che chiedi: la scheda completa di Google, i contatti dal suo sito, recensioni, foto, un controllo del suo sito. Lavori con il risultato come tabella, come mappa e come scheda per ogni luogo, e lo esporti.

Concetti

Progetto: un’attività di lavoro con le sue regioni, i tipi di luogo, la lingua di ricerca, i filtri, l’arricchimento e tutte le ricerche fatte per essa. Un progetto conserva i suoi risultati, così una ricerca successiva mostra cosa è cambiato.
Regione: un’area presa dai confini della mappa, cioè un paese, una regione, una città o un quartiere. Una regione che selezioni copre tutto ciò che contiene. I luoghi fuori dalle tue regioni non vengono mai mostrati né addebitati.
Tipo di luogo: il tipo di attività da cercare (dentista, caffè, hotel…), scelto da un elenco di tipi comuni o scritto con parole tue. Scegli anche la lingua in cui risponde Google Maps.
Ricerca di prova: un campione gratuito della ricerca. Mostra quanti luoghi ci sono, cosa aggiunge ogni tipo di luogo, quanto costerà la ricerca completa e quanto durerà, e fornisce un campione di luoghi su cui provare i filtri.
Filtri di ricerca: decidono quali luoghi una ricerca paga e arricchisce.
Arricchimento: ciò che viene aggiunto a ogni luogo che supera i filtri. Ogni tipo ha il suo prezzo per risultato.
Ricerca: la raccolta completa. Copre ogni regione cella per cella, quindi non si ferma ai primi cento risultati che restituisce una ricerca sulla mappa.
Risultati: i luoghi che la ricerca ha trovato e che hai pagato.
Crediti: l’unità in cui è prezzato il lavoro. Un credito vale 0,001 €. Un nuovo account parte con 1.000 crediti gratuiti; gli altri si acquistano in pacchetti, con carta (vedi Prezzi).
Organizzazione: un account che paga il lavoro dei suoi membri con i propri crediti (vedi Limiti e controllo).

Le fasi di un progetto

L’app accompagna un progetto attraverso otto fasi, elencate accanto a un assistente IA. Puoi tornare a ognuna in qualsiasi momento.

L’app funziona anche nel browser del telefono: tutte le fasi, i risultati (come schede), l’esportazione e l’acquisto di crediti. La sua interfaccia è disponibile in inglese e in altre lingue europee; scegli la tua nella pagina dell’account.

Progetto: dagli un nome e spiega in una frase a cosa serve; l’assistente lo usa per suggerire regioni e tipi di luogo.
Regioni: seleziona paesi, regioni, città o quartieri in un albero, cercali per nome e vedili sulla mappa.
Tipi di luogo: cosa cercare, e la lingua di ricerca.
Ricerca di prova: gratuita. La stima arriva con un intervallo, il costo e il tempo, e quanti luoghi trova ogni tipo di luogo che nessun altro trova. Quando i luoghi trovati hanno spesso altre categorie di Google, queste vengono proposte come tipi di luogo aggiuntivi.
Filtri: tieni solo i luoghi che ti servono. Si filtra per stato dell’attività, categorie, parole nel nome, sito web, telefono, prenotazione online, profilo rivendicato, valutazione, numero di recensioni, servizi. Ogni modifica viene conteggiata subito sul campione della prova: quanti luoghi restano e quanti ne esclude ogni filtro da solo.
Arricchimento: scegli i tipi (e, per i contatti, la profondità); per recensioni e foto, quante per luogo. Ogni tipo mostra il suo costo e il suo tempo.
Ricerca: scegli un limite di spesa o nessuno, e avviala. I luoghi trovati, i crediti spesi e il tempo rimanente sono mostrati in diretta. Dopo una modifica delle impostazioni, questa fase dice quale lavoro richiede la modifica (un supplemento sul risultato che hai o una nuova ricerca) e quanto costa.
Risultati: la tabella, la mappa, una scheda per luogo, filtri, colonne ed esportazione.

Cosa include ogni luogo

Campo	Significato
Nome, categorie	Come le mostra la scheda
Indirizzo, città, paese, coordinate, fuso orario	Posizione
Telefono, sito web	Contatti della scheda
Valutazione, numero di recensioni	Valutazione attuale e numero di recensioni
Stato dell’attività	Aperta, chiusa temporaneamente o definitivamente
Profilo rivendicato, link di prenotazione, area servita	Se il titolare gestisce la scheda, se rimanda a prenotazioni o ordini online, se serve un’area senza una sede aperta al pubblico
Servizi	Quelli elencati nella risposta di ricerca di Google, di solito solo quelli di accessibilità; la Scheda del luogo li porta tutti
Place ID, CID, link a Google Maps	Identificatori stabili

Gli orari settimanali, la descrizione e il menu sono nella scheda completa del luogo: vedi Scheda del luogo più sotto.

Arricchimento

Scheda del luogo

La scheda completa del luogo, oltre a ciò che restituisce una ricerca: tutte le categorie, la descrizione, gli orari di apertura, il menu o l’elenco dei servizi (con i prezzi, se l’attività li indica), i post del titolare, gli orari di punta, le valutazioni per stelle, tutti i servizi elencati da Google, i link di prenotazione e di ordine, e se il profilo è rivendicato.

Contatti dal sito

Il sito web indicato nella scheda del luogo viene letto per trovare i contatti: la home page, poi le pagine contatti, note legali e «chi siamo». Restituisce:

email, ognuna con il suo tipo quando l’indirizzo lo indica in modo affidabile e senza tipo quando non lo indica. I tipi sono: generale (info@, office@…), personale, un reparto (vendite, ordini, contabilità…) o una filiale;
altri telefoni, profili social e link di prenotazione trovati sul sito;
dove è stato trovato ogni contatto: la pagina, e se si trattava di un link, del testo della pagina, del codice del sito o dell’IA;
dove porta davvero il sito: un profilo social, un sistema di prenotazione, una scheda in una directory o un nuovo sito della stessa attività. Una directory o il sito di un’altra attività non vengono letti per i contatti.

Quattro profondità, ognuna con il suo prezzo:

Profondità	Cosa legge
Standard	Le pagine così come le serve il sito
JavaScript	Le stesse pagine, visualizzate prima in un browser: trova contatti sui siti costruiti con script
Ricerca IA	Pagine visualizzate lette da un agente IA, che individua i contatti e sceglie le pagine successive da aprire
IA + social	L’agente può aprire anche i profili dell’attività sui social network, con un budget fisso per luogo; quando il sito indicato da Google Maps è esso stesso un profilo, parte da lì. Leggere una pagina Facebook o Instagram collegata dal sito di solito costa più di quanto quel budget consenta

Le email non sono su Google Maps: vengono dal sito dell’attività e si trovano per circa il 40–45% dei luoghi che ne hanno uno, a seconda del settore. Un luogo si paga solo quando viene trovata un’email o un profilo social.

Recensioni

Dalle più recenti, fino al numero che imposti per luogo: testo, voto e data di ogni recensione, e la risposta del titolare. Arrivano anche gli argomenti delle recensioni di Google.

Foto

Fino al numero che imposti per luogo, nell’ordine in cui le mostra la galleria di Google, con il conteggio della galleria e le sue schede, così sai se il titolare ha pubblicato foto e se ci sono foto del menu o video.

Controllo del sito

Uno sguardo al sito di ogni luogo:

il suo stato: funziona; funziona a un nuovo indirizzo; funziona ma è chiuso ai robot; risponde con un errore; non risponde; dominio inesistente; parcheggiato o in vendita; sito di un’altra attività; nessun sito proprio (una pagina social o di prenotazione); non è un indirizzo web;
HTTPS: valido, catena incompleta, scaduto, non ancora valido, per un altro indirizzo, autofirmato, non attendibile o assente; quando scade il certificato; se http porta a https;
cosa usa: il CMS e la sua versione, i pixel pubblicitari (Meta Pixel, Google Ads, TikTok, LinkedIn, Pinterest, Snapchat, Microsoft, X, Reddit), gli strumenti di analytics e i tag manager, i sistemi di prenotazione.

Ogni verdetto è la risposta e si paga, anche quello di un sito che non funziona: è ciò che il controllo trova.

Presente, assente, sconosciuto

Ogni campo facoltativo si trova in uno di tre stati, e l’app dice quale:

presente: il valore è stato trovato;
assente: è stato cercato e non esiste (per esempio, la scheda non ha un sito web);
sconosciuto: non è stato verificato, o la verifica non è riuscita.

«Nessun sito» e «non verificato» sono risposte diverse, e una lista di lead costruita sulla prima non è uguale a una costruita sulla seconda. Quando la fonte del luogo stesso non funziona (un dominio che non esiste, un sito che non risponde, un luogo sparito da Google), l’app lo dice e non addebita nulla, e lo tiene distinto da un errore da parte nostra, che viene ritentato.

Lavorare con i risultati

La tabella: scegli tra circa 80 colonne, mettile nell’ordine che vuoi, imposta la loro larghezza e ordina in base a esse. La mappa mostra gli stessi luoghi; un clic apre la scheda del luogo, organizzata come su Google Maps: panoramica, menu e servizi, recensioni (cercale, filtrale per voto), foto. Sul telefono i luoghi sono schede.
Filtri dei risultati: restringi ciò che vedi in base a qualsiasi dato raccolto, come un’email personale sul dominio del sito, profili social sui network scelti, un menu con prezzi, aperto nel fine settimana o fino a tardi, una recensione da 1–2★ a cui il titolare non ha risposto, una valutazione che resta indietro rispetto alle recensioni, parole citate nelle recensioni, lo stato del sito, il certificato, il CMS o i pixel, la città. Sono gratuiti e non cambiano nulla di ciò che hai pagato.
Le tue colonne: una colonna di testo o un elenco di valori tuoi (con colori e un valore predefinito), compilata direttamente nella tabella, nella scheda del luogo o per molti luoghi insieme. Puoi filtrare e ordinare in base a esse; finiscono nell’esportazione.
Colonne IA: scrivi un compito («Curano i bambini?») e un agente IA compila la colonna per ogni luogo con un valore del tuo elenco, un modello compilato o testo libero. Scegli tu cosa mostrare all’agente, cosa può usare (solo i campi del luogo, il suo sito, il web o una ricerca sul web) e quante chiamate può fare. Ogni cella conserva la motivazione dell’agente e le pagine che ha letto.
Preset: salva le colonne, la loro larghezza e il loro ordine e i filtri come un insieme per un’attività (una lista di chiamate, una lista per mailing), per tutti i tuoi progetti o per uno solo, e applicalo con un clic.
Arricchire i risultati: aggiungi arricchimento ai luoghi elencati nella tabella, senza una nuova ricerca.
Cronologia e confronto: ogni ricerca viene conservata. Riapri una ricerca precedente com’era, o confrontane due per vedere cosa è nuovo, cosa è cambiato (e quali campi), cosa è sparito.

Ripetere la ricerca

Aggiungere tipi di luogo o regioni: il risultato viene ampliato. Si cerca solo ciò che è nuovo, e i luoghi già pagati non si pagano di nuovo.
Toglierne alcuni: il risultato viene ristretto, gratis.
Cercare di nuovo un tipo: i suoi luoghi vengono ritrovati e pagati di nuovo; per ogni tipo di arricchimento scegli solo i luoghi nuovi, i luoghi nuovi e modificati, o di nuovo tutti i luoghi.
Una ricerca fermata dal suo limite: continuala da dove si è fermata.
Filtri più ampi dopo una ricerca: i luoghi trovati ma non pagati vengono proposti come supplemento, con il prezzo calcolato sui luoghi effettivi.
Un tipo di arricchimento attivato dopo una ricerca: un supplemento lo aggiunge ai luoghi che hai, senza cercare di nuovo.

Esportazione

XLSX, CSV, HTML, JSON, XML o Parquet: i luoghi, le colonne e l’ordine che mostra la tabella, con i suoi filtri. I formati per fogli di calcolo e pagine usano i nomi delle colonne nella lingua della tua interfaccia; i formati di dati usano chiavi stabili e valori tipizzati (numeri, timestamp, elenchi, record come le voci del menu o le recensioni).

Prezzi

I prezzi sono in crediti; un credito vale 0,001 €, quindi ogni prezzo qui sotto è in euro ogni 1.000. Ogni ricerca mostra il suo costo prima di partire.

Cosa	Paghi per	Ogni 1.000
Ricerca di prova		gratis
Luoghi	ogni luogo distinto trovato all’interno delle tue regioni	1,00 €
Scheda del luogo	ogni luogo	1,00 €
Contatti dal sito: standard	ogni luogo in cui viene trovata un’email o un profilo social	0,75 €
Contatti dal sito: JavaScript	lo stesso	4,25 €
Contatti dal sito: ricerca IA	lo stesso	17,50 €
Contatti dal sito: IA + social	lo stesso	20,00 €
Recensioni	ogni recensione raccolta	0,50 €
Foto	ogni foto raccolta	0,50 €
Controllo del sito	ogni luogo con un sito web	2,25 €
Colonne IA	i token del modello e le pagine che legge, ai prezzi indicati nell’app	a consumo
Assistente		gratis

Esempio: 1.000 dentisti in una regione, con contatti standard trovati per 430 di loro, costano 1,00 € + 0,32 € = 1,32 €.

Le regole:

La ricerca di prova è gratuita, e lo è anche vedere quanti luoghi tengono i tuoi filtri.
Duplicati, luoghi fuori dalle tue regioni e richieste non riuscite non si pagano.
I contatti si pagano solo se viene trovata un’email o un profilo social: un sito che non si può leggere non costa nulla.
Un luogo già pagato non si paga di nuovo quando aggiungi tipi di luogo o regioni, o quando continui una ricerca.
Una ricerca paga almeno il 10% dei luoghi che trova nelle tue regioni, per quanto pochi ne tengano i filtri, e se ne tiene conto quando in seguito allarghi i filtri.
Restringere i risultati, le tue colonne, i preset e l’esportazione non costano nulla.

Acquistare crediti

A consumo: non c’è abbonamento e niente si rinnova.

1.000 crediti gratuiti con ogni nuovo account: circa 1 € di lavoro, per provare una ricerca sulle tue regioni.
Pacchetti: i crediti si acquistano in pacchetti, da 10 € per 10.000 crediti; i pacchetti più grandi aggiungono fino al 15% di crediti in più. I pacchetti disponibili e i loro prezzi vengono mostrati prima del pagamento.
Pagamento: con carta, sulla pagina di pagamento di Stripe; non vediamo mai il numero della tua carta. I prezzi sono in euro. Ogni pagamento è accompagnato dalla ricevuta di Stripe.
Subito: i crediti vengono aggiunti non appena il pagamento va a buon fine. Al pagamento chiedi che siano resi disponibili subito e prendi atto che, se acquisti come consumatore, il tuo diritto di recesso di 14 giorni termina in quel momento.
Validi 365 giorni: i crediti, gratuiti o acquistati, sono validi 365 giorni dal giorno in cui vengono aggiunti; quelli che scadono prima si spendono per primi. I crediti non usati entro quella data scadono.
Rimborsi: i pagamenti non vengono rimborsati, salvo dove la legge lo richiede. Se un pagamento viene rimborsato o contestato con un chargeback, i crediti che aveva aggiunto vengono ritirati; se alcuni erano già stati spesi, il tuo saldo scende sotto zero e nessun nuovo lavoro a pagamento può partire finché un acquisto non lo riporta in pari.

Le condizioni complete sono nei Termini di servizio.

Limiti e controllo

Un limite di spesa per ogni ricerca, o nessuno. Senza limite, la ricerca prosegue finché il saldo e il limite mensile lo consentono; con un limite, non spende mai di più, e puoi alzarlo mentre la ricerca è in corso. In entrambi i casi si ferma quando finiscono i soldi, e tiene ciò che ha trovato.
Un limite mensile per l’intero account, nella pagina dell’account.
Organizzazioni: un account può diventare un’organizzazione e invitare colleghi via email dopo aver acquistato crediti. Paga il lavoro dei membri con i propri crediti, decide per ogni membro se può spenderli e può impostare un limite mensile. Vede quanto ha speso ciascuno questo mese, ma mai i suoi progetti o risultati. I crediti personali di un membro restano congelati finché non lascia l’organizzazione.
La pagina Consumi elenca ogni credito speso per giorno, per tipo di lavoro, per progetto e per ricerca, e i crediti aggiunti, un mese alla volta.

L’assistente

Accanto a ogni fase c’è un assistente IA. Propone regioni e tipi di luogo a partire dal nome e dalle note del progetto, e li imposta per te; modifica i filtri, l’arricchimento e i filtri dei risultati, compila le tue colonne e configura le colonne IA, mostrando ogni modifica come una scheda con un link per vederla; conta i luoghi sulla ricerca di prova e sui risultati senza spendere nulla, e risponde alle domande sul progetto e sull’app. Non avvia mai una ricerca e non spende crediti. È gratuito.

API

Un’API pubblica per il tuo codice è in arrivo. Finché non sarà pronta, tutto si fa nella web app; se ti serve un accesso programmatico, scrivici.

Supporto

Dopo l’accesso, apri Supporto nella barra in alto dell’app: le tue richieste e le nostre risposte restano lì, e arrivano anche via email una volta confermato il tuo indirizzo. Altrimenti, scrivici dalla pagina dei contatti.