Dokumentace

Jak funguje PlaceGrid

Celý produkt na jedné stránce: regiony a typy míst, zkušební hledání zdarma, filtry, obohacení, výsledky, export a ceny. V čistém Markdownu i pro vaši AI.

Začít Čistý Markdown pro AI agenty

Místa z Google Maps pro jakýkoli region i s kontakty, které zveřejňují jejich vlastní weby. Najdete je, vyfiltrujete, obohatíte a exportujete v jedné webové aplikaci.

PlaceGrid najde všechny firmy zvolených druhů uvnitř hranic regionů převzatých z mapy, ještě než se cokoli účtuje, řekne vám, kolik jich je a kolik budou stát, a ke každému místu přidá, oč požádáte: úplnou kartu místa na Google, kontakty z jeho webu, recenze, fotky, kontrolu jeho webu. S výsledkem pracujete jako s tabulkou, mapou a kartou každého místa a můžete ho exportovat.

Základní pojmy

Projekt: jeden úkol se svými regiony, typy míst, jazykem hledání, filtry, obohacením a všemi hledáními, která pro něj proběhla. Projekt si uchovává výsledky, takže pozdější hledání ukáže, co se změnilo.
Region: území převzaté z hranic přímo na mapě (země, region, město, městská část). Zaškrtnutý region zahrnuje vše, co leží uvnitř. Místa mimo vaše regiony se nikdy nezobrazují a nikdy neúčtují.
Typ místa: druh podniku, který hledáte (zubař, kavárna, hotel …), vybraný ze seznamu běžných typů nebo zadaný vlastními slovy. Zvolíte také jazyk, ve kterém Google Maps odpovídá.
Zkušební hledání: bezplatný vzorek hledání. Ukáže, kolik míst tam je, co přidá každý typ místa, kolik bude úplné hledání stát a jak dlouho potrvá, a dá vám vzorek míst, na kterém vyzkoušíte filtry.
Filtry hledání: rozhodují, která místa hledání zaplatí a obohatí.
Obohacení: to, co se přidá ke každému místu, které projde filtry. Každý typ má vlastní cenu za výsledek.
Hledání: úplný sběr dat. Pokrývá každý region buňku po buňce, takže není omezené na prvních sto výsledků, které vrátí hledání na mapě.
Výsledky: místa, která hledání našlo a vy jste zaplatili.
Kredity: v nich se oceňuje práce. Jeden kredit stojí 0,001 €. Nový účet začíná s 1 000 kredity zdarma; další se kupují v balíčcích, kartou (viz Ceny).
Organizace: účet, který za práci svých členů platí z vlastních kreditů (viz Limity a kontrola).

Kroky projektu

Aplikace provede projekt osmi kroky, které jsou uvedené vedle AI asistenta. Ke kterémukoli z nich se můžete kdykoli vrátit.

Aplikace funguje i v prohlížeči telefonu: všechny kroky, výsledky (jako karty), export i nákup kreditů. Její rozhraní mluví anglicky a dalšími evropskými jazyky; ten svůj si vyberete na stránce účtu.

Projekt: pojmenujte ho a jednou větou řekněte, k čemu slouží; asistent podle toho navrhne regiony a typy míst.
Regiony: zaškrtněte země, regiony, města nebo městské části ve stromu, vyhledejte je podle názvu a prohlédněte si je na mapě.
Typy míst: co hledat a jazyk hledání.
Zkušební hledání: zdarma. Odhad má rozpětí, cenu a dobu trvání a ukáže, kolik míst každý typ místa najde, která žádný jiný nenajde. Když nalezená místa často nesou i jiné kategorie Google, nabídnou se jako další typy míst.
Filtry: ponechte jen místa, která potřebujete, podle stavu podniku, kategorie, slov v názvu, webu, telefonu, online rezervace, ověřeného profilu, hodnocení, počtu recenzí a vybavení. Každá změna se hned přepočítá na vzorku ze zkušebního hledání: kolik míst zbývá a kolik jich každý filtr vyřadí sám o sobě.
Obohacení: vyberte typy (a u kontaktů hloubku); u recenzí a fotek, kolik jich chcete na místo. Každý typ ukazuje svou cenu a dobu trvání.
Hledání: zvolte limit nákladů, nebo žádný, a spusťte ho. Nalezená místa, utracené kredity a zbývající čas se zobrazují živě. Po změně nastavení tento krok řekne, jakou práci změna vyžaduje (doplatek k výsledku, který máte, nebo nové hledání) a kolik stojí.
Výsledky: tabulka, mapa, karta každého místa, filtry, sloupce a export.

Co má každé místo

