Dokumentácia

Ako funguje PlaceGrid

Celý produkt na jednej stránke: regióny a typy miest, skúšobné vyhľadávanie zadarmo, filtre, obohatenie, výsledky, export a ceny. V čistom Markdowne aj pre vašu AI.

Začať Čistý Markdown pre AI agentov

Miesta z Google Maps pre akýkoľvek región aj s kontaktmi, ktoré zverejňujú ich vlastné weby. Nájdete ich, vyfiltrujete, obohatíte a exportujete v jednej webovej aplikácii.

PlaceGrid nájde všetky firmy zvolených druhov vo vnútri hraníc regiónov prevzatých z mapy, ešte predtým, ako sa čokoľvek zaúčtuje, vám povie, koľko ich je a koľko budú stáť, a ku každému miestu pridá to, o čo požiadate: úplnú kartu miesta na Google, kontakty z jeho webu, recenzie, fotky, kontrolu jeho webu. S výsledkom pracujete ako s tabuľkou, mapou a kartou každého miesta a môžete ho exportovať.

Základné pojmy

Projekt: jedna úloha so svojimi regiónmi, typmi miest, jazykom vyhľadávania, filtrami, obohatením a všetkými vyhľadávaniami, ktoré sa pre ňu urobili. Projekt si uchováva výsledky, takže neskoršie vyhľadávanie ukáže, čo sa zmenilo.
Región: územie prevzaté z hraníc priamo na mape (krajina, región, mesto, mestská časť). Označený región zahŕňa všetko, čo leží v ňom. Miesta mimo vašich regiónov sa nikdy nezobrazujú a nikdy neúčtujú.
Typ miesta: druh podniku, ktorý hľadáte (zubár, kaviareň, hotel …), vybraný zo zoznamu bežných typov alebo zadaný vlastnými slovami. Zvolíte aj jazyk, v ktorom Google Maps odpovedá.
Skúšobné vyhľadávanie: bezplatná vzorka vyhľadávania. Ukáže, koľko miest tam je, čo pridá každý typ miesta, koľko bude úplné vyhľadávanie stáť a ako dlho potrvá, a dá vám vzorku miest, na ktorej vyskúšate filtre.
Filtre vyhľadávania: rozhodujú, ktoré miesta vyhľadávanie zaplatí a obohatí.
Obohatenie: to, čo sa pridá ku každému miestu, ktoré prejde filtrami. Každý typ má vlastnú cenu za výsledok.
Vyhľadávanie: úplný zber údajov. Pokrýva každý región bunku po bunke, takže nie je obmedzené na prvých sto výsledkov, ktoré vráti vyhľadávanie na mape.
Výsledky: miesta, ktoré vyhľadávanie našlo a vy ste zaplatili.
Kredity: v nich sa oceňuje práca. Jeden kredit stojí 0,001 €. Nový účet začína s 1 000 kreditmi zadarmo; ďalšie sa kupujú v balíkoch, kartou (pozri Ceny).
Organizácia: účet, ktorý za prácu svojich členov platí z vlastných kreditov (pozri Limity a kontrola).

Kroky projektu

Aplikácia prevedie projekt ôsmimi krokmi, ktoré sú uvedené vedľa AI asistenta. K ktorémukoľvek z nich sa môžete kedykoľvek vrátiť.

Aplikácia funguje aj v prehliadači telefónu: všetky kroky, výsledky (ako karty), export aj nákup kreditov. Jej rozhranie hovorí po anglicky aj v ďalších európskych jazykoch; ten svoj si vyberiete na stránke účtu.

