Data rujukan dan pengayaan
Tiga puluh empat juta baris, sebagai satu langkah
Negara, bahasa dan mata wang. 13.4 juta tempat berpenduduk dan ciri geografi. 19 juta varian nama. Dua juta poskod. Lapangan terbang, pelabuhan laut, jenama kenderaan. Enam puluh lima titik akhir, tiada pengesahan, tiada kad kadar, kerana ia platform yang sama di mana aliran kerja Anda sudah berjalan.
Mengapa ini luar biasa
Dalam setiap alat automasi lain, "sahkan alamat ini" ialah integrasi pihak ketiga berbayar. Anda mencari pembekal, membuka akaun, bersetuju dengan kad kadar, mendapatkan kunci, menyimpan kunci, memantau kuota, dan merundingkan semula apabila volum anda berubah. Carian itu sendiri mengambil masa dua puluh milisaat; perolehan mengambil masa dua minggu.
Di sini ia merupakan langkah dalam pemilih. Data ini ialah data rujukan awam — GeoNames, senarai kod rasmi, daftar yang diterbitkan — dibersihkan, diindeks dan disajikan oleh castomAPI, yang wujud kerana sedozen produk dalam keluarga ini memerlukan perkara yang sama dan membina sekali lebih murah daripada membina dua belas kali.
Carian berasaskan trigram dengan minimum tiga aksara, jadi nama separa atau tersalah ejaan masih menemui tempat tersebut. Minimum itu adalah sengaja: dua aksara memadankan segala-galanya, dan carian yang memadankan segala-galanya lebih teruk daripada tiada carian.
Tiga perkara yang dilakukan orang dengannya
Sahkan — hentikan data buruk di pintu. Adakah itu kod pos sebenar untuk bandar itu? Adakah kod negara itu wujud, atau ia salah taip yang dibuat seseorang pada 2019 dan telah tersebar sejak itu? Adakah PLN satu mata wang, dan adakah ia mata wang yang sepatutnya dikenakan kepada pelanggan ini?
Normalkan — "Warsaw", "Warszawa", "Varsovie" dan "Варшава" ialah satu tempat dengan satu pengecam. Sembilan belas juta varian nama wujud supaya pangkalan data pelanggan anda tidak perlu menyimpan empat ejaan bandar yang sama dan berpura-pura ia empat bandar.
Perkayakan — nama bandar menjadi koordinat, zon waktu, wilayah pentadbiran dan angka penduduk. Kod lapangan terbang menjadi nama dan lokasi. Kod pos menjadi segala-galanya di atasnya dalam hierarki. Enam medan yang sebaliknya perlu ditaip oleh seseorang, diisi dalam dua puluh milisaat, tanpa bayaran.
Zon waktu ialah yang paling senyap
Menyelesaikan sesuatu tempat memberikan anda zon waktunya, dan zon waktu ialah yang menjadikan "hantar ini pada pukul sembilan pagi" bermakna pukul sembilan pagi bagi penerima dan bukannya pukul sembilan pagi bagi anda. Waktu senyap, jadual dan peringatan semuanya menjadi tepat untuk senarai antarabangsa tanpa sesiapa perlu menyenggara jadual pemetaan.
- 1Input"ul. Powstańców Śląskich 5, 53-332 Wrocław, PL"
- 2Poskod dipadankan53-332 → Wrocław, Dolnośląskie, PL.
- 3Tempat diselesaikan51.0938 U, 17.0226 T · Europe/Warsaw · penduduk 674 079.
- 4Ditulis semulaEnam medan diisi yang sebaliknya perlu ditaip oleh seseorang.
- §KosLangkah deterministik. Tiada kunci, tiada kuota, tiada caj setiap carian.
Masa berlalu: 40 ms65 titik akhir tersedia
Tiga puluh empat juta baris. Satu langkah.
Contoh kerja
Di mana ia membuktikan nilainya
Sebelum pengangkut melihatnya
Alamat disemak dan dinormalkan sebelum label penghantaran dibeli. Label yang ditolak menelan kos yuran dan sehari; kod pos yang ditolak hanya menelan kos dua puluh milisaat.
Sebelum akauntan melihatnya
Kod mata wang dan kod negara disahkan sebelum invois diterbitkan, yang jauh lebih murah daripada mengesahkannya selepas invois dihantar.
Menyahpendua senarai
Dua rekod dengan pelanggan yang sama di bawah dua ejaan bandar yang sama digabungkan dengan betul sebaik sahaja kedua-dua bandar diselesaikan kepada pengecam yang sama.
Penghalaan mengikut geografi
Koordinat untuk pelanggan dan koordinat untuk depot anda, dan larian memilih yang terdekat tanpa sesiapa perlu menyenggara hampir kod-pos-ke-depot.
Bahasa, dengan betul
Negara diselesaikan kepada bahasanya, jadi mesej yang dihantar adalah dalam bahasa yang mungkin difahami penerima — diputuskan oleh data dan bukannya andaian tentang bendera.
Armada dan logistik
Jenama kenderaan, lapangan terbang dan pelabuhan laut sebagai rekod kanonik, untuk aliran kerja yang tugasnya melibatkan sesuatu yang bergerak secara fizikal.
Had yang jujur
Ini ialah data rujukan awam, bukan perkhidmatan pengesahan alamat komersial. Ia akan memberitahu anda bahawa 53-332 ialah kod pos sebenar di Wrocław dan memberikan anda koordinat kawasan setempat. Ia tidak akan memberitahu anda sama ada unit 212 wujud di nombor 5, atau sama ada ada sesiapa tinggal di situ. Untuk pengesahan pada peringkat titik penghantaran, anda memerlukan produk pengendali pos negara, dan aliran kerja boleh memanggilnya melalui HTTP bersama-sama ini.
Ia juga bukan sumber data peribadi. Tiada manusia di dalamnya. Ia mengandungi tempat, kod, daftar dan fakta awam — dan itulah sebabnya ia boleh disajikan tanpa pengesahan.
Tentuk kesegaran: data rujukan berubah perlahan, dan ini dikemas kini mengikut jadual dan bukannya berterusan. Kampung yang baru dinamakan semula tidak akan muncul pada petang yang sama. Untuk apa-apa yang berubah setiap jam, anda memerlukan suapan peristiwa sebaliknya, yang dibina khusus untuk itu.