Pole	Význam
Název, kategorie	Jak je ukazuje záznam
Adresa, město, země, souřadnice, časové pásmo	Poloha
Telefon, web	Kontakty ze záznamu
Hodnocení, počet recenzí	Aktuální hodnocení a počet recenzí
Stav podniku	V provozu, dočasně, nebo trvale zavřeno
Ověřený profil, odkaz na rezervaci, oblast působení	Zda záznam spravuje majitel, zda odkazuje na online rezervaci nebo objednávku, zda podnik působí v oblasti bez provozovny
Vybavení	To, které uvádí odpověď hledání Google (obvykle jen bezbariérovost); Karta místa přinese všechno
Place ID, CID, odkaz na Google Maps	Stálé identifikátory

Týdenní otevírací doba, popis a menu jsou na úplné kartě místa: viz Karta místa níže.

Obohacení

Karta místa

Úplná karta místa nad rámec toho, co vrátí hledání: všechny kategorie, popis, otevírací doba, menu nebo seznam služeb (s cenami, pokud je podnik uvádí), příspěvky majitele, nejrušnější doby, hodnocení podle hvězdiček, veškeré vybavení, které Google uvádí, odkazy na rezervaci a objednávku a zda je profil ověřený.

Kontakty z webu

Web uvedený na kartě místa se přečte kvůli kontaktům: domovská stránka, pak stránky kontaktů, impresa a „o nás“. Výsledkem jsou:

e-maily, každý s typem „obecný“ (info@, office@ …), „osobní“, „oddělení“ (prodej, objednávky, účetní …) nebo „pobočka“, pokud ho adresa spolehlivě prozrazuje, a bez typu, pokud ne;
další telefony, profily na sociálních sítích a odkazy na rezervaci nalezené na webu;
kde byl který kontakt nalezen: stránka a zda šlo o odkaz, text stránky, značkování webu, nebo ho našla AI;
kam web ve skutečnosti vede: na profil na sociální síti, rezervační systém, záznam v katalogu firem nebo nový web téže firmy. Katalog ani web jiné firmy se kvůli kontaktům nečte.

Čtyři hloubky, každá s vlastní cenou:

Hloubka	Co čte
Standardní	Stránky tak, jak je web posílá
JavaScript	Stejné stránky, nejdřív vykreslené v prohlížeči: najde kontakty i na webech sestavených skripty
AI hledání	Vykreslené stránky čte AI agent, který vybírá kontakty a rozhoduje, které stránky otevřít dál
AI + sociální sítě	Agent může otevřít i profily firmy na sociálních sítích, s pevným rozpočtem na místo; když je web uvedený v Google Maps sám profilem, začne tam. Přečtení stránky na Facebooku nebo Instagramu, na kterou odkazuje web, obvykle stojí víc, než tento rozpočet dovolí

E-maily nejsou v Google Maps: pocházejí z vlastního webu firmy a podle oboru se najdou přibližně u 40–45 % míst, která web mají. Místo se účtuje, jen když se najde e-mail nebo profil na sociální síti.

Recenze

Od nejnovějších, až do počtu, který pro každé místo nastavíte: text, hodnocení a datum každé recenze a odpověď majitele. Přijdou i témata recenzí od Google.

Fotky

Až do počtu, který pro každé místo nastavíte, v pořadí, v jakém je ukazuje galerie Google, i s počtem fotek a záložkami galerie, takže víte, zda majitel přidal fotky a zda jsou tam fotky menu nebo videa.

Kontrola webu

Jeden pohled na web každého místa:

jeho stav: funguje; funguje na nové adrese; funguje, ale je zavřený robotům; odpovídá chybou; neodpovídá; doména neexistuje; zaparkováno nebo na prodej; web jiné firmy; nemá vlastní web (stránka na sociální síti nebo v rezervačním systému); není webová adresa;
HTTPS: platný, neúplný řetězec, prošlý, ještě neplatný, pro jinou adresu, podepsaný sám sebou, nedůvěryhodný, nebo žádný; kdy certifikát vyprší; zda http přesměrovává na https;
na čem běží: CMS a jeho verze, reklamní pixely (Meta Pixel, Google Ads, TikTok, LinkedIn, Pinterest, Snapchat, Microsoft, X, Reddit), analytika a správci značek, rezervační systémy.

Každý verdikt je odpovědí a účtuje se, nefunkční web včetně: právě to kontrola zjistí.

Vyplněno, chybí, neznámé

Každé volitelné pole je v jednom ze tří stavů a aplikace řekne, ve kterém:

vyplněno: hodnota byla nalezena;
chybí: hledalo se a neexistuje (například záznam nemá web);
neznámé: neověřovalo se, nebo ověření selhalo.

