Dokumentacja

Jak działa PlaceGrid

Cały produkt na jednej stronie: regiony i typy miejsc, bezpłatne wyszukiwanie próbne, filtry, wzbogacanie, wyniki, eksport i ceny. Jest też wersja w czystym Markdownie dla Twojego AI.

Zacznij Czysty Markdown dla agentów AI

Miejsca z Google Maps w dowolnym regionie, z kontaktami publikowanymi na ich własnych witrynach: znajdujesz je, filtrujesz, wzbogacasz i eksportujesz w jednej aplikacji internetowej.

PlaceGrid znajduje wszystkie firmy wybranych rodzajów w granicach regionów wziętych z mapy, mówi, ile ich jest i ile będą kosztować, zanim cokolwiek zostanie pobrane z salda, i dodaje do każdego miejsca to, o co poprosisz: pełną kartę miejsca Google, kontakty z jego witryny, opinie, zdjęcia, sprawdzenie witryny. Z wynikiem pracujesz w tabeli, na mapie i w karcie każdego miejsca, a potem go eksportujesz.

Pojęcia

Projekt: jedno zadanie wraz z jego regionami, typami miejsc, językiem wyszukiwania, filtrami, wzbogacaniem i wszystkimi wyszukiwaniami wykonanymi w jego ramach. Projekt przechowuje swoje wyniki, więc późniejsze wyszukiwanie pokazuje, co się zmieniło.
Region: obszar wyznaczony granicami z samej mapy (kraj, region, miasto, dzielnica). Zaznaczony region obejmuje wszystko, co leży w jego granicach. Miejsca poza Twoimi regionami nigdy nie są pokazywane ani liczone do opłaty.
Typ miejsca: rodzaj firmy do wyszukania (dentysta, kawiarnia, hotel …), wybrany z listy popularnych typów albo wpisany własnymi słowami. Wybierasz też język, w którym odpowiada Google Maps.
Wyszukiwanie próbne: bezpłatna próbka wyszukiwania. Pokazuje, ile jest miejsc, co wnosi każdy typ miejsca, ile będzie kosztować pełne wyszukiwanie i ile potrwa, a także daje próbkę miejsc do testowania filtrów.
Filtry wyszukiwania: warunki, które decydują, za które miejsca wyszukiwanie płaci i które wzbogaca.
Wzbogacanie: to, co jest dodawane do każdego miejsca, które przechodzi filtry. Każdy typ ma własną cenę za wynik.
Wyszukiwanie: pełne zbieranie danych. Przechodzi każdy region fragment po fragmencie, więc nie kończy się na pierwszej setce wyników, którą zwraca wyszukiwanie na mapie.
Wyniki: miejsca znalezione przez wyszukiwanie i opłacone przez Ciebie.
Kredyty: jednostka, w której wyceniana jest praca. Jeden kredyt to 0,001 €. Nowe konto zaczyna z 1000 darmowych kredytów; kolejne kupuje się w pakietach, kartą (zob. Ceny).
Organizacja: konto, które opłaca pracę swoich członków z własnych kredytów (zob. Limity i kontrola).

Etapy projektu

Aplikacja prowadzi projekt przez osiem etapów, wymienionych obok asystenta AI. Do każdego z nich możesz w dowolnej chwili wrócić.

Aplikacja działa też w przeglądarce telefonu: wszystkie etapy, wyniki (jako karty), eksport i doładowanie salda. Jej interfejs mówi po angielsku i w innych językach europejskich; wybierz swój na stronie konta.

