ブラックジャックとAPIを使用してアドレス情報のディレクトリを作成する

パート1。悲劇的。 「なぜこれが必要なのですか？！」

ユーザーの場所（登録、登録）に関する正しい情報を入力する必要性と、この問題が希望どおりに簡単かつ簡単に解決されないという事実にどうにか直面しました。 まず、自由形式のKLADRを試しました。 すべてが決定的に好きではなかったというわけではありませんが、少なくとも1つの非常に迷惑な状況がありました-一部のアドレスがディレクトリにありませんでした。 たとえば、家10がありますが、10k1-申し訳ありませんが、配信しませんでした。 一般に、KLADRは、アプリケーションに簡単に統合できますが、コンテンツによって反発されるシンプルなAPIとプラグイン（特にjQuery）を備えているという点で魅力的でした。 APIやプラグインを使用して、完全で最も関連性の高いアドレス情報を含むリソースがない場合、唯一の方法はそのようなリソースを自分で作成することです。

パート2.検索。 「犬はどこに埋葬されていますか？！」

また、FIASについても聞きました。 彼がどのように無限にいっぱいで美しいかについて。 そして、これが出口です！ FIAS Webサイトにはベースがあり、必要なのは成長している若い情報システムだけです！ 確かに、ベースのサイズは4 Gb以上ですが、まあ、これはすべてロシアです！ データベースは定期的に更新されるため、移動する場所があります。 ポイントは小さいです-データベースを拡張し、APIとプラグインを固定します。 関連する重要な記事がいくつかあることに注意してください。 たとえば、 これらの一連の記事は 、最初は非常に役立ちました。

パート3.「仕組み」

問題は、FIASデータベースが.dbf形式で配信されるという事実から始まりました。このデータは、何らかの形でPostgreSQLに転送され、データベースとして使用することが決定されました。

.dbf形式に加えて、データベースはxml形式で表示されることに注意してください。 ご存知のように、人はすべてを一度に望んでいます。 電源を入れて動作するようにします。 しかし、FIASが提供するものをすぐに理解することはかなり問題です。

そのため、更新セクションのfias.nalog.ruには次のものがあります。

• アップデートに関する情報：公式データによると、それらは少なくとも週に1回公開されます。 詳細は次のとおりです。 壊れた更新が出てくることがあります。 サイズは約1.2 Mbであり、ダウンロード時に破損したアーカイブが提供されるため、最新のアップデートのみに合わせて急いで調整すると問題が生じます。
  
  
• fias_delta_の形式の更新。 -.dbfおよび.xml形式。
• 実際にはfias_データベース。 -.dbfおよび.xml形式。
• KLADR形式のデータベース。 ファイルの名前は「Base。*」Arjまたは7zです。多くのフィールドが欠落している（税データなどに関して）ため、検索はKLADRovsky IDを使用して実行されます。 最初は、この特定の形式を使用する誘惑があります。これは、後で理解して実装するのが簡単だからです。 しかし、ポータルを詳しく調べてみると、このバージョンは2017年末までしかサポートされず、廃止されることが判明しています。

注：.dbfファイルを使用するには、php_dbase.dllのサードパーティの拡張機能をインストールする必要があります。

.xmlまたは.dbfをダウンロードするためにどのようなバージョンを選択するのでしょうか？ 違いは次のとおりです。

• xml-アーカイブ内の各ファイルは個別のテーブルです。 問題は何ですか？ たとえば、自宅で保存される「HOUSEXX」ファイルのサイズは、解凍された形式で20 Gbを超えます。 解析方法 一方、30 Gb以上のRAMがあれば、これは問題になりません。 また、SAX Parser for Javaなど、ファイル全体をメモリにロードせず、部分的に解析する有能なライブラリを熟知している場合は、何かが機能する可能性があります。
  
  
• dbf-ファイルはテーブルとして分割されるだけでなく、地域によっても分割されます。 広大な祖国の住所を必要とせず、1つの地域のみを必要とする場合（特定の場合のように）、より受け入れやすいオプションになります。

そのため、ファイルを解凍しました。 どのような情報が必要ですか？ 次のファイルセットが表示されます。

• ADDROBXX.DBF（XXは地域番号）-地域、自治区、都市およびその他の集落、道路に関するデータが直接含まれています。
• HOUSEXX.DBF、XXは地域番号で、家番号に関する情報が含まれています。
• NORDOCXX.DBF（XXは地域番号）には、さまざまなレコードの変更理由に関する情報が含まれています。
• ROOMXX.DBF、XX（地域番号）には、施設に関する情報が含まれています。
• STEADXX.DBF（XXは地域番号）には、土地区画に関する情報が含まれています。
• SOCRBASE.DBF-略語に関する情報が含まれています。
• STRSTAT.DBF-建物のタイプに関する情報が含まれています。

