Документація

Як працює PlaceGrid

Увесь продукт на одній сторінці: регіони й типи місць, безкоштовний пробний пошук, фільтри, збагачення, результати, експорт і ціни. Є й версія в простому Markdown для вашого ШІ.

Почати Чистий Markdown для ШІ-агентів

Місця з Google Maps у будь-якому регіоні разом із контактами, які публікують їхні власні сайти: ви знаходите, фільтруєте, збагачуєте й вивантажуєте їх в одному вебзастосунку.

PlaceGrid знаходить усі компанії вибраних видів у межах регіонів, узятих із карти, ще до будь-якого списання повідомляє, скільки їх і скільки вони коштуватимуть, і додає до кожного місця те, що ви попросите: повну картку місця Google, контакти з його сайту, відгуки, фото, перевірку сайту. З результатом ви працюєте в таблиці, на карті й у картці кожного місця, а потім експортуєте його.

Основні поняття

Проєкт: одне завдання з його регіонами, типами місць, мовою пошуку, фільтрами, збагаченням і всіма пошуками, зробленими для нього. Проєкт зберігає свої результати, тож наступний пошук показує, що змінилося.
Регіон: територія в межах самої карти (країна, регіон, місто, район). Позначений регіон охоплює все, що всередині нього. Місця поза вашими регіонами ніколи не показуються й не оплачуються.
Тип місця: вид бізнесу, який треба знайти (стоматолог, кав’ярня, готель …); його вибирають зі списку поширених типів або пишуть власними словами. Ви також вибираєте мову, якою відповідає Google Maps.
Пробний пошук: безкоштовна проба пошуку. Вона показує, скільки там місць, що додає кожен тип місця, скільки коштуватиме повний пошук і скільки часу він займе, а також дає вибірку місць, на якій можна випробувати фільтри.
Фільтри пошуку: умови, що визначають, за які місця пошук платить і які збагачує.
Збагачення: те, що додається до кожного місця, яке пройшло фільтри. Кожен тип має свою ціну за результат.
Пошук: повний збір. Він проходить кожен регіон ділянка за ділянкою, тож не обмежений першою сотнею результатів, яку видає пошук на карті.
Результати: місця, які знайшов пошук і за які ви заплатили.
Кредити: одиниця, в якій оцінюється робота. Один кредит коштує 0,001 євро. Новий обліковий запис отримує 1 000 безкоштовних кредитів; решта купується пакетами, карткою (див. Ціни).
Організація: обліковий запис, який оплачує роботу своїх учасників із власних кредитів (див. Ліміти й контроль).

Етапи проєкту

Застосунок веде проєкт через вісім етапів, перелічених поруч з ШІ-асистентом. До будь-якого з них можна повернутися будь-коли.

Застосунок працює і в браузері телефона: усі етапи, результати (у вигляді карток), експорт і поповнення балансу. Його інтерфейс говорить англійською та іншими європейськими мовами; виберіть свою на сторінці облікового запису.

Проєкт: дайте йому назву й одним реченням скажіть, для чого він; за цим описом асистент пропонує регіони й типи місць.
Регіони: позначте країни, регіони, міста чи райони в дереві, знайдіть їх за назвою й подивіться на карті.
Типи місць: що шукати та мова пошуку.
Пробний пошук: безкоштовно. Оцінка надходить із діапазоном, вартістю й часом, а також із тим, скільки місць кожен тип знаходить таких, яких не знаходить жоден інший. Якщо в знайдених місць часто трапляються інші категорії Google, їх пропонують як додаткові типи місць.
Фільтри: залиште лише потрібні місця. Фільтрувати можна за статусом роботи, категоріями, словами в назві, сайтом, телефоном, онлайн-записом, підтвердженою карткою, рейтингом, кількістю відгуків і зручностями. Кожна зміна одразу перераховується на вибірці пробного пошуку: скільки місць залишається і скільки відсікає кожен фільтр сам по собі.
Збагачення: виберіть типи (для контактів ще й глибину), а для відгуків і фото вкажіть, скільки їх брати на місце. Кожен тип показує свою вартість і час.
Пошук: виберіть ліміт витрат або обійдіться без нього й запустіть пошук. Знайдені місця, витрачені кредити й час, що лишився, видно в реальному часі. Після зміни налаштувань цей етап каже, якої роботи потребує зміна (доплати до наявного результату чи нового пошуку) і скільки вона коштує.
Результати: таблиця, карта, картка кожного місця, фільтри, колонки й експорт.