Projekt: pomenujte ho a jednou vetou povedzte, na čo slúži; asistent podľa toho navrhne regióny a typy miest.
Regióny: označte krajiny, regióny, mestá alebo mestské časti v strome, vyhľadajte ich podľa názvu a pozrite si ich na mape.
Typy miest: čo hľadať a jazyk vyhľadávania.
Skúšobné vyhľadávanie: zadarmo. Odhad má rozpätie, cenu a trvanie a ukáže, koľko miest nájde každý typ miesta, ktoré nenájde žiadny iný. Keď nájdené miesta často nesú aj iné kategórie Google, ponúknu sa ako ďalšie typy miest.
Filtre: ponechajte len miesta, ktoré potrebujete, podľa stavu firmy, kategórie, slov v názve, webu, telefónu, online rezervácie, overeného profilu, hodnotenia, počtu recenzií a vybavenia. Každá zmena sa hneď prepočíta na vzorke zo skúšobného vyhľadávania: koľko miest zostáva a koľko ich každý filter vyradí sám osebe.
Obohatenie: vyberte typy (a pri kontaktoch hĺbku); pri recenziách a fotkách, koľko ich chcete na miesto. Každý typ ukazuje svoju cenu a trvanie.
Vyhľadávanie: zvoľte limit ceny alebo žiadny a spustite ho. Nájdené miesta, minuté kredity a zostávajúci čas sa zobrazujú naživo. Po zmene nastavení tento krok povie, akú prácu zmena vyžaduje (doplatenie výsledku, ktorý máte, alebo nové vyhľadávanie) a koľko stojí.
Výsledky: tabuľka, mapa, karta každého miesta, filtre, stĺpce a export.

Čo má každé miesto

Pole	Význam
Názov, kategórie	Ako ich ukazuje záznam
Adresa, mesto, krajina, súradnice, časové pásmo	Poloha
Telefón, web	Kontakty zo záznamu
Hodnotenie, počet recenzií	Aktuálne hodnotenie a počet recenzií
Stav firmy	V prevádzke, dočasne alebo natrvalo zatvorené
Overený profil, odkaz na rezerváciu, oblasť pôsobenia	Či záznam spravuje majiteľ, či odkazuje na online rezerváciu alebo objednávku, či firma pôsobí v oblasti bez prevádzky
Vybavenie	To, ktoré uvádza odpoveď vyhľadávania Google (zvyčajne len bezbariérovosť); Karta miesta prinesie všetko
Place ID, CID, odkaz na Google Maps	Stále identifikátory

Týždenné otváracie hodiny, popis a menu sú na úplnej karte miesta: pozri Karta miesta nižšie.

Obohatenie

Karta miesta

Úplná karta miesta nad rámec toho, čo vráti vyhľadávanie: všetky kategórie, popis, otváracie hodiny, menu alebo zoznam služieb (s cenami, ak ich firma uvádza), príspevky majiteľa, časy návštevnosti, hodnotenia podľa hviezdičiek, všetko vybavenie, ktoré Google uvádza, odkazy na rezerváciu a objednávku a či je profil overený.

Kontakty z webu

Web uvedený na karte miesta sa prečíta kvôli kontaktom: domovská stránka, potom stránky kontaktov, impressum a „o nás“. Výsledkom sú:

e-maily, každý s typom „všeobecný“ (info@, office@ …), „osobný“, „oddelenie“ (predaj, objednávky, účtovníctvo …) alebo „pobočka“, ak ho adresa spoľahlivo prezrádza, a bez typu, ak nie;
ďalšie telefóny, profily na sociálnych sieťach a odkazy na rezerváciu nájdené na webe;
kde sa ktorý kontakt našiel: stránka a či išlo o odkaz, text stránky, značkovanie webu, alebo ho našla AI;
kam web v skutočnosti vedie: na profil na sociálnej sieti, rezervačný systém, záznam v katalógu firiem alebo nový web tej istej firmy. Katalóg ani web inej firmy sa kvôli kontaktom nečíta.

Štyri hĺbky, každá s vlastnou cenou:

Hĺbka	Čo číta
Štandardné	Stránky tak, ako ich web posiela
JavaScript	Rovnaké stránky, najprv vykreslené v prehliadači: nájde kontakty aj na weboch zostavených skriptmi
AI vyhľadávanie	Vykreslené stránky číta AI agent, ktorý vyberá kontakty a rozhoduje, ktoré stránky otvoriť ďalej
AI + sociálne siete	Agent môže otvoriť aj profily firmy na sociálnych sieťach, s pevným rozpočtom na miesto; keď je web uvedený v Google Maps sám profilom, začne tam. Prečítanie stránky na Facebooku alebo Instagrame, na ktorú odkazuje web, zvyčajne stojí viac, ako tento rozpočet dovolí

