README

Выборка из базы ФИАС по субъектам Российской Федерации и их подчинённым населенным пунктам с добавлением Федеральных округов в формате json.

1. Базу ФИАС в формате sql можно скачать тут
2. Описание формата ФИАС лежит в папке doc
3. Можно воспользоваться готовым API для получения содержимого таблиц ФИАС
4. а можно воспользоваться файлом get.php в качестве своего API вот так http://localhost/get.php?parentguid=xxxx, где xxxx — это aoguid «верхнего субъекта», причём, если parentguid ничему не равен, то выдаются субъекты верхнего уровня. Нужно обратить внимание на отсутствие Федеральных округов и «нечистоту» информации, так как есть дубликаты, нужно обращать внимание на флаги актуальности и то, что верхние субъекты в ФИАС — это регионы в количестве 99-ти штук. Потому в папке source лежит уже подготовленный файл fias.subjects.json, содержащий 83 субъекта согласно конституции РФ, выдержку из которой можно посмотреть в файле docs/Russian districts.md.

Описание файла json/russia.json:

{
  "data": {
    "districts": [
      ... Федеральные округи
      ],
    "subjects": [
      ... Субъекты РФ
      ],
     "locality": [
      ... Населенные пункты
      ]
    }
}

Остальное несложно понять посмотрев содержимое файлов russia.federal-districts.json, russia. locality.json, russia.subjects.json, и ознакомившись с описанием формата ФИАС.

Файл index.html несёт в себе инструмент для генерации russia.json. Не было времени на реализацию вывода в DOM, но информативности вывода в консоли, думаю более чем хватит.