„Bez webu“ a „neověřeno“ jsou různé odpovědi a seznam leadů postavený na té první není totéž co seznam postavený na té druhé. Když selže vlastní zdroj místa (doména, která neexistuje, web, který neodpovídá, místo, které zmizelo z Google), aplikace to řekne, nic za to neúčtuje a odliší to od chyby na naší straně, která se zkouší znovu.

Práce s výsledky

Tabulka: vyberte si z přibližně 80 sloupců, seřaďte je v libovolném pořadí, nastavte jejich šířku a řaďte podle nich. Mapa ukazuje stejná místa; kliknutím se otevře karta místa, uspořádaná jako v Google Maps: přehled, menu a služby, recenze (hledání v nich, filtr podle hodnocení), fotky. V telefonu jsou místa zobrazená jako karty.
Filtry výsledků: zužte zobrazení podle čehokoli, co se zjistilo. Kritériem může být osobní e-mail na vlastní doméně webu, profily na vybraných sociálních sítích, menu s cenami, otevřeno o víkendu nebo dlouho do noci, recenze 1–2★, na kterou majitel neodpověděl, hodnocení, které zaostává za recenzemi, slova zmíněná v recenzích, stav webu, certifikát, CMS nebo pixely, město. Jsou zdarma a nic z toho, co jste zaplatili, nemění.
Vaše sloupce: textový sloupec nebo seznam vašich hodnot (s barvami a výchozí hodnotou), vyplňovaný přímo v tabulce, na kartě místa nebo hromadně u mnoha míst. Můžete podle nich filtrovat a řadit; dostanou se i do exportu.
AI sloupce: napište úkol („Ošetřují i děti?“) a AI agent vyplní sloupec u každého místa hodnotou z vašeho seznamu, vyplněnou šablonou nebo volným textem. Vy volíte, co agent uvidí a co smí použít (jen pole místa, jeho web, internet, nebo i hledání na webu) a kolik volání smí udělat. Každá buňka uchovává zdůvodnění agenta a stránky, které přečetl.
Předvolby: uložte sloupce, jejich šířky a pořadí a filtry jako sadu pro jeden úkol (seznam k obvolání, seznam k rozesílce), pro všechny své projekty nebo pro jeden, a použijte ji jedním kliknutím.
Obohacení výsledků: přidejte obohacení k místům, která tabulka uvádí, bez nového hledání.
Historie a porovnání: každé hledání se uchovává. Otevřete dřívější hledání tak, jak tehdy vypadalo, nebo porovnejte dvě: co je nového, co se změnilo (a která pole), co zmizelo.

Hledat znovu

Přidání typů míst nebo regionů: výsledek se rozšíří. Hledá se jen to nové a místa, která už jste zaplatili, se neplatí znovu.
Odebrání některých: výsledek se zúží, zdarma.
Znovu hledat určitý typ: jeho místa se najdou znovu a znovu se zaplatí; u každého typu obohacení zvolte jen nová místa, nová a změněná místa, nebo znovu všechna místa.
Hledání zastavené limitem: pokračujte tam, kde se zastavilo.
Širší filtry po hledání: místa, která hledání našlo, ale nezaplatilo, se nabídnou jako doplatek, oceněný podle skutečných míst.
Typ obohacení zapnutý po hledání: doplatek ho přidá k místům, která máte, bez nového hledání.

Export

XLSX, CSV, HTML, JSON, XML nebo Parquet: místa, sloupce a pořadí, které ukazuje tabulka, i s jejími filtry. Tabulkové a stránkové formáty používají názvy sloupců v jazyce vašeho rozhraní; datové formáty používají stálé klíče a typované hodnoty (čísla, časové značky, seznamy, záznamy jako položky menu nebo recenze).

Ceny

Ceny jsou v kreditech; jeden kredit stojí 0,001 €, takže každá cena níže je v eurech za 1 000. Každé hledání ukáže svou cenu dřív, než začne.

Co	Platíte za	Za 1 000
Zkušební hledání		zdarma
Místa	každé místo nalezené uvnitř vašich regionů, započtené jen jednou	1,00 €
Karta místa	každé místo	1,00 €
Kontakty z webu: standardní	každé místo, kde se najde e-mail nebo profil na sociální síti	0,75 €
Kontakty z webu: JavaScript	totéž	4,25 €
Kontakty z webu: AI hledání	totéž	17,50 €
Kontakty z webu: AI + sociální sítě	totéž	20,00 €
Recenze	každou získanou recenzi	0,50 €
Fotky	každou získanou fotku	0,50 €
Kontrola webu	každé místo s webem	2,25 €
AI sloupce	tokeny modelu a stránky, které přečte, za ceny uvedené v aplikaci	podle spotřeby
Asistent		zdarma