E-maily nie sú v Google Maps: pochádzajú z vlastného webu firmy a podľa odboru sa nájdu približne pri 40–45 % miest, ktoré web majú. Miesto sa účtuje, len keď sa nájde e-mail alebo profil na sociálnej sieti.

Recenzie

Od najnovších, až do počtu, ktorý pre každé miesto nastavíte: text, hodnotenie a dátum každej recenzie a odpoveď majiteľa. Prídu aj témy recenzií od Google.

Fotky

Až do počtu, ktorý pre každé miesto nastavíte, v poradí, v akom ich ukazuje galéria Google, aj s počtom fotiek a záložkami galérie, takže viete, či majiteľ pridal fotky a či sú tam fotky menu alebo videá.

Kontrola webu

Jeden pohľad na web každého miesta:

jeho stav: funguje; funguje na novej adrese; funguje, ale je zatvorený pre robotov; odpovedá chybou; neodpovedá; doména neexistuje; zaparkovaný alebo na predaj; web inej firmy; bez vlastného webu (stránka na sociálnej sieti alebo v rezervačnom systéme); nie je webová adresa;
HTTPS: platný, neúplný reťazec, vypršal, ešte neplatný, pre inú adresu, vlastnoručne podpísaný, nedôveryhodný alebo žiadny; kedy certifikát vyprší; či http presmerúva na https;
na čom beží: CMS a jeho verzia, reklamné pixely (Meta Pixel, Google Ads, TikTok, LinkedIn, Pinterest, Snapchat, Microsoft, X, Reddit), analytika a správcovia značiek, rezervačné systémy.

Každý verdikt je odpoveďou a účtuje sa, nefunkčný web vrátane: práve to kontrola zistí.

Vyplnené, chýba, neznáme

Každé voliteľné pole je v jednom z troch stavov a aplikácia povie, v ktorom:

vyplnené: hodnota sa našla;
chýba: hľadalo sa a neexistuje (napríklad záznam nemá web);
neznáme: neoverovalo sa alebo overenie zlyhalo.

„Bez webu“ a „neoverené“ sú rôzne odpovede a zoznam leadov postavený na prvej nie je to isté ako zoznam postavený na druhej. Keď zlyhá vlastný zdroj miesta (doména, ktorá neexistuje, web, ktorý neodpovedá, miesto, ktoré zmizlo z Google), aplikácia to povie, nič za to neúčtuje a odlíši to od chyby na našej strane, ktorá sa skúša znova.

Práca s výsledkami

Tabuľka: vyberte si z približne 80 stĺpcov, zoraďte ich v ľubovoľnom poradí, nastavte ich šírku a zoraďujte podľa nich. Mapa ukazuje tie isté miesta; kliknutím sa otvorí karta miesta, usporiadaná ako v Google Maps: prehľad, menu a služby, recenzie (vyhľadávanie v nich, filter podľa hodnotenia), fotky. V telefóne sú miesta zobrazené ako karty.
Filtre výsledkov: zúžte zobrazenie podľa čohokoľvek zisteného. Kritériom môže byť osobný e-mail na vlastnej doméne webu, profily na vybraných sociálnych sieťach, menu s cenami, otvorené cez víkend alebo dlho do noci, recenzia 1–2★, na ktorú majiteľ neodpovedal, hodnotenie, ktoré zaostáva za recenziami, slová spomenuté v recenziách, stav webu, certifikát, CMS alebo pixely, mesto. Sú zadarmo a nič z toho, čo ste zaplatili, nemenia.
Vaše stĺpce: textový stĺpec alebo zoznam vašich hodnôt (s farbami a predvolenou hodnotou), vypĺňaný priamo v tabuľke, na karte miesta alebo hromadne pri mnohých miestach. Môžete podľa nich filtrovať a zoraďovať; dostanú sa aj do exportu.
AI stĺpce: napíšte úlohu („Ošetrujú aj deti?“) a AI agent vyplní stĺpec pri každom mieste hodnotou z vášho zoznamu, vyplnenou šablónou alebo voľným textom. Vy volíte, čo agent uvidí a čo smie použiť (len polia miesta, jeho web, internet, alebo aj vyhľadávanie na webe) a koľko volaní smie urobiť. Každá bunka uchováva zdôvodnenie agenta a stránky, ktoré prečítal.
Predvoľby: uložte stĺpce, ich šírky a poradie a filtre ako sadu pre jednu úlohu (zoznam na volanie, zoznam na rozosielanie), pre všetky svoje projekty alebo pre jeden, a použite ju jedným kliknutím.
Obohatenie výsledkov: pridajte obohatenie k miestam, ktoré tabuľka uvádza, bez nového vyhľadávania.
História a porovnanie: každé vyhľadávanie sa uchováva. Otvorte skoršie vyhľadávanie tak, ako vtedy vyzeralo, alebo porovnajte dve: čo je nové, čo sa zmenilo (a ktoré polia), čo zmizlo.