Projekt: nadaj mu nazwę i w jednym zdaniu napisz, do czego służy; na tej podstawie asystent proponuje regiony i typy miejsc.
Regiony: zaznacz kraje, regiony, miasta lub dzielnice w drzewie, wyszukaj je po nazwie i zobacz je na mapie.
Typy miejsc: czego szukać i język wyszukiwania.
Wyszukiwanie próbne: bezpłatne. Szacunek zawiera zakres, koszt i czas oraz informację, ile miejsc każdy typ znajduje takich, których nie znajduje żaden inny. Jeśli znalezione miejsca często mają inne kategorie Google, są one proponowane jako kolejne typy miejsc.
Filtry: zostaw tylko potrzebne miejsca. Możesz filtrować według statusu działalności, kategorii, słów w nazwie, witryny, telefonu, rezerwacji online, zweryfikowanego profilu, oceny, liczby opinii i udogodnień. Każda zmiana jest od razu przeliczana na próbce z wyszukiwania próbnego: ile miejsc zostaje i ile odrzuca każdy filtr z osobna.
Wzbogacanie: wybierz typy (dla kontaktów także głębokość), a dla opinii i zdjęć określ, ile ich pobrać na miejsce. Każdy typ pokazuje swój koszt i czas.
Wyszukiwanie: wybierz limit kosztów albo zrezygnuj z niego i uruchom wyszukiwanie. Znalezione miejsca, wydane kredyty i pozostały czas widać na żywo. Po zmianie ustawień ten etap mówi, jakiej pracy wymaga zmiana (dopłaty do wyniku, który już masz, czy nowego wyszukiwania) i ile ona kosztuje.
Wyniki: tabela, mapa, karta każdego miejsca, filtry, kolumny i eksport.

Co zawiera każde miejsce

Pole	Znaczenie
Nazwa, kategorie	Tak jak pokazuje je karta
Adres, miasto, kraj, współrzędne, strefa czasowa	Lokalizacja
Telefon, witryna	Kontakty z karty
Ocena, liczba opinii	Bieżąca ocena i liczba opinii
Status działalności	Działa, zamknięte tymczasowo lub na stałe
Zweryfikowany profil, link do rezerwacji, obszar obsługi	Czy właściciel zarządza kartą, czy prowadzi ona do rezerwacji lub zamówień online, czy firma obsługuje obszar bez stacjonarnego punktu
Udogodnienia	Te, które podaje odpowiedź wyszukiwarki Google (zwykle tylko związane z dostępnością); Karta miejsca daje wszystkie
Place ID, CID, link do Google Maps	Stałe identyfikatory

Tygodniowe godziny otwarcia, opis i menu są w pełnej karcie miejsca (zob. Karta miejsca poniżej).

Wzbogacanie

Karta miejsca

Pełna karta miejsca, ponad to, co zwraca wyszukiwanie: wszystkie kategorie, opis, godziny otwarcia, menu lub lista usług (z cenami, jeśli firma je podaje), posty właściciela, popularne godziny, oceny według gwiazdek, wszystkie udogodnienia wymienione przez Google, linki do rezerwacji i zamówień oraz informacja, czy profil jest zweryfikowany.

Kontakty z witryny

Witryna z karty miejsca jest przeszukiwana pod kątem danych kontaktowych: strona główna, a potem strony kontaktu, danych firmy i „O nas”. Wynik to:

e-maile, każdy z typem, jeśli adres pozwala go wiarygodnie określić: ogólny (info@, office@ …), osobisty, dział (sprzedaż, zamówienia, księgowość …) lub oddział. Gdy nie pozwala, typ nie jest podawany;
dodatkowe telefony, profile społecznościowe i linki do rezerwacji znalezione na witrynie;
gdzie znaleziono każdy kontakt: strona oraz to, czy był to link, tekst strony, znaczniki witryny czy AI;
dokąd naprawdę prowadzi witryna: do profilu społecznościowego, systemu rezerwacji, wpisu w katalogu lub do nowej witryny tej samej firmy. Katalog ani witryna innej firmy nie są przeszukiwane pod kątem kontaktów.

Cztery głębokości, każda z własną ceną:

Głębokość	Co odczytuje
Standardowy	Strony tak, jak serwuje je witryna
JavaScript	Te same strony, najpierw wyrenderowane w przeglądarce: znajduje kontakty na witrynach budowanych przez skrypty
Wyszukiwanie AI	Wyrenderowane strony czyta agent AI, który wybiera kontakty i decyduje, które strony otworzyć dalej
AI + social media	Agent może też otworzyć profile firmy w mediach społecznościowych, w ramach stałego budżetu na miejsce; gdy witryna podana w Google Maps sama jest profilem, zaczyna od niej. Odczytanie strony na Facebooku lub Instagramie, do której linkuje witryna, zwykle kosztuje więcej, niż pozwala ten budżet

