Google berkomitmen untuk mendorong terwujudnya keadilan ras bagi komunitas Kulit Hitam. Lihat caranya.

Memvalidasi Alamat dengan ShipEngine

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 konsol

Menggunakan 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-tools
Tidak 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
Dukungan
Cloud Firestore
Penulis
Lisensi
Apache-2.0
Versi
0.0.3