2GIS API client

Краткое назначение

Python SDK и CLI для 2GIS Catalog/Search API с дополнительными инструментами анализа офлайн-пакетов.

Бизнес-задача

2GIS API предоставляет данные о местах, геокодинге, подсказках, категориях и регионах. Проект упрощает доступ к этим данным и добавляет исследовательские инструменты для офлайн .dgdat пакетов.

Техническое решение

Клиент поддерживает Places, Geocoder, Suggest, Categories, Regions и Markers API, GET/POST transport, retry/backoff, response models, pagination helper и convenience-методы для регионов и категорий.

Архитектура

Python package с CLI entrypoint;
API client layer;
response models: ApiResponse, Page, Entity;
pagination helper iter_places;
.dgdat extractor;
ZIP/MSI sync and extraction flow;
JSON export для структуры и секций.

Стек

Python 3.11, CLI, 2GIS API, retry/backoff, JSON export, ZIP/MSI processing, .dgdat analysis.

Интеграции

2GIS Catalog/Search API;
2GIS offline packages;
local JSON artifacts.

Ограничения и риски

API зависит от ключа 2GIS и лимитов. .dgdat анализ является исследовательским инструментом и не должен позиционироваться как официальный формат 2GIS.

Что показывает в портфолио

SDK-разработку, CLI tooling, работу с внешними API и исследовательский data analysis вокруг сложных форматов.