Vyhľadať znova

Pridanie typov miest alebo regiónov: výsledok sa rozšíri. Hľadá sa len to nové a miesta, ktoré ste už zaplatili, sa neplatia znova.
Odobratie niektorých: výsledok sa zúži, zadarmo.
Znova vyhľadať určitý typ: jeho miesta sa nájdu nanovo a znova sa zaplatia; pri každom type obohatenia zvoľte len nové miesta, nové a zmenené miesta, alebo znova všetky miesta.
Vyhľadávanie zastavené limitom: pokračujte tam, kde sa zastavilo.
Širšie filtre po vyhľadávaní: miesta, ktoré vyhľadávanie našlo, ale nezaplatilo, sa ponúknu ako doplatenie, ocenené podľa skutočných miest.
Typ obohatenia zapnutý po vyhľadávaní: doplatenie ho pridá k miestam, ktoré máte, bez nového vyhľadávania.

Export

XLSX, CSV, HTML, JSON, XML alebo Parquet: miesta, stĺpce a poradie, ktoré ukazuje tabuľka, aj s jej filtrami. Tabuľkové a stránkové formáty používajú názvy stĺpcov v jazyku vášho rozhrania; dátové formáty používajú stále kľúče a typované hodnoty (čísla, časové značky, zoznamy, záznamy ako položky menu alebo recenzie).

Ceny

Ceny sú v kreditoch; jeden kredit stojí 0,001 €, takže každá cena nižšie je v eurách za 1 000. Každé vyhľadávanie ukáže svoju cenu skôr, ako sa začne.

Čo	Platíte za	Za 1 000
Skúšobné vyhľadávanie		zadarmo
Miesta	každé miesto nájdené vo vnútri vašich regiónov, započítané len raz	1,00 €
Karta miesta	každé miesto	1,00 €
Kontakty z webu: štandardné	každé miesto, kde sa nájde e-mail alebo profil na sociálnej sieti	0,75 €
Kontakty z webu: JavaScript	to isté	4,25 €
Kontakty z webu: AI vyhľadávanie	to isté	17,50 €
Kontakty z webu: AI + sociálne siete	to isté	20,00 €
Recenzie	každú získanú recenziu	0,50 €
Fotky	každú získanú fotku	0,50 €
Kontrola webu	každé miesto s webom	2,25 €
AI stĺpce	tokeny modelu a stránky, ktoré prečíta, za ceny uvedené v aplikácii	podľa spotreby
Asistent		zadarmo

Príklad: 1 000 zubárov v regióne, so štandardnými kontaktmi nájdenými pri 430 z nich, stojí 1,00 € + 0,32 € = 1,32 €.

Pravidlá:

Skúšobné vyhľadávanie je zadarmo, rovnako ako zistenie, koľko miest vaše filtre ponechajú.
Duplicity, miesta mimo vašich regiónov a neúspešné požiadavky sa neúčtujú.
Kontakty sa účtujú len tam, kde sa nájde e-mail alebo profil na sociálnej sieti: web, ktorý sa nedá prečítať, nestojí nič.
Miesto, ktoré ste už zaplatili, sa neplatí znova, keď pridáte typy miest alebo regióny alebo budete vo vyhľadávaní pokračovať.
Vyhľadávanie zaplatí aspoň 10 % miest, ktoré vo vašich regiónoch nájde, nech jeho filtre ponechajú akokoľvek málo. Táto platba sa započíta, keď filtre neskôr rozšírite.
Zúženie výsledkov, vaše stĺpce, predvoľby a export nestoja nič.

