# Jak działa PlaceGrid

**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.

1. **Projekt**: nadaj mu nazwę i w jednym zdaniu napisz, do czego służy; na tej podstawie asystent proponuje regiony i typy miejsc.
2. **Regiony**: zaznacz kraje, regiony, miasta lub dzielnice w drzewie, wyszukaj je po nazwie i zobacz je na mapie.
3. **Typy miejsc**: czego szukać i język wyszukiwania.
4. **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.
5. **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.
6. **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.
7. **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.
8. **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](/legal/terms).

---

## 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.
