Data referensi dan pengayaan
Tiga puluh empat juta baris, sebagai satu langkah
Negara, bahasa, dan mata uang. 13,4 juta tempat berpenduduk dan fitur geografis. 19 juta varian nama. Dua juta kode pos. Bandara, pelabuhan laut, merek kendaraan. Enam puluh lima endpoint, tanpa autentikasi, tanpa tarif, karena ini adalah platform yang sama dengan yang sudah menjalankan alur kerja Anda.
Mengapa ini tidak biasa
Pada setiap alat otomatisasi lainnya, "validasi alamat ini" adalah integrasi pihak ketiga berbayar. Anda mencari vendor, membuka akun, menyepakati daftar tarif, memperoleh kunci, menyimpan kunci, memantau kuota, dan merenegosiasi ketika volume Anda berubah. Pencarian itu sendiri hanya memakan dua puluh milidetik; pengadaannya memakan dua pekan.
Di sini, ini adalah satu langkah di pemilih. Datanya adalah data referensi publik — GeoNames, daftar kode resmi, register yang dipublikasikan — yang dibersihkan, diindeks, dan disajikan oleh castomAPI, yang hadir karena selusin produk di keluarga ini membutuhkan hal yang sama dan membangunnya sekali lebih murah daripada membangunnya dua belas kali.
Pencarian berbasis trigram dengan minimum tiga karakter, sehingga nama yang parsial atau salah eja tetap menemukan tempatnya. Minimum itu disengaja: dua karakter mencocokkan segalanya, dan pencarian yang mencocokkan segalanya lebih buruk daripada tidak ada pencarian.
Tiga hal yang dilakukan orang dengannya
Validasi — hentikan data buruk di pintu. Apakah itu kode pos yang nyata untuk kota itu? Apakah kode negara itu ada, atau itu salah ketik yang dibuat seseorang pada 2019 dan terus menyebar sejak saat itu? Apakah PLN sebuah mata uang, dan apakah itu mata uang yang seharusnya dipakai untuk menagih pelanggan ini?
Normalisasi — "Warsaw", "Warszawa", "Varsovie", dan "Варшава" adalah satu tempat dengan satu pengenal. Sembilan belas juta varian nama ada agar basis data pelanggan Anda tidak harus menyimpan empat ejaan kota yang sama dan berpura-pura itu empat kota.
Pengayaan — nama kota menjadi koordinat, zona waktu, wilayah administratif, dan angka populasi. Kode bandara menjadi nama dan lokasi. Kode pos menjadi segala hal di atasnya dalam hierarki. Enam bidang yang seharusnya diketik seseorang, terisi dalam dua puluh milidetik, tanpa biaya.
Zona waktunya adalah yang senyap
Menyelesaikan sebuah tempat memberi Anda zona waktunya, dan zona waktu itulah yang membuat "kirim ini pukul sembilan pagi" berarti pukul sembilan pagi bagi penerima, bukan pukul sembilan pagi bagi Anda. Jam tenang, jadwal, dan pengingat semuanya menjadi benar untuk daftar internasional tanpa ada yang perlu memelihara tabel pemetaan.
- 1Masukan"ul. Powstańców Śląskich 5, 53-332 Wrocław, PL"
- 2Kode pos cocok53-332 → Wrocław, Dolnośląskie, PL.
- 3Tempat teridentifikasi51.0938 N, 17.0226 E · Europe/Warsaw · populasi 674 079.
- 4Ditulis kembaliEnam kolom terisi yang biasanya harus diketik seseorang.
- §BiayaLangkah deterministik. Tanpa kunci, tanpa kuota, tanpa biaya per pencarian.
Waktu berlalu: 40 md65 endpoint tersedia
Tiga puluh empat juta baris. Satu langkah.
Contoh penerapan
Di mana ini membuktikan nilainya
Sebelum jasa pengiriman melihatnya
Alamat yang diperiksa dan dinormalisasi sebelum label pengiriman dibeli. Label yang ditolak menelan biaya dan satu hari; kode pos yang ditolak hanya menelan dua puluh milidetik.
Sebelum akuntan melihatnya
Kode mata uang dan kode negara divalidasi sebelum faktur dibuat, yang jauh lebih murah daripada memvalidasinya setelah faktur terkirim.
Menduplikasi sebuah daftar
Dua catatan dengan pelanggan yang sama di bawah dua ejaan kota yang sama dapat digabungkan dengan benar begitu kedua kota teratasi ke pengenal yang sama.
Perutean berdasarkan geografi
Koordinat pelanggan dan koordinat gudang Anda, dan proses memilih yang terdekat tanpa ada yang perlu memelihara lembar pemetaan kode pos ke gudang.
Bahasa, dengan benar
Sebuah negara teratasi ke bahasa-bahasanya, sehingga pesan yang keluar dalam bahasa yang mungkin dibaca penerima — diputuskan oleh data, bukan oleh asumsi tentang sebuah bendera.
Armada dan logistik
Merek kendaraan, bandara, dan pelabuhan laut sebagai catatan kanonik, untuk alur kerja yang pekerjaannya melibatkan sesuatu yang bergerak secara fisik.
Batas yang jujur
Ini adalah data referensi publik, bukan layanan verifikasi alamat komersial. Ini akan memberi tahu Anda bahwa 53-332 adalah kode pos yang nyata di Wrocław dan memberi Anda koordinat lokalitasnya. Ini tidak akan memberi tahu Anda apakah unit 212 ada di nomor 5, atau apakah ada yang tinggal di sana. Untuk verifikasi pada tingkat titik pengiriman, Anda membutuhkan produk operator pos nasional, dan sebuah alur kerja dapat memanggilnya melalui HTTP di samping ini.
Ini juga bukan sumber data pribadi. Tidak ada manusia di dalamnya. Isinya adalah tempat, kode, register, dan fakta publik — dan itulah tepatnya alasan ini dapat disajikan tanpa autentikasi.
Tentang kebaruan data: data referensi berubah perlahan, dan ini disegarkan sesuai jadwal, bukan terus-menerus. Desa yang baru berganti nama tidak akan muncul pada sore yang sama. Untuk hal yang berubah dari jam ke jam, Anda membutuhkan umpan peristiwa, yang memang dibangun untuk itu.