これらのテーブルに加えて、他のテーブルの略語に関する情報を含むサービステーブルがいくつかあります。

ほとんどの場合、家までの住所を作成するだけで十分です。 ただし、誰かがそれを必要とする場合は、さらに先に進むことができます。

したがって、postgresqlデータベースに2つのテーブルを作成します。

アドレス付きの表：

CREATE TABLE addrs ( "ACTSTATUS" integer, "AOGUID" character varying(36) COLLATE pg_catalog."default", "AOID" character varying(36) COLLATE pg_catalog."default", "AOLEVEL" integer, "AREACODE" integer, "AUTOCODE" integer, "CENTSTATUS" integer, "CITYCODE" integer, "CODE" character varying(20) COLLATE pg_catalog."default", "CURRSTATUS" integer, "ENDDATE" timestamp, "FORMALNAME" character varying(120) COLLATE pg_catalog."default", "IFNSFL" integer, "IFNSUL" integer, "NEXTID" character varying(36) COLLATE pg_catalog."default", "OFFNAME" character varying(120) COLLATE pg_catalog."default", "OKATO" VARCHAR(11), "OKTMO" VARCHAR(11), "OPERSTATUS" integer, "PARENTGUID" character varying(36) COLLATE pg_catalog."default", "PLACECODE" integer, "PLAINCODE" character varying(20) COLLATE pg_catalog."default", "POSTALCODE" integer, "PREVID" character varying(36) COLLATE pg_catalog."default", "REGIONCODE" integer, "SHORTNAME" character varying(15) COLLATE pg_catalog."default", "STARTDATE" timestamp, "STREETCODE" integer, "TERRIFNSFL" integer, "TERRIFNSUL" integer, "UPDATEDATE" timestamp, "CTARCODE" integer, "EXTRCODE" integer, "SEXTCODE" integer, "LIVESTATUS" integer, "NORMDOC" character varying(36) COLLATE pg_catalog."default", "PLANCODE" integer, "CADNUM" integer, "DIVTYPE" integer ) WITH ( OIDS = FALSE ) TABLESPACE pg_default; ALTER TABLE address OWNER to postgres; 

家番号のあるテーブル：

 CREATE TABLE hous ( "AOGUID" character varying(36) COLLATE pg_catalog."default", "BUILDNUM" character varying(10) COLLATE pg_catalog."default", "ENDDATE" timestamp, "ESTSTATUS" integer, "HOUSEGUID" character varying(36) COLLATE pg_catalog."default", "HOUSEID" character varying(36) COLLATE pg_catalog."default", "HOUSENUM" character varying(15) COLLATE pg_catalog."default", "STATSTATUS" integer, "IFNSFL" integer, "IFNSUL" integer, "OKATO" VARCHAR(11), "OKTMO" VARCHAR(11), "POSTALCODE" integer, "STARTDATE" timestamp, "STRUCNUM" VARCHAR(15), "STRSTATUS" integer, "TERRIFNSFL" integer, "TERRIFNSUL" integer, "UPDATEDATE" timestamp, "NORMDOC" character varying(36) COLLATE pg_catalog."default", "COUNTER" integer, "CADNUM" VARCHAR(50), "DIVTYPE" integer ) WITH ( OIDS = FALSE ) TABLESPACE pg_default; 

データのインポートは簡単です。 Excelでファイルを開き、csvとして保存します。 さらに、utf-8エンコーディングで表示されるxmlファイルとは異なり、dbfファイルはwin-866エンコーディングであるため、エンコーディングを変更することをお勧めします。 エディターでファイルを開き（メモ帳++がこの目的に適しています）、utf-8に変換します。

アドレス付きのインポートテーブル：

 COPY addrs FROM 'PathToTheFile\ADDROB01.csv' DELIMITER ';' CSV; 

家を含むインポートテーブル：

 COPY addrs FROM 'PathToTheFile\HOUSE30.csv' DELIMITER ';' CSV; 

ADDROBXXテーブルは何でできていますか？

豊富なフィールドにもかかわらず、必要なフィールドはごくわずかです。