Що є в кожного місця

Поле	Значення
Назва, категорії	Як у картці
Адреса, місто, країна, координати, часовий пояс	Розташування
Телефон, сайт	Контакти з картки
Рейтинг, кількість відгуків	Поточний рейтинг і кількість відгуків
Статус роботи	Працює, зачинено тимчасово чи назавжди
Підтверджена картка, посилання на запис, зона обслуговування	Чи керує карткою власник, чи веде вона на онлайн-запис або онлайн-замовлення, чи обслуговує місце територію без власної точки
Зручності	Ті, що перелічує пошукова відповідь Google (зазвичай лише пов’язані з доступністю); Картка місця дає їх усі
Place ID, CID, посилання на Google Maps	Сталі ідентифікатори

Години роботи за днями тижня, опис і меню є в повній картці місця (див. Картка місця нижче).

Збагачення

Картка місця

Повна картка місця дає більше, ніж пошук: усі категорії, опис, години роботи, меню або перелік послуг (із цінами, якщо компанія їх указує), публікації власника, популярні години, оцінки за зірками, усі зручності, які перелічує Google, посилання на запис і замовлення, а також чи підтверджено картку власником.

Контакти із сайту

Сайт із картки місця читається в пошуках контактів: головна сторінка, потім сторінки контактів, реквізитів і «Про нас». Результат:

email, кожен зі своїм типом, якщо адреса надійно його видає: загальна (info@, office@ …), особиста, відділ (продажі, замовлення, бухгалтерія …) або філія. Якщо не видає, тип не вказується;
додаткові телефони, профілі в соцмережах і посилання на запис, знайдені на сайті;
де знайдено кожен контакт: сторінка і те, чи було це посиланням, текстом сторінки, розміткою сайту чи знахідкою ШІ;
куди насправді веде сайт: на профіль у соцмережі, систему запису, сторінку в каталозі чи на новий сайт тієї самої компанії. Каталог або сайт іншої компанії не читається в пошуках контактів.

Чотири глибини, кожна зі своєю ціною:

Глибина	Що читає
Звичайний	Сторінки такими, якими їх віддає сайт
JavaScript	Ті самі сторінки, але спершу відкриті в браузері: знаходить контакти на сайтах, зібраних скриптами
ШІ-пошук	Відкриті в браузері сторінки читає ШІ-агент: він вибирає контакти й вирішує, які сторінки відкрити далі
ШІ + соцмережі	Агент може відкрити ще й профілі компанії в соцмережах, у межах фіксованого бюджету на місце; якщо сайт, указаний у Google Maps, сам є профілем, агент починає з нього. Прочитати сторінку Facebook чи Instagram, на яку посилається сайт, зазвичай коштує більше, ніж дозволяє цей бюджет

Email немає в Google Maps: їх беруть із власного сайту компанії й знаходять приблизно для 40–45 % місць, які його мають, залежно від ніші. Місце оплачується, лише якщо знайдено email або профіль у соцмережі.

Відгуки

Спершу нові, до заданої вами кількості на місце: текст, оцінка й дата кожного відгуку та відповідь власника. Надходять і теми відгуків від Google.

Фото

До заданої вами кількості на місце, у тому порядку, у якому їх показує галерея Google, разом із власним лічильником галереї та її вкладками. Так видно, чи публікував власник фото і чи є фото меню або відео.

Перевірка сайту

Один погляд на сайт кожного місця:

його стан: працює; працює за новою адресою; працює, але закритий від роботів; відповідає з помилкою; не відповідає; домену немає; припаркований або продається; чужий сайт; власного сайту немає (сторінка в соцмережі чи системі запису); хибна адреса;
HTTPS: чинний, ланцюжок неповний, прострочений, ще не чинний, виданий на іншу адресу, самопідписаний, недовірений або немає HTTPS; коли спливає сертифікат; чи веде http на https;
на чому він працює: CMS і її версія, рекламні пікселі (Meta Pixel, Google Ads, TikTok, LinkedIn, Pinterest, Snapchat, Microsoft, X, Reddit), аналітика й менеджери тегів, системи запису.

Кожен вердикт вважається відповіддю й оплачується, навіть якщо сайт не працює: саме це перевірка й знаходить.

Є, немає, невідомо

Кожне необов’язкове поле перебуває в одному з трьох станів, і застосунок каже, в якому:

