geonames search

Geonames Search

Geonames Search-это полнотекстовая служба поиска для контента Geonames, предназначенная для облегчения запроса географических данных с помощью простого и эффективного интерфейса. Эта служба, созданная с использованием Python, Flask и Opensearch, предоставляет надежную бэкэнд-инфраструктуру, использующую OpenSearch для хранения данных и полнотекстовых возможностей поиска, а также Redis для кэширования.

Примечание : это хобби -проект.

Функции

• Полнотекстовый поиск : быстро найдите географическую информацию, используя полнотекстовые возможности поиска OpenSearch.
• REST API : Поиск контента GeOnames с использованием прямой конечной точки /geonames?q=<query> .
• Масштабируемая инфраструктура : построена с Docker, чтобы обеспечить легко развертывание услуг и масштабировать.

Начиная

Эти инструкции дадут вам копию проекта и работают на местной машине для разработки и тестирования.

Предварительные условия

• Git
• Делать
• Python 3.9 или выше
• Управление поэтическими пакетами
• Docker и Docker Compose

Установка (Docker)

1. Клонировать репозиторий

git clone https://github.com/m3nin0-labs/geonames-search.git

cd geonames-search

2. Начните инфраструктуру

Используйте команду make up , чтобы запустить экземпляр Opensearch, Redis Cache и службу поиска Geonames.

make up

3. Индекс Geonames

Чтобы индексировать данные Geonames, вы можете использовать проект индекса Geonames.

Разработка

1. Клонировать репозиторий

git clone https://github.com/m3nin0-labs/geonames-search.git

cd geonames-search

2. Установите зависимости

Установите все необходимые зависимости от питона, используя поэзию.

poetry install --with dev

3. Запустите приложение

Начните приложение Flask.

FLASK_APP=geonames_api/main.py flask run

Теперь вы готовы к развитию!

Использование

Чтобы использовать службу поиска Geonames, просто отправьте запрос GET в конечную точку с помощью вашего поискового запроса:

 GET /geonames?q=London

Ответы будут включать в себя соответствующие географические данные из базы данных Geonames.

Внося

Мы приветствуем вклад! Если у вас есть предложения для улучшений или исправлений ошибок, пожалуйста, не стесняйтесь разорвать репозиторий и отправить запрос на привлечение.

Лицензия

geonames-search распределяется по лицензии MIT. Смотрите лицензию для более подробной информации.