हम अपने लाभ के लिए अपने आवेदन में पोस्टल कोड का उपयोग करते हैं

मुझे लगता है कि कई साइटों पर उपयोगकर्ता से उसका भौतिक पता पूछा जाएगा। चाहे डिलिवर करना हो, पेपर स्पैम नोटिफिकेशन भेजना हो। और, सामान्य तौर पर - यह एक तिपहिया है। मैंने सूचकांक, मॉस्को, क्षेत्र, जिला, गांव, सड़क, घर, अपार्टमेंट को निकाल दिया। ऐसा लगता है कि सरल करने के लिए कुछ है, हर कोई उसके पते को याद करता है, क्या इसे चलाना मुश्किल है? लेकिन शैतान, हमेशा की तरह, विवरण में है: उपयोगकर्ता पते में सील है, पैकेज गलत तरीके से जाता है, "अच्छा" की किरणें आपकी प्रतिक्रिया में जाती हैं और सामान्य जीवन में खराब हो जाती हैं।

पते के पहले भाग पर एक नज़र डालें - सूचकांक। छह अंकों के इस सेट में पहले से ही एक क्षेत्र, एक जिला और एक शहर / गाँव है। उन्हें स्वचालित रूप से प्रतिस्थापित किया जा सकता है। यह दो पक्षियों को एक पत्थर से मार देगा:

• हम उपयोगकर्ता को त्रुटियों से बचाएंगे (यदि आप गलत सूचकांक दर्ज करते हैं, तो वह तुरंत ध्यान देगा कि शहर उसका नहीं है), जो, यदि कोई संदेश वितरित किया जाता है (या यहां तक ​​कि एक पार्सल), तो इसे जल्दी से ठंडा कर सकते हैं (जब तक कि वे इसे गलत सूचकांक द्वारा नहीं भेजते हैं, लेकिन जब तक वे इसका पता नहीं लगाते हैं, तब तक) उन्होंने इसे वहां नहीं भेजा, लेकिन वे इसे वहीं भेजते हैं - उपयोगकर्ता आपके लिए पूरा गंजा पैच खा जाएगा)
• उपयोगकर्ता प्रसन्न होगा कि वे उसकी देखभाल करते हैं :-)

बिंदु छोटा है: हमें एक ज़िप कोड डेटाबेस की आवश्यकता है।

और वह है! सबसे छोटा, इलेक्ट्रॉनिक और, सबसे महत्वपूर्ण बात, रूसी पोस्ट से आधिकारिक सूचकांक डेटाबेस।

मिलिए: vinfo.russianpost.ru/database/ops.html

डेटाबेस युवा डेवलपर्स डीबीएफ प्रारूप के लिए पहले से ही बाहर के प्रारूप में उपलब्ध है और नियमित रूप से (महीने में दो बार) अपडेट किया जाता है।

बेशक, यह डेटाबेस विस्तार से FIAS तक नहीं पहुंचता है, लेकिन यह इसके कारण, यह बहुत सरल (सिर्फ एक तालिका!) देने के लिए सार्थक है, इसलिए, यदि आपको सड़क और घर पर सटीकता की आवश्यकता नहीं है, लेकिन केवल गांव ही पर्याप्त है - आप यहां हैं

हम खुशी को उपवास करते हैं ... ठीक है, चलो साइट पर जाएं।

इसलिए, हम खुशी से आधार को डाउनलोड करते हैं और सोचते हैं कि कैसे इसे काकतमुनस मोडर्नक्यूएल (या यहां तक ​​कि नॉनएसक्यूएल) में उपयोग किया जाए।

हम Google में खोज करते हैं, हम Yandex में खोजते हैं, हम apt-cache में खोज करते हैं, बाद वाला आनंद हमें देता है:

envek@envek-work:~$ apt-cache search dbf pgdbf - converter of XBase / FoxPro tables to PostgreSQL dbf2mysql - xBase <--> MySQL 

महान, कैसे! मैं Postgres का उपयोग करता हूं और मैं इसे परिवर्तित कर दूंगा। आधार dosovskaya एन्कोडिंग का भी उपयोग करता है, इसलिए हम सहायता के लिए iconv को कॉल करेंगे। वैसे, pgdbf (> = 0.6.2) के नवीनतम संस्करण स्वयं शर्मिंदगी और कॉल आइकनव हैं, लेकिन वे अभी तक उबंटू रिपॉजिटरी तक नहीं पहुंचे हैं।

 mv {PIndx08,post_indices}.dbf #  ,     pgdbf -u post_indices.dbf | iconv -f CP866 > post_indices.sql #  