є: значення знайдено;
немає: його шукали, і його не існує (наприклад, у картці немає сайту);
невідомо: його не перевіряли або перевірка не вдалася.

«Немає сайту» і «не перевірялося» означають різне, і база лідів, побудована на першій відповіді, відрізняється від бази, побудованої на другій. Коли відмовляє власне джерело місця (домену не існує, сайт не відповідає, місце зникло з Google), застосунок так і каже, нічого за це не списує й відрізняє це від помилки на нашому боці, після якої спробу буде повторено.

Робота з результатами

Таблиця: вибирайте з приблизно 80 колонок, розставляйте їх у будь-якому порядку, задавайте ширину й сортуйте за ними. Карта показує ті самі місця; клацання відкриває картку місця, влаштовану як у Google Maps: огляд, меню й послуги, відгуки (з пошуком і фільтром за оцінкою), фото. На телефоні місця показуються картками.
Фільтри результатів: звужуйте показане за будь-якими зібраними даними. Серед них особиста адреса email на власному домені сайту, профілі у вибраних соцмережах, меню з цінами, робота у вихідні або допізна, відгук на 1–2★ без відповіді власника, рейтинг, що відстає від відгуків, слова, які згадуються у відгуках, стан сайту, сертифікат, CMS чи пікселі, місто. Ці фільтри безкоштовні й нічого не змінюють в оплаченому.
Ваші колонки: текстова колонка або список ваших значень (з кольорами й значенням за замовчуванням); заповнюються просто в таблиці, у картці місця або одразу для багатьох місць. За ними можна фільтрувати й сортувати; вони потрапляють в експорт.
ШІ-колонки: напишіть завдання («Чи лікують тут дітей?»), і ШІ-агент заповнить колонку для кожного місця значенням із вашого списку, заповненим шаблоном або вільним текстом. Ви вирішуєте, що показати агенту і чим йому можна користуватися (лише полями місця, його сайтом, інтернетом або вебпошуком), а також скільки звернень він може зробити. У кожній клітинці зберігаються пояснення агента й сторінки, які він прочитав.
Пресети: збережіть колонки, їхню ширину й порядок разом із фільтрами як набір для одного завдання (обдзвін, розсилка), для всіх проєктів або для одного, і застосовуйте одним клацанням.
Збагачення результатів: додайте збагачення до місць, які показує таблиця, без нового пошуку.
Історія й порівняння: кожен пошук зберігається. Відкрийте попередній таким, яким він був, або порівняйте два: що з’явилося, що змінилося (і які поля), що зникло.

Повторний пошук

Додати типи місць або регіони: результат розширюється. Шукається лише нове, а за вже оплачені місця вдруге не платять.
Прибрати частину: результат звужується безкоштовно.
Повторити пошук за типом: його місця знаходяться заново й оплачуються знову. Для кожного типу збагачення виберіть, які місця збагачувати: лише нові, нові й змінені або всі заново.
Пошук, зупинений лімітом: продовжте його з того місця, де він зупинився.
Ширші фільтри після пошуку: місця, які пошук знайшов, але не оплатив, пропонуються як доплата з ціною за фактичними місцями.
Тип збагачення, увімкнений після пошуку: доплата додасть його до наявних місць без нового пошуку.

Експорт

XLSX, CSV, HTML, JSON, XML або Parquet: ті місця, колонки й порядок, що показує таблиця, з її фільтрами. Табличні й сторінкові формати використовують назви колонок мовою вашого інтерфейсу, а формати даних використовують сталі ключі й типізовані значення (числа, позначки часу, списки, записи, наприклад позиції меню чи відгуки).

Ціни

Ціни вказано в кредитах; один кредит коштує 0,001 євро, тож усі ціни нижче можна читати як євро за 1 000. Будь-який пошук показує свою вартість до запуску.

Що	За що ви платите	За 1 000
Пробний пошук		безкоштовно
Місця	кожне окреме місце, знайдене у ваших регіонах	1,00 EUR
Картка місця	кожне місце	1,00 EUR
Контакти із сайту: звичайний	кожне місце, де знайдено email або профіль у соцмережі	0,75 EUR
Контакти із сайту: JavaScript	те саме	4,25 EUR
Контакти із сайту: ШІ-пошук	те саме	17,50 EUR
Контакти із сайту: ШІ + соцмережі	те саме	20,00 EUR
Відгуки	кожен зібраний відгук	0,50 EUR
Фото	кожне зібране фото	0,50 EUR
Перевірка сайту	кожне місце із сайтом	2,25 EUR
ШІ-колонки	токени моделі й сторінки, які вона читає, за цінами, указаними в застосунку	за фактом
Асистент		безкоштовно

