Data rujukan lan pangayuhan
Telung puluh papat yuta baris, dadi siji langkah
Negara, basa lan mata uang. 13,4 yuta panggonan padunung lan fitur geografis. 19 yuta varian jeneng. Loro yuta kode pos. Bandara, pelabuhan laut, merek kendharaan. 65 endpoint, tanpa autentikasi, tanpa tarif, awit iku platform sing padha karo panggonan alur kerja sampeyan lumaku.
Ngapa iki beda
Ing alat otomatisasi liyane, "validasi alamat iki" yaiku integrasi pihak katelu sing mbayar. Sampeyan goleki vendor, gawé akun, sarujuk tarif, njupuk kunci, nyimpen kunci, ngawasi kuota, lan rembug maneh nalika volume sampeyan owah. Panyuwunane mung puluh milidetik; ngurusi procurement butuh rong minggu.
Ing kene iku mung siji langkah ing pamilih. Datane yaiku data rujukan publik — GeoNames, dhaftar kode resmi, register sing diterbitake — dibersihake, diindeks lan disajekake dening castomAPI, sing ana awit akeh produk ing kulawarga iki butuh padha, lan mbangun sepisan luwih murah tinimbang mbangun ping rolas.
Panggolekan nganggo trigram kanthi minimal telung aksara, saengga jeneng sing setengah utawa salah ejaan isih bisa nemu panggonane. Wates minimal iku disengaja: rong aksara cocog karo kabeh, lan panggolekan sing cocog karo kabeh luwih ala tinimbang ora ana panggolekan.
Telung perkara sing ditindakake wong nganggo iki
Validasi — nyandhak data ala ing lawang. Apa iku kode pos sing bener kanggo kutha kuwi? Apa kode negara kasebut ana, utawa mung salah ketik sing digawe wong ing 2019 lan terus nyebar nganti saiki? Apa PLN iku mata uang, lan apa iku sing bener kanggo ngenakke pelanggan iki?
Normalisasi — “Warsaw”, “Warszawa”, “Varsovie” lan “Варшава” iku siji panggonan kanthi siji identifikasi. Ana sangalas yuta varian jenang supaya basis data pelanggan sampeyan ora perlu nyimpen papat ejaan saka kutha sing padha banjur nganggep papat kutha.
Ngayahi — jeneng kutha dadi koordinat, zona wektu, wilayah administratif lan cacahing padunung. Kode bandara dadi jeneng lan lokasi. Kode pos dadi kabeh sing ana ing dhuwure ing hirarki. Enem kolom sing bakal diketik wong, keisi ing rongpuluh milidetik, tanpa biaya.
Zona wektu iku sing paling sepi
Nemtokake siji panggonan menehi zona wektune, lan zona wektu sing nggawe “kirim iki jam sangang esuk” ateges jam sangang esuk kanggo sing nampa, dudu jam sangang esuk kanggo sampeyan. Jam sepi, jadwal lan pangeling dadi bener kabeh kanggo dhaftar internasional tanpa ana sing kudu ngurusi tabel pemetaan.
- 1Lelebonan“ul. Powstańców Śląskich 5, 53-332 Wrocław, PL”
- 2Kode pos cocog53-332 → Wrocław, Dolnośląskie, PL.
- 3Panggonan ditemokake51.0938 N, 17.0226 E · Eropa/Warsaw · padunung 674 079.
- 4Ditulis baliEnem kolom sing keisi, sing biasane kudu diketik wong.
- §BiayaLumebet sing mesthi. Ora ana kunci, ora ana kuota, ora ana biaya saben panggolekan.
Wektu liwat: 40 ms65 endpoint kasedhiya
Telung puluh papat yuta baris. Siji lumebet.
Tuladha panggunaan
Nggone migunani
Sadurunge tekan tangan kurir
Alamat dicek lan dinormalisasi sadurunge label pangiriman dituku. Label sing ditolak mbutuhake biaya lan sedina; kode pos sing ditolak mung rongpuluh milidetik.
Sadurunge tekan tangan akuntan
Kode mata uang lan kode negara divalidasi sadurunge faktur digawe, sing luwih murah tinimbang validasi sawise faktur wis dikirim.
Nyingkirake duplikat ing dhaftar
Rong cathetan kanthi pelanggan sing padha nanging ejaan kutha sing beda bisa digabung kanthi bener yen loro kutha kasebut nuduhake identifikasi sing padha.
Rute adhedhasar geografi
Koordinat pelanggan lan koordinat gudang sampeyan, banjur proses milih sing paling cedhak tanpa ana sing kudu ngurusi spreadsheet kode-pos-menyang-gudang.
Basa, kanthi bener
Negara dadi basa-basane, saengga pesen sing dikirim nganggo basa sing mbokmenawa dingerteni sing nampa — ditetepake dening data, dudu dening anggapan babagan bendera.
Armada lan logistik
Merek kendharaan, bandara lan pelabuhan laut minangka cathetan kanonik, kanggo alur kerja sing ngurusi barang sing obah kanthi fisik.
Watesan sing jujur
Iki data referensi umum, dudu layanan verifikasi alamat komersial. Bakal ngandhani yen 53-332 iku kode pos sing bener ing Wrocław lan menehi koordinat lokasine. Ora bakal ngandhani apa unit 212 ana ing nomer 5, utawa apa ana sing manggon ing kono. Kanggo verifikasi tingkat titik pangiriman, sampeyan butuh produk operator pos nasional, lan alur kerja bisa nyeluk liwat HTTP bebarengan karo iki.
Iki uga dudu sumber data pribadi. Ora ana wong ing jerone. Isine panggonan, kode, daftar lan fakta umum — mula bisa diwenehake tanpa autentikasi.
Babagan kesegaran: data referensi owah kanthi alon, lan iki dianyari miturut jadwal, dudu terus-terusan. Desa sing mentas diganti jenenge ora bakal muncul sore uku. Kanggo apa wae sing owah saben jam, sampeyan butuh umpan acara, sing memang digawe kanggo kuwi.