Nákup kreditov

Plaťte priebežne: žiadne predplatné, nič sa neobnovuje.

1 000 kreditov zadarmo dostane každý nový účet. To je práca zhruba za 1 €, aby ste si vyskúšali vyhľadávanie vo vlastných regiónoch.
Balíky: kredity sa kupujú v balíkoch, od 10 € za 10 000 kreditov; väčšie balíky pridajú až o 15 % kreditov navyše. Ponúkané balíky a ich ceny uvidíte skôr, ako zaplatíte.
Platba: kartou, na platobnej stránke Stripe; číslo vašej karty nikdy nevidíme. Ceny sú v eurách. Ku každej platbe dostanete potvrdenie od Stripe.
Hneď: kredity sa pripíšu, hneď ako platba prejde. Pri platbe požiadate o ich okamžité sprístupnenie a beriete na vedomie, že ak nakupujete ako spotrebiteľ, tým strácate právo na odstúpenie od zmluvy do 14 dní.
Platnosť 365 dní: kredity, bezplatné aj kúpené, platia 365 dní odo dňa pripísania; ako prvé sa míňajú tie, ktorým platnosť vyprší najskôr. Kredity, ktoré dovtedy nevyužijete, prepadnú.
Vrátenie peňazí: platby sa nevracajú, okrem prípadov, keď to vyžaduje zákon. Ak je platba vrátená alebo stornovaná bankou, kredity, ktoré pridala, sa odpočítajú; ak už bola časť minutá, váš zostatok klesne pod nulu a žiadna nová platená práca sa nezačne, kým ho nákup nevyrovná.

Úplné podmienky nájdete v dokumente Obchodné podmienky.

Limity a kontrola

Limit ceny pre každé vyhľadávanie, alebo žiadny. Bez limitu vyhľadávanie pokračuje, kým to dovolí váš zostatok a mesačný limit; s limitom nikdy neminie viac a počas vyhľadávania ho môžete zvýšiť. V oboch prípadoch sa zastaví, keď sa minú peniaze, a ponechá si, čo našlo.
Mesačný limit pre celý účet, na stránke účtu.
Organizácie: účet sa môže stať organizáciou a pozvať kolegov e-mailom, hneď ako si kúpi kredity. Za ich prácu platí z vlastných kreditov: pri každom členovi rozhoduje, či ich smie míňať, môže nastaviť mesačný limit a vidí, koľko každý tento mesiac minul. Ich projekty ani výsledky nevidí nikdy. Vlastné kredity člena sú zmrazené, kým z organizácie neodíde.
Stránka Spotreba uvádza každý minutý kredit podľa dňa, druhu práce, projektu a vyhľadávania a pripísané kredity, vždy za jeden mesiac.

Asistent

Pri každom kroku je k dispozícii AI asistent. Z názvu a poznámok projektu navrhne regióny a typy miest a nastaví ich za vás; mení filtre, obohatenie a filtre výsledkov, vypĺňa vaše stĺpce a nastavuje AI stĺpce, pričom každú zmenu ukáže ako kartu s možnosťou pozrieť si ju; počíta miesta v skúšobnom vyhľadávaní a vo výsledkoch bez toho, aby čokoľvek minul, a odpovedá na otázky k projektu a aplikácii. Nikdy nespustí vyhľadávanie ani neminie kredity. Je zadarmo.

API

Na verejnom API pre váš vlastný kód pracujeme. Kým nebude hotové, všetko sa robí vo webovej aplikácii; ak potrebujete programový prístup, napíšte nám.

Podpora

Po prihlásení otvorte Podporu v hornej lište aplikácie: vaše požiadavky a naše odpovede zostávajú tam a hneď ako je vaša adresa potvrdená, chodia aj e-mailom. Inak nám napíšte zo stránky Kontakt.