Saat menggunakan Address Validation API, Anda dapat meminta respons validasi juga menampilkan alamat yang dikonversi ke dalam bahasa Inggris. Gunakan fitur ini saat sistem Anda perlu memberikan informasi alamat dalam karakter Latin berbasis bahasa Inggris saat menerima alamat yang berasal dari bahasa non-Inggris. Contoh:
- Perusahaan Anda mungkin memenuhi permintaan pengiriman dari seluruh dunia dan menggunakan karakter Latin berbasis Inggris dan Inggris untuk menstandarkan semua alamat.
- Bisnis Anda mungkin menangani pengiriman ke dan dari negara yang menggunakan bahasa yang berbeda dengan bahasa alamat yang diberikan.
Cara menampilkan alamat dalam bahasa Inggris
Untuk meminta validasi alamat dengan menyertakan komponen yang setara dalam bahasa Inggris, tambahkan hal berikut ke isi permintaan validasi:
"languageOptions": { "returnEnglishLatinAddress": "true" }
Contoh berikut meminta komponen berbasis bahasa Inggris saat memverifikasi alamat ke Museum Prado:
curl -X POST -d '{ "address": { "region_code" : "ES", "address_lines": ["C. de Ruiz de Alarcón, 23, 28014 Madrid, Spain"], }, "languageOptions": {returnEnglishLatinAddress: true} }' \ -H 'Content-Type: application/json' \ -H 'X-Goog-Api-Key: API_KEY' \ 'https://addressvalidation.googleapis.com/v1:validateAddress'
Respons menampilkan alamat dalam bahasa Inggris di kolom englishLatinAddress
. Lihat
Contoh konversi alamat di bawah untuk mengetahui detailnya. Setiap
komponen alamat bahasa lokal yang ditampilkan dikonversi ke dalam bahasa Inggris sebaik
mungkin. Alamat yang dikonversi tidak dapat digunakan kembali sebagai input ke API.
Kolom englishLatinAddress
menggunakan proto
Address
yang sama dengan yang digunakan kolom address
, dengan pengecualian berikut:
- Tidak ada kolom
ConfirmationLevel
- Tidak ada kolom
unconfirmedComponentTypes
Cara kerja konversi alamat
Address Validation API menerapkan konversi bahasa Inggris ke setiap komponen alamat. Artinya, administrative_area
, locality
, dan komponen alamat lainnya
diperlakukan satu per satu. Lihat
AddressComponent
dalam dokumentasi referensi untuk mengetahui daftar komponen alamat.
Diagram berikut mengilustrasikan tampilan konversi bahasa Inggris untuk alamat Calle Dueñas, 5, 41003 Sevilla, España.
Untuk setiap komponen yang dievaluasi untuk konversi bahasa Inggris, layanan menggunakan proses yang dijelaskan di bagian berikut.
Menggunakan bahasa Inggris yang diterjemahkan sepenuhnya jika memungkinkan
Beberapa komponen alamat mungkin memiliki versi yang diterjemahkan sepenuhnya dan tersedia untuk digunakan.
Misalnya, negara Spanyol España
akan diterjemahkan menjadi Spain
. Dalam
hal ini, layanan akan menggunakan versi bahasa Inggris. Hal ini biasanya berlaku untuk
komponen alamat yang lebih besar seperti country
dan administrative_area_level_1
.
Menggunakan latinisasi bahasa lokal jika bahasa Inggris tidak tersedia
Latinisasi berarti bahasa lokal dikonversi ke skrip Latin menggunakan transkripsi.
- Jika bahasa lokal alamat menggunakan kumpulan karakter Latin, dan tidak ada padanan bahasa Inggris untuk komponen alamat, layanan akan mengganti karakter dari bahasa lokal yang tidak berbasis bahasa Inggris.
Misalnya,
Calle Dueñas
menjadiCalle Duenas
, dengan ñ diganti dengan n. - Jika bahasa lokal alamat tidak menggunakan kumpulan karakter berbasis Latin, dan tidak ada padanan bahasa Inggris untuk komponen alamat, layanan akan menggunakan versi bahasa lokal yang dilatinkan, jika tersedia.
Misalnya, konversi bahasa Jepang menampilkan romanisasi bahasa Jepang.
Semua karakter non-bahasa Inggris dan non-Latin akan diganti dengan karakter Latin
berbasis bahasa Inggris. Misalnya: 3丁目 menjadi 3-chome.
- Perhatikan bahwa bahasa Jepang belum diaktifkan untuk pratinjau
- Jika versi bahasa latin tidak tersedia, komponen akan ditampilkan dalam bahasa lokal.
Mengganti karakter Latin yang bukan dalam bahasa Inggris
Setiap karakter Latin yang bukan dalam bahasa Inggris akan diganti dengan karakter bahasa Inggris yang setara. Misalnya, setiap karakter berikut akan diganti dengan karakter "o": ð, ò, ó, ô, õ, ö, ø, ō, ŏ, ő, ơ, ṍ, ṏ, ṑ, ṓ, ọ, ỏ, ố, ồ, ổ, ỗ, ộ, ớ, ờ, ở, ỡ, dan ợ. Contoh:
Calle de Ruiz de Alarcón menjadi Calle de Ruiz de Alarcon
Contoh konversi alamat
Contoh berikut menunjukkan respons validasi dari permintaan untuk Palacio
de las Dueñas di Spanyol, dengan englishLatinAddress
dicetak tebal. Permintaan ini menggunakan kolom returnEnglishLatinAddress
dalam parameter languageOptions
dalam input.
"result": { "verdict": { "inputGranularity": "PREMISE", "validationGranularity": "PREMISE", "geocodeGranularity": "PREMISE", "addressComplete": true, "hasInferredComponents": true }, "address": { "formattedAddress": "Calle Dueñas, 5, 41003 Sevilla, España", "postalAddress": { "regionCode": "ES", "languageCode": "es", "postalCode": "41003", "administrativeArea": "Sevilla", "locality": "Sevilla", "addressLines": [ "C. Dueñas, 5" ] }, "addressComponents": [ { "componentName": { "text": "Calle Dueñas", "languageCode": "es" }, "componentType": "route", "confirmationLevel": "CONFIRMED" }, { "componentName": { "text": "5", "languageCode": "es" }, "componentType": "street_number", "confirmationLevel": "CONFIRMED" }, { "componentName": { "text": "41003" }, "componentType": "postal_code", "confirmationLevel": "CONFIRMED" }, { "componentName": { "text": "Sevilla", "languageCode": "es" }, "componentType": "locality", "confirmationLevel": "CONFIRMED" }, { "componentName": { "text": "España", "languageCode": "es" }, "componentType": "country", "confirmationLevel": "CONFIRMED" }, { "componentName": { "text": "Sevilla", "languageCode": "es" }, "componentType": "administrative_area_level_2", "confirmationLevel": "CONFIRMED", "inferred": true } ] }, "geocode": { "location": { "latitude": 37.394849, "longitude": -5.9893604 }, "plusCode": { "globalCode": "8C9P92V6+W7" }, "bounds": { "low": { "latitude": 37.3948098, "longitude": -5.9894249 }, "high": { "latitude": 37.3948882, "longitude": -5.9893025 } }, "featureSizeMeters": 7.174035, "placeId": "ChIJzRDYbgRsEg0RDDgHlF80UoI", "placeTypes": [ "premise" ] }, "metadata": { "business": true, "residential": false }, "englishLatinAddress": { "formattedAddress": "Calle Duenas, 5, 41003 Seville, Spain", "postalAddress": { "regionCode": "ES", "languageCode": "en", "postalCode": "41003", "administrativeArea": "Seville", "locality": "Seville", "addressLines": [ "C. Duenas, 5" ] }, "addressComponents": [ { "componentName": { "text": "Calle Duenas", "languageCode": "es" }, "componentType": "route", }, { "componentName": { "text": "5", "languageCode": "es" }, "componentType": "street_number", }, { "componentName": { "text": "41003" }, "componentType": "postal_code", }, { "componentName": { "text": "Seville", "languageCode": "en" }, "componentType": "locality", }, { "componentName": { "text": "Spain", "languageCode": "en" }, "componentType": "country", }, { "componentName": { "text": "Seville", "languageCode": "en" }, "componentType": "administrative_area_level_2", "inferred": true } ] } }, "responseId": "e874d263-7d0d-413f-9213-119a784765ed"
Opsi dukungan untuk rilis Pratinjau
Meskipun Google tidak memberikan dukungan untuk versi, fitur, atau fungsi Pratinjau Layanan, kami mempertimbangkan permintaan pada tahap pengembangan ini berdasarkan kasus per kasus.
Gunakan rekomendasi ini untuk versi pra-GA:
Fitur pra-GA tidak tercakup dalam SLA Google Maps Platform.
Gunakan mekanisme penggantian, terutama jika Anda menggunakan fitur pra-GA di lingkungan produksi. Beberapa contoh situasi penggantian adalah: kuota terlampaui, kode respons dan latensi yang tidak terduga, atau respons yang tidak terduga jika dibandingkan dengan perilaku yang ada.
Anda dapat menggunakan Issue Tracker untuk meminta fitur baru atau mengusulkan modifikasi pada fitur yang ada. Pastikan untuk menyertakan hal-hal berikut dalam permintaan Anda:
Jelaskan fitur atau perilaku spesifik yang ingin Anda tambahkan, serta alasan yang menurut Anda penting.
Jika memungkinkan, sertakan detail spesifik tentang kasus penggunaan Anda dan peluang baru yang akan dimungkinkan oleh fitur tersebut.
Untuk masukan ini atau pertanyaan lainnya tentang fitur, kirim email ke Hotline Validasi Alamat: address-validation-hotline@google.com.