Address Validation API'yi kullanırken bir doğrulama yanıtının, adresi İngilizceye dönüştürülmüş şekilde döndürmesini de isteyebilirsiniz. İngilizce dışında bir dilden adres alırken sisteminizin adres bilgilerini Latin alfabesindeki İngilizce karakterlerle sağlaması gerektiğinde bu özelliği kullanın. Örneğin:
- Şirketiniz, dünyanın her yerinden gelen gönderim taleplerini karşılayabilir ve tüm adresleri standartlaştırmak için İngilizce ve İngilizce temelli Latin karakterler kullanabilir.
- İşletmeniz, belirtilen adresin dilinden farklı bir dilin kullanıldığı bir ülkeye/ülkeden sevkiyat gerçekleştirebilir.
Adresi İngilizce dilinde nasıl iade ederim?
Dahil olan İngilizce eşdeğer bileşenlerle adres doğrulama isteğinde bulunmak için aşağıdakileri doğrulama isteği gövdesine ekleyin:
languageOptions: { returnEnglishLatinAddress: "true" }.
Aşağıdaki örnekte, Prado Müzesi'nin adresi doğrulanırken İngilizce temelli bileşenler istenmektedir:
curl -X POST -d '{ "regionCode" : ["ES"], "addressLines": ["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'
Yanıt, englishLatinAddress
alanında İngilizce adresi döndürür. Ayrıntılar için aşağıdaki Adres dönüşümü örneği bölümüne bakın. Döndürülen yerel dil adresinin her bileşeni mümkün olan en iyi şekilde İngilizceye dönüştürülür. Dönüştürülen adres, API girişi olarak yeniden kullanılamaz.
englishLatinAddress
alanı, aşağıdaki istisnalar haricinde, address
alanının kullandığı aynı Adres protokolünü kullanır:
ConfirmationLevel
alanı yokunconfirmedComponentTypes
alanı yok
Adres dönüştürmenin işleyiş şekli
Address Validation API, adresin her bileşenine İngilizce dönüştürme uygular. Yani administrative_area
, locality
ve adresin diğer bileşenleri ayrı ayrı işlenir. Adres bileşenlerinin listesi için referans belgelerindeki AddressComponent bölümüne bakın.
Aşağıdaki şemada Calle Dueñas, 5, 41003 Sevilla, España adresi için İngilizce dönüşüm işleminin nasıl göründüğü gösterilmektedir.
İngilizce dönüştürme amacıyla değerlendirilen her bileşen için hizmet, aşağıdaki bölümlerde açıklanan süreci kullanır.
Mümkün olduğunda tamamen çevrilmiş İngilizce kullanmalıdır
Bazı adres bileşenlerinin, tamamen çevrilmiş sürümleri olabilir.
Örneğin, İspanyolca ülkesi España
şu dile çevrilir: Spain
. Bu durumda hizmet, İngilizce sürümü kullanır. Bu durum, genellikle country
ve administrative_area_level_1
gibi daha büyük adres bileşenleri için geçerlidir.
İngilizce mevcut değilse yerel dilin latin harflerini kullanır
Latin harf kullanımı, yerel dilin metne dönüştürme kullanılarak Latin alfabesine dönüştürülmesi anlamına gelir.
- Adresin yerel dilinde Latince karakter kümesi kullanılıyorsa ve adres bileşeninin İngilizce karşılığı yoksa hizmet, yerel dildeki İngilizce temelli olmayan karakterlerin yerini alır.
Örneğin,
Calle Dueñas
Calle Duenas
olur ve burada ñ, n ile değiştirilir. - Adresin yerel dilinde Latin tabanlı bir karakter kümesi kullanılmıyorsa ve adres bileşeninin İngilizce karşılığı yoksa hizmet, varsa yerel dilin latin alfabesine dönüştürülmüş bir sürümünü kullanır.
Örneğin, Japonca bir dönüşüm, Japoncanın Latin alfabesine dönüştürülmesini döndürür.
Latin alfabesinde yer almayan İngilizce olmayan karakterler, İngilizce temelli Latin karakterlerle değiştirilir. Örneğin: 3丁目, 3-chome haline gelir.
- Önizleme için Japoncanın henüz etkinleştirilmediğini unutmayın
- Dilin latin harfleriyle yazılmış sürümü mevcut değilse bileşenler yerel dilde döndürülür.
İngilizce olmayan Latin karakterlerin yerini alır
İngilizce olmayan tüm Latin karakterler, İngilizce karakter eşdeğerleriyle değiştirilir. Örneğin, şu karakterlerin her biri "o" karakteriyle değiştirilir: ð, ò, ó, ô, õ, ö, ø, ō, ŏ, ő, ơ, ṍ, ṏ, ṑ, ṓ, ṏ, ỏ, ợ, ố, ỏ, ợ, ố, ỏ, ợ, ố, ỏ, ợ, yöneliktir, ỏ, ợ, altına, ò, ó, ô, õ, ö, ø, ō, ŏ, ő, ơ, ṍ, ṏ, Örneğin:
Calle de Ruiz de Alarcón artık Calle de Ruiz de Alarcon
Adres dönüşümü örneği
Aşağıdaki örnekte, İspanya'daki Palacio de las Dueñas isteğinden gelen doğrulama yanıtı, englishLatinAddress
kalın harflerle gösterilmiştir. Bu istekte, girişteki languageOptions
parametresinde returnEnglishLatinAddress
alanı kullanıldı.
"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"