E-maili nie ma w Google Maps: pochodzą z własnej witryny firmy i udaje się je znaleźć w ok. 40–45 % miejsc, które ją mają, zależnie od branży. Opłata za miejsce jest pobierana tylko wtedy, gdy znaleziono e-mail lub profil społecznościowy.

Opinie

Najnowsze najpierw, do ustalonej przez Ciebie liczby na miejsce: treść, ocena i data każdej opinii oraz odpowiedź właściciela. Dołączane są też tematy opinii z Google.

Zdjęcia

Do ustalonej przez Ciebie liczby na miejsce, w kolejności, w jakiej pokazuje je galeria Google, wraz z licznikiem galerii i jej kartami. Dzięki temu wiesz, czy właściciel publikował zdjęcia i czy są zdjęcia menu lub filmy.

Sprawdzenie witryny

Jedno spojrzenie na witrynę każdego miejsca:

jej stan: działa; działa pod nowym adresem; działa, ale jest zamknięta dla robotów; odpowiada błędem; nie odpowiada; domena nie istnieje; zaparkowana lub na sprzedaż; witryna innej firmy; brak własnej witryny (strona w mediach społecznościowych lub systemie rezerwacji); to nie adres WWW;
HTTPS: ważny, niepełny łańcuch, wygasł, jeszcze nieważny, dla innego adresu, samopodpisany, niezaufany lub brak; kiedy wygasa certyfikat; czy http przekierowuje na https;
na czym działa: CMS i jego wersja, piksele reklamowe (Meta Pixel, Google Ads, TikTok, LinkedIn, Pinterest, Snapchat, Microsoft, X, Reddit), narzędzia analityczne i menedżery tagów, systemy rezerwacji.

Każdy werdykt jest odpowiedzią i jest płatny, także dla niedziałającej witryny: właśnie to sprawdzenie ustala.

Jest, brak, nieznane

Każde pole opcjonalne jest w jednym z trzech stanów, a aplikacja mówi, w którym:

jest: wartość została znaleziona;
brak: szukano jej i nie istnieje (na przykład karta nie ma witryny);
nieznane: nie sprawdzono jej albo sprawdzenie się nie powiodło.

„Brak witryny” i „nie sprawdzono” to różne odpowiedzi, a lista leadów zbudowana na pierwszej to co innego niż lista zbudowana na drugiej. Gdy zawodzi własne źródło miejsca (domena nie istnieje, witryna nie odpowiada, miejsce zniknęło z Google), aplikacja mówi to wprost, nie pobiera za to opłaty i odróżnia to od błędu po naszej stronie, który jest ponawiany.

Praca z wynikami

Tabela: wybieraj spośród ok. 80 kolumn, ustawiaj je w dowolnej kolejności, zmieniaj ich szerokość i sortuj według nich. Mapa pokazuje te same miejsca; kliknięcie otwiera kartę miejsca ułożoną jak w Google Maps: przegląd, menu i usługi, opinie (z wyszukiwaniem i filtrem według oceny), zdjęcia. Na telefonie miejsca są kartami.
Filtry wyników: zawężaj to, co widać, według dowolnych zebranych danych. Należą do nich osobisty e-mail we własnej domenie witryny, profile w wybranych serwisach społecznościowych, menu z cenami, otwarte w weekendy lub do późna, opinia 1–2★ bez odpowiedzi właściciela, ocena odstająca od opinii, słowa wymieniane w opiniach, stan witryny, certyfikat, CMS lub piksele, miasto. Te filtry są bezpłatne i nie zmieniają niczego, za co zapłacono.
Twoje kolumny: kolumna tekstowa lub lista Twoich wartości (z kolorami i wartością domyślną), wypełniana wprost w tabeli, w karcie miejsca albo dla wielu miejsc naraz. Można według nich filtrować i sortować; trafiają do eksportu.
Kolumny AI: wpisz zadanie („Czy leczą dzieci?”), a agent AI wypełni kolumnę dla każdego miejsca wartością z Twojej listy, wypełnionym szablonem albo dowolnym tekstem. Decydujesz, co agent zobaczy i z czego może korzystać (tylko z pól miejsca, jego witryny, internetu albo wyszukiwarki) oraz ile wywołań może wykonać. Każda komórka zachowuje uzasadnienie agenta i strony, które przeczytał.
Widoki: zapisz kolumny, ich szerokość i kolejność oraz filtry jako zestaw do jednego zadania (lista do dzwonienia, mailing), dla wszystkich projektów albo dla jednego, i stosuj go jednym kliknięciem.
Wzbogacanie wyników: dodaj wzbogacanie do miejsc widocznych w tabeli, bez nowego wyszukiwania.
Historia i porównanie: każde wyszukiwanie jest zachowywane. Otwórz wcześniejsze takie, jakie było, albo porównaj dwa: co nowego, co się zmieniło (i które pola), co zniknęło.

