Memvalidasi Alamat dengan ShipEngine
Made by ShipEngine
Memvalidasi alamat berdasarkan konten dokumen yang ditulis ke koleksi Cloud Firestore tertentu.
Cara kerja ekstensi ini
Gunakan ekstensi ini untuk memastikan alamat surat yang valid di seluruh dunia dengan ShipEngine ShipEngine. ShipEngine mereferensikan silang berbagai database untuk memvalidasi alamat dan mengidentifikasi kemungkinan masalah keterkiriman saat pengiriman. Hal ini membantu brand, platform e-commerce, dan logistik pihak ketiga untuk menghindari pengembalian barang yang seharusnya tidak perlu dan biaya jasa kurir tambahan.
Hampir semua negara di dunia didukung, termasuk Amerika Serikat, Kanada, Inggris Raya, Australia, Jerman, Prancis, Norwegia, Spanyol, Swedia, Israel, Italia, serta lebih dari 160 negara lainnya. Beragam level validasi tersedia di berbagai negara. Misalnya, suatu negara dapat memvalidasi sampai dengan nomor kamar/unit, dan negara lain mungkin hanya dapat memvalidasi sampai level kota. Lihat daftar lengkap negara dan level validasinya
Berikut adalah contoh dasar penulisan dokumen yang akan memicu ekstensi ini:
admin .firestore() .collection('addresses') .add({ address: { name: 'John Smith', addressLine1: '200 Sunrise Mall', cityLocality: 'Massapequa', stateProvince: 'NY', postalCode: '11758', countryCode: 'US', }, });
Penyiapan tambahan
Sebelum menginstal ekstensi ini, pastikan Anda telah menyiapkan database Cloud Firestore di project Firebase.
Anda juga harus membuat akun ShipEngine atau menggunakan akun yang sudah ada dan memberikan Kunci API ShipEngine Anda dari halaman Pengelolaan API ShipEngine ketika mengonfigurasikan ekstensi ini.
Penagihan
Untuk menginstal ekstensi, project Anda harus menggunakan paket Blaze (bayar sesuai penggunaan)
- Anda akan dikenai sedikit biaya (biasanya sekitar $0,01/bulan) untuk resource Firebase yang diperlukan oleh ekstensi ini (meskipun jika tidak digunakan).
- Ekstensi ini menggunakan layanan Firebase dan Google Cloud Platform lainnya yang mengenakan biaya terkait jika Anda melebihi paket tanpa biaya layanan:
- Cloud Firestore
- Cloud Functions (Node.js 15+ runtime. Lihat FAQ)
- Cloud Secret Manager
Penggunaan ekstensi ini juga mengharuskan Anda memiliki akun ShipEngine. Anda bertanggung jawab atas semua biaya terkait penggunaan akun ShipEngine Anda.
Cara menginstal ekstensi ini
Menggunakan Firebase console
Anda dapat menggunakan Firebase console untuk menginstal dan mengelola ekstensi.
Instal menggunakan konsolMenggunakan Firebase CLI
Anda juga dapat menggunakan Firebase CLI untuk menginstal dan mengelola ekstensi:
Langkah 1: Jalankan perintah npm berikut untuk menginstal CLI atau mengupdate ke versi CLI terbaru.
npm install -g firebase-toolsTidak berhasil? Lihat referensi Firebase CLI atau ubah izin npm Anda.
Langkah 2: Siapkan direktori project Firebase baru atau buka direktori yang sudah ada
Langkah 3: Tambahkan ekstensi ini ke manifes ekstensi Anda dengan menjalankan
firebase ext:install shipengine/validate-addresses --local --project=projectId_or_alias
Langkah 4 (Opsional): Uji ekstensi ini secara lokal dengan Firebase Emulator Suite
firebase emulators:start
Langkah 5: Deploy ekstensi dalam manifes ke project Anda
firebase deploy --only extensions --project=projectId_or_alias