Приклад: 1 000 стоматологів у регіоні, звичайні контакти знайдено для 430 із них. Вартість: 1,00 EUR + 0,32 EUR = 1,32 EUR.

Правила:

Пробний пошук безкоштовний, як і перегляд того, скільки місць залишать ваші фільтри.
Дублі, місця поза вашими регіонами й невдалі запити не оплачуються.
Контакти оплачуються, лише якщо знайдено email або профіль у соцмережі: сайт, який не вдалося прочитати, нічого не коштує.
За вже оплачене місце не платять удруге, коли ви додаєте типи місць чи регіони або продовжуєте пошук.
Пошук оплачує щонайменше 10 % місць, знайдених у ваших регіонах, скільки б не залишили фільтри, і це враховується, коли ви пізніше розширите фільтри.
Звуження результатів, ваші колонки, пресети й експорт нічого не коштують.

Поповнення балансу

Платіть у міру потреби: передплати немає, і нічого не поновлюється.

1 000 безкоштовних кредитів отримує кожен новий обліковий запис. Це приблизно 1 євро роботи, щоб спробувати пошук у своїх регіонах.
Пакети: кредити купуються пакетами, від 10 євро за 10 000 кредитів; більші пакети дають до 15 % кредитів зверху. Доступні пакети та їхні ціни показуються до оплати.
Оплата: карткою, на сторінці оплати Stripe; номера вашої картки ми ніколи не бачимо. Ціни вказано в євро. До кожного платежу додається квитанція Stripe.
Одразу: кредити зараховуються, щойно проходить платіж. Під час оформлення ви просите надати їх одразу й підтверджуєте, що, якщо ви купуєте як споживач, на цьому закінчується ваше право на відмову від договору протягом 14 днів.
Дійсні 365 днів: кредити, безкоштовні чи куплені, дійсні 365 днів від дня зарахування; першими витрачаються ті, що згорають раніше. Не використані до цього терміну кредити згорають.
Повернення коштів: платежі не повертаються, крім випадків, коли цього вимагає закон. Якщо платіж повернуто чи оскаржено, зараховані за ним кредити списуються; якщо частину вже витрачено, баланс стає від’ємним, і нову платну роботу не можна почати, доки покупка його не покриє.

Повні умови викладено в документі Умови використання.

Ліміти й контроль

Ліміт витрат на кожен пошук, а можна й без ліміту. Без ліміту пошук триває, доки дозволяють баланс і місячний ліміт; з лімітом він ніколи не витратить більше, а підняти ліміт можна просто під час пошуку. У будь-якому разі пошук зупиняється, коли закінчуються гроші, і зберігає знайдене.
Місячний ліміт на весь обліковий запис задається на сторінці облікового запису.
Організації: обліковий запис може стати організацією й, щойно купить кредити, запрошувати колег через email. Організація оплачує їхню роботу з власних кредитів: вирішує для кожного учасника, чи може він їх витрачати, може задати йому місячний ліміт і бачить, скільки кожен витратив цього місяця, але ніколи не бачить їхніх проєктів і результатів. Власні кредити учасника заморожено, доки він не вийде з організації.
Сторінка «Витрати» помісячно показує кожен витрачений кредит за днями, видами роботи, проєктами й пошуками, а також зараховані кредити.

Асистент

ШІ-асистент є поруч із кожним етапом. Він пропонує регіони й типи місць за назвою та нотатками проєкту і сам їх задає; змінює фільтри, збагачення й фільтри результатів, заповнює ваші колонки й налаштовує ШІ-колонки (кожну зміну показано карткою, з якої її можна відкрити); рахує місця на пробному пошуку й у результатах, нічого не витрачаючи, і відповідає на запитання про проєкт і застосунок. Він ніколи не запускає пошук і не витрачає кредити. Він безкоштовний.

API

Публічний API для вашого власного коду зараз у розробці. Поки він не готовий, усе робиться у вебзастосунку; якщо вам потрібен програмний доступ, напишіть нам.

Підтримка

Якщо ви ввійшли, відкрийте розділ Підтримка у верхній панелі застосунку: ваші звернення й наші відповіді зберігаються там, а після підтвердження адреси надходять і на email. Якщо ні, напишіть нам зі сторінки контактів.