GeoData.online – Tools for Google Sheets

GeoData.online– Tools for Google Sheets - це інструмент на базі Google Apps Script, який працює всередині Google Sheets і допомагає автоматизувати обробку табличних даних через API GeoData.online. Користувач запускає потрібний сценарій прямо з меню в Google Sheets, а результати обробки записуються назад у поточну таблицю.

Інструмент призначений для команд і спеціалістів, які працюють з адресами, геоданими та ПІБ у таблицях і хочуть виконувати масову обробку без ручного копіювання даних між сервісами.

Доступ до онлайн-довідників актуальних адрес України, Казахстану, Польщі, Чехії, Італії, Естонії, Румунії, Болгарії, Франції та Данії

Обробка баз даних: актуалізуємо, доповнюємо, структуруємо адресні бази даних

Додаткові сервіси:
пошук імені, зворотне геокодування, оцифровка анкет

Зареєструватися

Який функціонал надає інструмент

GeoData.online – Tools for Google Sheets надає такі основні можливості:

Деталізація адреси на окремі складові

Формування повної адреси з вхідних даних

Підготовка адресних полів для договорів і поштових конвертів

Транслітерація адресних даних для конвертів

Зворотне геокодування за координатами

Визначення міста за IP-адресою

Розбір ПІБ на складові

Відмінювання та транслітерація ПІБ

Як користувач працює з інструментом

Користувач відкриває Google Sheets, у якому встановлено інструмент.

У таблиці додаються вхідні колонки для потрібного сценарію, наприклад raw_address, raw_lat, raw_long, raw_ip або raw_fullname.

Користувач проходить авторизацію у своєму акаунті GeoData.online у вбудованому діалозі.

Після авторизації користувач обирає потрібний сценарій у меню GeoData.online.

Інструмент обробляє рядки пакетно, звертається до API GeoData.online лише для потрібного сценарію та записує результати в поточний Google Sheet.

Статус обробки та службовий прогрес відображаються у таблиці, щоб користувач бачив, які рядки вже опрацьовано.

Як саме працює обробка даних

Інструмент працює тільки в межах поточної Google-таблиці, відкритої користувачем. Він читає вхідні значення з колонок таблиці, надсилає тільки необхідні для вибраного сценарію дані до API GeoData.online, отримує результат обробки та записує його назад у цю саму таблицю.

Для великих наборів даних інструмент використовує пакетну обробку і службові тригери Google Apps Script, щоб продовжувати обробку частинами та не вимагати ручного запуску для кожного рядка.

Які дані використовує інструмент

Інструмент використовує лише ті дані, які потрібні для роботи вибраного сценарію:

Дані з поточної Google-таблиці, яку відкрив користувач

Службові параметри авторизації GeoData.online і технічний стан обробки, що зберігаються у властивостях Apps Script

Запити до зовнішнього API GeoData.online для виконання функцій обробки адрес, геоданих і ПІБ.

Інструмент не призначений для доступу до Gmail, Google Calendar, Google Contacts або інших сервісів Google, які не пов'язані з роботою поточної таблиці.

Користувацька цінність

GeoData.online – Tools for Google Sheets допомагає користувачам:

Зменшити ручну роботу при обробці адрес і ПІБ;

Швидше підготувати масиви даних для логістики, договорів, конвертів і CRM-процесів;

Стандартизувати результати обробки в одному Google Sheet;

Запускати масову обробку без написання коду та без ручних API-запитів.

Інструкція

Авторизація

У меню GeoData.online виберіть «🔐 Авторизація» та введіть логін і пароль.

Якщо у вас ще немає облікового запису, зареєструйтеся тут: Зареєструватися на GeoData.online

Запуск обробки

У меню «GeoData.online» відкрийте підменю «Адреси», «Гео-сервіси» або «ПІБ» і виберіть потрібний сценарій. Обробка виконується пакетами; розмір пакета налаштовується в коді (BATCH_SIZE).

Автоматичне продовження

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

Шаблон вхідних даних

У рядку 1 мають бути заголовки з префіксом raw_*:

Адреси: raw_address
Зворотне геокодування: raw_lat, raw_long
Місто за IP: raw_ip
ПІБ: raw_fullname

Прогрес відображається у заголовку колонки api_status, наприклад
api_status
progress: 10/50 (20%).

Поле api_status додається автоматично у першу порожню клітинку рядка 1. Одразу після нього автоматично створюється поле api_status_ts.

Обробляються лише рядки, де api_status порожній. Якщо у рядку вже є статус, такий рядок пропускається.

Автооновлення токена

Якщо токен протермінований, система намагається оновити його автоматично (refresh). Якщо оновлення не вдається, буде показано повідомлення про помилку і потрібно повторно авторизуватися.

Завершення

Після обробки всіх рядків тригер буде видалено автоматично, і статус у таблиці покаже 100%.

Опис меню

У меню «GeoData.online» доступні такі групи:

Адреси — 🅰️ Деталізувати (43), 🔤 Доповнити (1), ✉️ Розкласти для конвертів (6), ✉️ Трансліт для конвертів (6).
Гео-сервіси — 🌐 Зворотне геокодування (40), ℹ️ Визначити місто за IP (27).
ПІБ — 👤 Розбір на складові (7), 🗣️ Відмінювання + трансліт (23).
🟥 Зупинити обробку — встановлює прапорець зупинки і видаляє тригер; поточний пакет зупиняється або не продовжує обробку далі.
🔐 Авторизація — відкриває діалог для введення email і пароля; після успішної авторизації зберігається токен для викликів API.
Перевірити баланс — показує поточний баланс і статус акаунта.
Скинути авторизацію — видаляє збережений токен (logout) і відкриває форму авторизації для повторного входу.
❔ Довідка про GeoData.online — відкриває це вікно довідки з інструкціями та посиланнями.

Число в дужках у пунктах меню (наприклад, 43, 1, 6, 40, 27, 7, 23) — це орієнтовна кількість стовпчиків, які скрипт автоматично додасть у таблицю для відповідного сценарію.

Форматування виводу API: SexID: 1 - ч, 2 - ж, true/false - так/ні.

Оплата та тарифи

Увага: усі запити до API є платними. Деталі тарифів, пакети та умови використання можна переглянути на сторінці тарифів:

Переглянути тарифи GeoData.online

Поради при помилках авторизаці

Якщо при спробі авторизації ви бачите повідомлення про неправильні облікові дані (наприклад, invalid_grant), спробуйте:

Увійти на сайт account.geodata.online вручну і, за потреби, скинути пароль.
Переконатися, що акаунт підтверджено по email і немає блокувань або вимог CAPTCHA.
Якщо проблема повторюється, зверніться в підтримку GeoData з логами (HTTP‑код і тіло відповіді).

Додаткові примітки

Якщо потрібно тимчасово зупинити обробку, використовуйте «🟥 Зупинити обробку». Для діагностики помилок переглядайте журнал виконань у редакторі Apps Script (Executions / Logs).