Ponowne wyszukiwanie

Dodanie typów miejsc lub regionów: wynik jest rozszerzany. Wyszukiwane jest tylko to, co nowe, a za miejsca, za które już zapłacono, nie płacisz ponownie.
Usunięcie części: wynik jest zawężany bezpłatnie.
Ponowne wyszukanie typu: jego miejsca są znajdowane od nowa i opłacane ponownie; dla każdego typu wzbogacania wybierz tylko nowe miejsca, nowe i zmienione albo wszystkie od nowa.
Wyszukiwanie zatrzymane przez limit: kontynuuj je od miejsca, w którym się zatrzymało.
Szersze filtry po wyszukiwaniu: miejsca, które wyszukiwanie znalazło, ale za które nie zapłaciło, są oferowane jako dopłata, wyceniona na podstawie faktycznych miejsc.
Typ wzbogacania włączony po wyszukiwaniu: dopłata dodaje go do miejsc, które już masz, bez ponownego wyszukiwania.

Eksport

XLSX, CSV, HTML, JSON, XML lub Parquet: miejsca, kolumny i kolejność, które pokazuje tabela, z jej filtrami. Formaty arkuszy i stron używają nazw kolumn w języku Twojego interfejsu, a formaty danych używają stałych kluczy i typowanych wartości (liczby, znaczniki czasu, listy, rekordy takie jak pozycje menu czy opinie).

Ceny

Ceny są w kredytach; jeden kredyt to 0,001 €, więc każdą cenę poniżej można czytać jako euro za 1000. Każde wyszukiwanie pokazuje swój koszt, zanim się zacznie.

Co	Za co płacisz	Za 1000
Wyszukiwanie próbne		bezpłatnie
Miejsca	każde odrębne miejsce znalezione w Twoich regionach	1,00 €
Karta miejsca	każde miejsce	1,00 €
Kontakty z witryny: standardowy	każde miejsce, w którym znaleziono e-mail lub profil społecznościowy	0,75 €
Kontakty z witryny: JavaScript	jak wyżej	4,25 €
Kontakty z witryny: wyszukiwanie AI	jak wyżej	17,50 €
Kontakty z witryny: AI + social media	jak wyżej	20,00 €
Opinie	każda zebrana opinia	0,50 €
Zdjęcia	każde zebrane zdjęcie	0,50 €
Sprawdzenie witryny	każde miejsce z witryną	2,25 €
Kolumny AI	tokeny modelu i strony, które czyta, po cenach podanych w aplikacji	według zużycia
Asystent		bezpłatnie

Przykład: 1000 dentystów w regionie, z kontaktami standardowymi znalezionymi dla 430 z nich, kosztuje 1,00 € + 0,32 € = 1,32 €.

Zasady:

Wyszukiwanie próbne jest bezpłatne, podobnie jak sprawdzenie, ile miejsc zostawią Twoje filtry.
Duplikaty, miejsca poza Twoimi regionami i nieudane zapytania nie są płatne.
Za kontakty płacisz tylko tam, gdzie znaleziono e-mail lub profil społecznościowy: witryna, której nie da się odczytać, nic nie kosztuje.
Za miejsce, za które już zapłacono, nie płacisz ponownie, gdy dodajesz typy miejsc lub regiony albo kontynuujesz wyszukiwanie.
Wyszukiwanie płaci za co najmniej 10 % miejsc znalezionych w Twoich regionach, niezależnie od tego, jak mało zostawią filtry, i jest to uwzględniane, gdy później rozszerzysz filtry.
Zawężanie wyników, Twoje kolumny, widoki i eksport nic nie kosztują.