खैर, अब हमें इसे काम करने की जरूरत है।

मैं रूबी ऑन रेल्स का उपयोग करता हूं, और मैं इसे एक उदाहरण के साथ दिखाता हूं। जो रेल को नहीं समझता है, वह स्क्रॉल कर सकता है।

हम एक मॉडल बनाते हैं जो डेटाबेस से हमारी जानकारी होगी और आवेदन में प्रतिनिधित्व करेगी

 rails g model PostIndex 

माइग्रेशन में, हम मूल डेटाबेस से तालिका संरचना को ध्यान से कॉपी करते हैं, इंडेक्स को प्राथमिक कुंजी बनाते हैं:

 class CreatePostIndices < ActiveRecord::Migration def change create_table :post_indices, id: false do |t| t.string :index, limit: 6 t.string :ops_name, limit: 60 t.string :ops_type, limit: 50 t.string :ops_subm, limit: 6 t.string :region, limit: 60 t.string :autonom, limit: 60 t.string :area, limit: 60 t.string :city, limit: 60 t.string :city_1, limit: 60 t.date :act_date t.string :index_old, limit: 6 t.index :index_old end reversible do |to| to.up do execute 'ALTER TABLE post_indices ADD PRIMARY KEY (index);' end end end end 

थोड़ा अनुकूलन मॉडल:

 class PostIndex < ActiveRecord::Base self.primary_key = 'index' end 

हम एक सरल कंट्रोलर बनाते हैं जो हमें जिप कोड को json फॉर्मेट में देगा:

 #  : rails generate controller PostIndices class PostIndicesController < ApplicationController def get @index = PostIndex.where(index: params[:index]).first @index = PostIndex.where(index_old: params[:index]).order(:index).first! unless @index respond_to do |format| format.json { render json: @index.to_json(only: [:index, :region, :area, :city]) } end end end 

हम कॉन्फ़िगर / मार्गों में लिखते हैं। उस मार्ग पर जिसके साथ आवेदन हमारे लिए वांछित अनुक्रमित लौटाएगा:

 get '/post_index/:index(.:format)', controller: :post_indices, action: :get 

और, सबसे महत्वपूर्ण: html और जावास्क्रिप्ट, जो उपयोगकर्ता के लिए सभी जादू करेगा।

HTML फॉर्म:

 <form id='address_form'> <table> <tr> <td><label for='address_postcode'> </label></td> <td> <input class='postcode_field' id='address_postcode' name='address[postcode]'> <p class='description'>   ,  «», «»  «»  .</p> </td> </tr> <tr> <td><label for='address_region'>//</label></td> <td><input class='region_field' id='address_region' name='address[region]'></td> </tr> <tr> <td><label for='address_area'></label></td> <td><input class='area_field' id='address_area' name='address[area]'></td> </tr> <tr> <td><label for='address_city'>/</label></td> <td><input class='city_field' id='address_city' name='address[city]'></td> </tr> </table> </form> 