• ACTSTATUS-フィールドには値0および1が含まれます。慎重に調べると、テーブルに同じ名前の多くの道路があることがわかります。 実際には、課税ベースにはオブジェクトの履歴が含まれています。 アドレス要素に発生した変更。 たとえば、レーニン通りは10個です。 これらのうち、9は無関係です。 別の方法で名前を変更または変更できます。 ACTSTATUS-0-無関係なアドレス、1-現在のみ。
• AOGUID-レコードID。 異なる履歴レコードについては、同じAOGUIDがあります。 AOIDフィールドが異なります。
• AOLEVEL-オブジェクトレベル。 番号1は連合の主題、4は都市、7は通りなどです。
• CENTSTATUS-センターのステータス。 たとえば、地域センターの都市。
• FORMALNAME-オブジェクトの名前。
• PARENTGUID-親要素のID。 通りが属する都市を検索するとき。 PARENTGUID通りはAOGUID通りと一致します。
• POSTALCODE-郵便番号。
• REGIONCODE-連合の主題のコード。

注：fias-nalog.ruには、すべてのフィールドの詳細な説明があります。

HOUSEXXテーブルで重要：

• AOGUID-家があるADDROBXXのストリートID。
• HOUSEGUID-家のID。
• 難しさは家の名前にあります。 4つのフィールドで構成されます。
• BUILDNUM-ケース番号。
• HOUSENUM-家番号。
• STRUCNUM-建物番号。
• STRSTATUSは構造のサインです（0から4まで、0はなし、1は構造、2は構造、3は文字）。

フィールドには、類似または同一の情報を含めることができ、実験的に状況から抜け出す必要があります。 QuerryControllerクラスにメソッド（以下のリポジトリへのリンク）があります：chooseBuilding。この問題を解決しようとしました。 たぶん誰かが良くなるでしょう。 データベースクエリは同じ場所にあります。

さらに、データベースがPostgresにインポートされた後、システム用のAPIとプラグインの作成を開始しました。

APIでは、キャストしないように、Laravelを使用しました。 クエリスキームは非常に単純であることが判明しました。 オブジェクトの階層は次のとおりです。

• 連合の主題
• 連合の主題の地域
• 局所性
• 通り
• ハウス

ところで、システムをテストするときに、すべての集落に通りがあるわけではなく、すべての通りに家があるわけではないという事実に直面しました。 ユーザーが自分で情報を入力する機会をユーザーに提供すると、ユーザーはそれを書いて、「これらの人々は学校で勉強しましたか？！」
したがって、ユーザーにイニシアチブのわずかな機会を与えるのではなく、そのような「欠落」アドレスに対して、欠落しているアドレスをヘルプシステムに含めることを申請する機会を提供することにしました。

クエリスキーマはシンプルに見えます。

• myfias / choose_dstrict-フェデレーションエンティティのリスト
• myfias / choose_region {district_aoguid}-フェデレーションのサブジェクトのリージョンのリスト
• myfias / choose_city {region_aoguid}-地域の集落のリスト
• myfias / choose_street {city_aoguid}-都市通りのリスト
• myfias / choose_building {street_aoguid}-村のストリートハウスのリスト

最後の段落では、手紙、建物、建物などのある家のリストが作成されます。
すべての試練の後、ディレクトリとjQueryでの代替として機能するために、vue.jsでプラグインを作成しました。

地域と地区は都市と一緒にまとめられているため、不必要に削除できます。
KLADRのように、入力時にオートコンプリートプロンプトがポップアップします。 確かに、KLADRプラグインは自動補完用に設計されていますが、ここではプロンプトから選択されたアドレスのみが有効と見なされます。

ASPUDcomponentフォルダー-アドレスデータベースを操作するためのVueJsコンポーネントがあります。
ソースはリポジトリで入手できます 。

パート4.すべてを更新する方法は？

更新の状況は次のとおりです。最初に、SOAPを介して更新バージョンを取得する必要があります。 UpdateControllerクラス（メソッド：filesVersions（））でこれがどのように行われるかを見ることができます。

注：受信したリストの最後にリストされているバージョンは、メインページでダウンロードできるバージョンと必ずしも一致しません。 ただし、急いで最新バージョンのみをダウンロードしないでください。「バット」になることがあります。 そのような先例がありました。 次に、最新バージョンのアーカイブがダウンロードされ、解凍されます。 動作させるには、phpの拡張機能（php_rar.dll）を使用する必要があります。

それでは、データベースを更新するために必要なリージョンファイル（または必要に応じてすべてのファイル）が選択されます。