Příklad: 1 000 zubařů v regionu, se standardními kontakty nalezenými u 430 z nich, stojí 1,00 € + 0,32 € = 1,32 €.

Pravidla:

Zkušební hledání je zdarma, stejně jako zjištění, kolik míst vaše filtry ponechají.
Duplicity, místa mimo vaše regiony a neúspěšné požadavky se neúčtují.
Kontakty se účtují jen tam, kde se najde e-mail nebo profil na sociální síti: web, který nejde přečíst, nestojí nic.
Místo, které už jste zaplatili, se neplatí znovu, když přidáte typy míst nebo regiony nebo v hledání budete pokračovat.
Hledání zaplatí nejméně 10 % míst, která ve vašich regionech najde, ať jeho filtry ponechají jakkoli málo. Tato platba se započítá, až filtry později rozšíříte.
Zúžení výsledků, vaše sloupce, předvolby a export nestojí nic.

Nákup kreditů

Plaťte průběžně: žádné předplatné, nic se neobnovuje.

1 000 kreditů zdarma dostane každý nový účet. To je práce zhruba za 1 €, abyste si vyzkoušeli hledání ve vlastních regionech.
Balíčky: kredity se kupují v balíčcích, od 10 € za 10 000 kreditů; větší balíčky přidají až o 15 % kreditů navíc. Nabízené balíčky a jejich ceny uvidíte, než zaplatíte.
Platba: kartou, na platební stránce Stripe; číslo vaší karty nikdy nevidíme. Ceny jsou v eurech. Ke každé platbě dostanete účtenku od Stripe.
Ihned: kredity se připíšou, jakmile platba projde. Při platbě požádáte o jejich okamžité zpřístupnění a berete na vědomí, že pokud nakupujete jako spotřebitel, tím zaniká vaše právo odstoupit od smlouvy ve lhůtě 14 dnů.
Platnost 365 dní: kredity, bezplatné i koupené, platí 365 dní ode dne připsání; jako první se utrácejí ty, kterým platnost vyprší nejdřív. Kredity, které do té doby nevyužijete, propadnou.
Vrácení peněz: platby se nevracejí, pokud to nevyžaduje zákon. Pokud je platba vrácena nebo stornována bankou, kredity, které přidala, se odečtou; pokud už byla část utracena, váš zůstatek klesne pod nulu a žádná nová placená práce nezačne, dokud ho nákup nevyrovná.

Úplné podmínky najdete v dokumentu Podmínky služby.

Limity a kontrola

Limit nákladů pro každé hledání, nebo žádný. Bez limitu hledání pokračuje, dokud to dovolí váš zůstatek a měsíční limit; s limitem nikdy neutratí víc a během hledání ho můžete zvýšit. V obou případech se zastaví, až dojdou peníze, a ponechá si, co našlo.
Měsíční limit pro celý účet, na stránce účtu.
Organizace: účet se může stát organizací a pozvat kolegy e-mailem, jakmile si koupí kredity. Za jejich práci platí z vlastních kreditů: u každého člena rozhoduje, zda je smí utrácet, může nastavit měsíční limit a vidí, kolik každý tento měsíc utratil. Jejich projekty ani výsledky nevidí nikdy. Vlastní kredity člena jsou zmrazené, dokud z organizace neodejde.
Stránka Spotřeba uvádí každý utracený kredit podle dne, druhu práce, projektu a hledání a připsané kredity, vždy za jeden měsíc.

Asistent

U každého kroku je k dispozici AI asistent. Z názvu a poznámek projektu navrhne regiony a typy míst a nastaví je za vás; mění filtry, obohacení a filtry výsledků, vyplňuje vaše sloupce a nastavuje AI sloupce, přičemž každou změnu ukáže jako kartu s možností si ji prohlédnout; počítá místa ve zkušebním hledání a ve výsledcích, aniž by cokoli utratil, a odpovídá na otázky k projektu a aplikaci. Nikdy nespustí hledání ani neutratí kredity. Je zdarma.

API

Na veřejném API pro váš vlastní kód pracujeme. Dokud nebude hotové, vše se dělá ve webové aplikaci; pokud potřebujete programový přístup, napište nám.

Podpora

Po přihlášení otevřete Podporu v horní liště aplikace: vaše požadavky a naše odpovědi zůstávají tam a jakmile je vaše adresa potvrzená, chodí i e-mailem. Jinak nám napište ze stránky Kontakt.