Doładowanie salda

Płacisz za zużycie: nie ma abonamentu i nic się nie odnawia.

1000 darmowych kredytów dostaje każde nowe konto. To ok. 1 € pracy, by wypróbować wyszukiwanie we własnych regionach.
Pakiety: kredyty kupuje się w pakietach, od 10 € za 10 000 kredytów; większe pakiety dają do 15 % kredytów więcej. Dostępne pakiety i ich ceny widzisz, zanim zapłacisz.
Płatność: kartą, na stronie płatności Stripe; nigdy nie widzimy numeru Twojej karty. Ceny są w euro. Każda płatność ma potwierdzenie od Stripe.
Od razu: kredyty są dodawane, gdy tylko płatność przejdzie. Przy płatności prosisz o ich udostępnienie od razu i przyjmujesz do wiadomości, że jeśli kupujesz jako konsument, z tą chwilą wygasa Twoje 14-dniowe prawo odstąpienia od umowy.
Ważne 365 dni: kredyty, darmowe lub kupione, są ważne 365 dni od dnia dodania; najpierw wydawane są te, które wygasają najwcześniej. Kredyty niewykorzystane do tego czasu wygasają.
Zwroty: płatności nie są zwracane, chyba że wymaga tego prawo. Jeśli płatność zostanie zwrócona lub obciążona zwrotnie, dodane z niej kredyty są odbierane; jeśli część już wydano, saldo spada poniżej zera i żadna nowa płatna praca nie może się zacząć, dopóki zakup go nie wyrówna.

Pełne warunki zawiera Regulamin.

Limity i kontrola

Limit kosztów dla każdego wyszukiwania albo bez limitu. Bez limitu wyszukiwanie trwa, dopóki pozwalają na to saldo i limit miesięczny; z limitem nigdy nie wyda więcej, a limit możesz podnieść w trakcie wyszukiwania. Tak czy inaczej zatrzymuje się, gdy kończą się pieniądze, i zachowuje to, co znalazło.
Limit miesięczny dla całego konta, na stronie konta.
Organizacje: konto może stać się organizacją i zapraszać współpracowników e-mailem, gdy tylko kupi kredyty. Opłaca ich pracę z własnych kredytów: decyduje dla każdego członka, czy może je wydawać, może ustawić limit miesięczny i widzi, ile każdy wydał w tym miesiącu, ale nigdy nie widzi ich projektów ani wyników. Własne kredyty członka są zamrożone, dopóki nie odejdzie z organizacji.
Strona Zużycie pokazuje miesiąc po miesiącu każdy wydany kredyt według dni, rodzajów pracy, projektów i wyszukiwań oraz dodane kredyty.

Asystent

Asystent AI jest obok każdego etapu. Proponuje regiony i typy miejsc na podstawie nazwy i notatek projektu i sam je ustawia; zmienia filtry, wzbogacanie i filtry wyników, wypełnia Twoje kolumny i konfiguruje kolumny AI (każda zmiana pojawia się jako karta, z której można ją otworzyć); liczy miejsca w wyszukiwaniu próbnym i w wynikach, nic nie wydając, i odpowiada na pytania o projekt i aplikację. Nigdy nie uruchamia wyszukiwania ani nie wydaje kredytów. Jest bezpłatny.

API

Publiczne API dla Twojego własnego kodu jest w przygotowaniu. Do tego czasu wszystko odbywa się w aplikacji internetowej; jeśli potrzebujesz dostępu programistycznego, napisz do nas.

Wsparcie

Po zalogowaniu otwórz Wsparcie na górnym pasku aplikacji: Twoje zgłoszenia i nasze odpowiedzi są tam przechowywane, a po potwierdzeniu adresu przychodzą też e-mailem. W przeciwnym razie napisz do nas ze strony kontaktowej.