जावास्क्रिप्ट कोड (उपयोगकर्ता अधिसूचना के साथ, त्रुटियों को पकड़ने और सूचकांक को ठीक करने के लिए बहुत विस्तृत)

 jQuery(document).ready(function($){ $('.postcode_field').on('keyup change', function () { //    var postcode_field = $(this); var form = postcode_field.parents("form"); var region_field = $('.region_field', form); var area_field = $('.area_field', form); var city_field = $('.city_field', form); //    region_field.val(''); area_field.val(''); city_field.val(''); //     -     var postcode = this.value; if (postcode.length == 6) { jQuery.ajax({ dataType: "jsonp", url: 'http://postindexapi.ru/'+postcode+'.json?callback=?', beforeSend: function() { //  ,    $("td:last-child p.description.notice, td:last-child p.description.alert", postcode_field.parents("tr")).remove(); $('<p class="description notice loading"></p>').text("…").appendTo($("td:last-child", postcode_field.parents("tr"))) }, success: function(data){ postcode_field.val(data.index); region_field.val(data.region); area_field.val(data.area); city_field.val(data.city); if (data.index != postcode) { var message = "    : "+postcode+",   : "+data.index; $('<p class="description notice"></p>').text(message).appendTo($("td:last-child", postcode_field.parents("tr"))) } }, error: function (jqxhr, status, e) { var message = '       !'+e; if (e == 'Not Found') message = '      '; if (status == 'timeout') message = '     .   .'; $('<p class="description alert"></p>').text(message).appendTo($("td:last-child", postcode_field.parents("tr"))) console.debug(jqxhr, status, e); }, complete: function () { //   $("td:last-child p.description.loading", postcode_field.parents("tr")).remove(); } }); } }); }); 

और, वॉयला, जब आप इंडेक्स में प्रवेश करते हैं, तो हम स्वचालित रूप से इस क्षेत्र, शहर, और इसी तरह से स्थानापन्न करते हैं। एक ही समय में, बोनस के रूप में, हम मौजूदा लोगों के लिए पुराने सूचकांकों को सही कर सकते हैं (बहुत बार लोगों के पास पहले से ही पुरानी पुरानी सूचकांक वाले रिश्तेदारों के पते हैं)।



एक और बात: डेटाबेस को हमेशा ताज़ा रखने के लिए, एक रेक कार्य बनाएं, जो मुकुट पर चलेगा, हर दो सप्ताह में कहें, और यह सब हमारे लिए करें (जेमफाइल में आपके पास gem 'nokogiri' नोकगिरी gem 'nokogiri' होनी चाहिए, आप require: false साथ require: false ) :

 require 'open-uri' require 'fileutils' require 'nokogiri' namespace :post_index do desc 'Update used post indices database to latest' task update: :environment do # Get info about post indices database url_prefix = 'http://info.russianpost.ru/database' doc = Nokogiri::HTML(open("#{url_prefix}/ops.html")) file = doc.at_css('a[name=newdbdata]+table tr:last-child td:nth-child(4) a').attr :href FileUtils.mkdir_p "#{Rails.root}/tmp/post_indices" dir = Pathname.new("#{Rails.root}/tmp/post_indices") filepath = Pathname.new("#{dir}/#{file}") filepath_success = Pathname.new("#{dir}/#{file}.success") if filepath.exist? and filepath_success.exist? puts 'Already up-to-date.' else # Download, unzip, rename and convert post indices file sh "wget #{url_prefix}/#{file} -O #{filepath}" sh "unzip -o #{filepath} -d #{dir}" dbf_filename = filepath.to_s.gsub /\.zip$/, '.DBF' sh "cp -f #{dbf_filename} #{dir}/post_indices.dbf" sh "pgdbf -u #{dir}/post_indices.dbf | iconv -f CP866 > #{dir}/post_indices.sql" # Import in database config = Abitur::Application.config.database_configuration[::Rails.env] dbh, dbu, dbp, db = config['host'], config['username'], config['password'], config['database'] sh "PGPASSWORD=#{dbp} psql -U #{dbu} -w -h #{dbh} #{db} < #{dir}/post_indices.sql" # Clean up FileUtils.rm [dbf_filename, "#{dir}/post_indices.dbf", "#{dir}/post_indices.sql"], force: true FileUtils.touch filepath_success end end end 

सारांश

पेशेवरों : कार्यान्वयन, उपयोग और रखरखाव में आसानी, अप टू डेट, कम वजन
विपक्ष : कम विस्तार (केवल निपटान के लिए), कैप की सभी सीटें, रूस, मेल का मेल क्यों?

और आलसी के लिए

खैर, और अंत में। यदि आपको इस तरह की एक ट्रिफ़ल पसंद है, लेकिन आप हिंसक रूप से इस जानकारी को अपने आवेदन में नहीं खींचना चाहते हैं, तो मैंने आपके लिए विशेष रूप से एक मिनी-सर्विस postindexapi.ru बनाया है। जो मैंने ऊपर वर्णित किया है - JSON में सूचकांक के बारे में जानकारी देता है। अपने स्वास्थ्य का उपयोग करें! निर्देश संलग्न हैं।

कृतज्ञता के साथ, पुल अनुरोध और बग रिपोर्ट भी स्वीकार किए जाते हैं, साथ ही साथ जीथब रिपॉजिटरी में किसी भी सुझाव और सुझाव: github.com/Envek/postindexapi.ru

आपका ध्यान देने के लिए धन्यवाद।

UPD : 2018 तक, विलुप्त हो चुकी मिनी-सर्विस postindexapi.ru काम करने की स्थिति में अलेक्सा का समर्थन करती है, जिसके लिए उसे बहुत धन्यवाद। इसकी सेवा का एपीआई लेख में दिए गए से अलग है, इसलिए अलग जावास्क्रिप्ट कोड का उपयोग करें ।