Тестовое задание «Разработчик Python»

Реализовать HTTP-сервер для предоставления информации по географическим объектам.

Порядок запуска скрипта

1. Установить необходимые зависимости pip install -r requirments.txt
2. Запустить скрипт python script.py

Описание методов

1. Метод принимает идентификатор geonameid и возвращает информацию о городе.

• Название функции - get_info(name_id)
• Пример запроса - http://127.0.0.1:8000/get_info/451749

Ответ

[
  {
    "geonameid":451749,
    "name":"Zhukovo",
    "asciiname":"Zhukovo",
    "alternatenames":"",
    "latitude":57.26429,
    "longitude":34.20956,
    "feature class":"P",
    "feature code":"PPL",
    "country code":"RU",
    "cc2":"",
    "admin1":"77",
    "admin2":"",
    "admin3":"",
    "admin4":"",
    "population":0,
    "elevation":"",
    "dem":237,
    "timezone":"Europe/Moscow",
    "date":"2011-07-09"
  }
]

2. Метод принимает страницу и количество отображаемых на странице городов и возвращает список городов с их информацией.

• Название функции - get_page()
• Пример запроса - http://127.0.0.1:8000/get_page?page=1&num=5

Ответ

[
  {"geonameid":451747,"name":"Zyabrikovo","asciiname":"Zyabrikovo","alternatenames":"","latitude":56.84665,"longitude":34.7048,"feature class":"P","feature code":"PPL","country code":"RU","cc2":"","admin1":"77","admin2":"","admin3":"","admin4":"","population":0,"elevation":"","dem":204,"timezone":"Europe/Moscow","date":"2011-07-09"},
  {"geonameid":451748,"name":"Znamenka","asciiname":"Znamenka","alternatenames":"","latitude":56.74087,"longitude":34.02323,"feature class":"P","feature code":"PPL","country code":"RU","cc2":"","admin1":"77","admin2":"","admin3":"","admin4":"","population":0,"elevation":"","dem":215,"timezone":"Europe/Moscow","date":"2011-07-09"},
  {"geonameid":451749,"name":"Zhukovo","asciiname":"Zhukovo","alternatenames":"","latitude":57.26429,"longitude":34.20956,"feature class":"P","feature code":"PPL","country code":"RU","cc2":"","admin1":"77","admin2":"","admin3":"","admin4":"","population":0,"elevation":"","dem":237,"timezone":"Europe/Moscow","date":"2011-07-09"},
  {"geonameid":451750,"name":"Zhitovo","asciiname":"Zhitovo","alternatenames":"","latitude":57.29693,"longitude":34.41848,"feature class":"P","feature code":"PPL","country code":"RU","cc2":"","admin1":"77","admin2":"","admin3":"","admin4":"","population":0,"elevation":"","dem":247,"timezone":"Europe/Moscow","date":"2011-07-09"},
  {"geonameid":451751,"name":"Zhitnikovo","asciiname":"Zhitnikovo","alternatenames":"","latitude":57.20064,"longitude":34.57831,"feature class":"P","feature code":"PPL","country code":"RU","cc2":"","admin1":"77","admin2":"","admin3":"","admin4":"","population":0,"elevation":"","dem":198,"timezone":"Europe/Moscow","date":"2011-07-09"}
]

3. Метод принимает названия двух городов (на русском языке) и получает информацию о найденных городах, а также дополнительно: какой из них расположен севернее и одинаковая ли у них временная зона и на сколько часов они различаются (когда несколько городов имеют одно и то же название, разрешать неоднозначность выбирая город с большим населением; если население совпадает, брать первый попавшийся)

• Название функции - get_compare()
• Пример запроса - http://127.0.0.1:8000/get_page?page=1&num=5

Ответ

[
  {"geonameid":452830,"name":"Ladnoye","asciiname":"Ladnoye","alternatenames":"Ladnoe,Ladnoye,Ладное","latitude":56.81009,"longitude":33.54139,"feature class":"P","feature code":"PPL","country code":"RU","cc2":"","admin1":"77","admin2":"","admin3":"","admin4":"","population":0,"elevation":"","dem":217,"timezone":"Europe/Moscow","date":"2012-01-16"},
  {"geonameid":451747,"name":"Zyabrikovo","asciiname":"Zyabrikovo","alternatenames":"","latitude":56.84665,"longitude":34.7048,"feature class":"P","feature code":"PPL","country code":"RU","cc2":"","admin1":"77","admin2":"","admin3":"","admin4":"","population":0,"elevation":"","dem":204,"timezone":"Europe/Moscow","date":"2011-07-09"},
  "Zyabrikovo",
  true,
  0
]

4. Метод принимает названия часть названия города и возвращает ему подсказку с возможными вариантами продолжений.

• Название функции - get_matches()
• Пример запроса - http://127.0.0.1:8000/get_matches?name=Ufa

Ответ

[
  "Ufa",
  "Verkhniy Ufaley",
  "Nizhniy Ufaley",
  "Ufa-Shigiri",
  "Ufa",
  "Novaya Ufa",
  "Novaya Ufa",
  "Novaya Ufa",
  "Ufa"
]