Address Validation API'yi kullanırken doğrulama yanıtının İngilizceye dönüştürülmüş adresi döndürmesini de isteyebilirsiniz. Sisteminizin, İngilizce dışındaki bir dilde adres aldığında adres bilgilerini İngilizce tabanlı Latin karakterleriyle sağlaması gerektiğinde bu özelliği kullanın. Örneğin:
- Şirketiniz, dünyanın dört bir yanından gelen kargo isteklerini karşılayabilir ve tüm adresleri standartlaştırmak için İngilizce ve İngilizce tabanlı Latin karakterleri kullanabilir.
- İşletmeniz, belirtilen adresin dilinden farklı bir dilin kullanıldığı bir ülkeye veya bu ülkeden yapılan gönderimleri gerçekleştiriyor olabilir.
İngilizce adres nasıl döndürülür
Dahil edilen İngilizce eşdeğer bileşenlerle bir adres doğrulaması istemek için doğrulama isteği gövdesine aşağıdakileri 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ındaki İngilizce adresi döndürür. Ayrıntılar için aşağıdaki Adres dönüştürme örneği bölümüne bakın. Döndürülen yerel dil adresinin her bileşeni, mümkün olduğunca İngilizceye dönüştürülür. Dönüştürülen adres, API'ye giriş olarak yeniden kullanılamaz.
englishLatinAddress alanı, aşağıdaki istisnalar hariç olmak üzere address alanının kullandığıyla aynı Adres protokolünü kullanır:
ConfirmationLevelalanı yokunconfirmedComponentTypesalanı yok
Adres dönüştürmenin işleyiş şekli
Address Validation API, İngilizce dönüştürme işlemini adresin her bileşenine uygular. Bu, administrative_area, locality ve adresin diğer bileşenlerinin ayrı ayrı ele alınacağı anlamına gelir. 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, İspanya adresi için İngilizce dönüştürme işleminin nasıl görüneceği gösterilmektedir.
Hizmet, İngilizce dönüştürme için değerlendirilen her bileşen için aşağıdaki bölümlerde açıklanan süreci kullanır.
Mümkün olduğunda tamamen çevrilmiş İngilizce kullanılmalıdır.
Bazı adres bileşenlerinin tam çevrilmiş sürümü kullanılabilir.
Örneğin, İspanyolca ülkesi España olan dil Spain olarak çevrilir. 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 kullanılamıyorsa yerel dilin Latin alfabesini kullanır.
Latinceleştirme, yerel dilin metne dönüştürme kullanılarak Latin alfabesine dönüştürülmesi anlamına gelir.
- Adresin yerel dili Latince karakter kümesi kullanıyorsa ve adres bileşeni için İngilizce eşdeğeri yoksa hizmet, İngilizce tabanlı olmayan yerel dildeki karakterlerin yerini alır.
Örneğin,
Calle DueñasCalle Duenashaline gelir; burada ñ yerine n kullanılır. - Adresin yerel dilinde Latin kökenli bir karakter kümesi kullanılmıyorsa ve adres bileşeni için İngilizce eşdeğeri yoksa hizmet, varsa yerel dilin latin alfabesini kullanır.
Örneğin, Japonca bir dönüşüm, Japoncanın Latin alfabesini döndürür.
İngilizce olmayan, Latin alfabesinde olmayan tüm karakterlerin yerini İngilizce tabanlı Latin karakterleri alır. Örneğin: 3丁目, 3-chome olur.
- Önizleme için Japonca'nın henüz etkinleştirilmediğini unutmayın
- Dilin latin alfabesi yazılmış sürümü mevcut değilse bileşenler yerel dilde döndürülür.
İngilizce olmayan Latin karakterlerini değiştirir
İngilizce olmayan Latin alfabesindeki karakterlerin yerini İngilizce karakter eşdeğerleri alır. Örneğin, şu karakterlerin her biri "o" karakteriyle değiştirilir: 뻏, ò, ó, ô, õ, ö, ø, ō, ŏ, ő, yanlış, ṍ, ṏ, ṑ, ṓ, Ekleyin, ỏ, ố, gsutil, ỏ, ố, ợ, ỻ, ỻ, ỻ, ỻ, ỻ, ỻ, ổ, ö, ø, ō, ŏ, ő, ơ, ṍ Örneğin:
Calle de Ruiz de Alarcón, Calle de Ruiz de Alarcon oldu
Adres dönüşümü örneği
Aşağıdaki örnekte, englishLatinAddress kalın harflerle İspanya'daki Palacio de las Dueñas için bir istekten gelen doğrulama yanıtı gösterilmektedir. Bu istek, 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"
Önizleme sürümleri için destek seçenekleri
Google, Hizmetler'in Önizleme sürümleri, özellikleri veya işlevleri için destek sağlamasa da, istekleri bu geliştirme aşamalarında tek tek değerlendiririz.
GKST öncesi sürümler için aşağıdaki önerilerden yararlanın:
GKST öncesi özellikler Google Haritalar Platformu HDS'si kapsamında değildir.
Özellikle bir üretim ortamında GKST öncesi özellik kullanıyorsanız yedek mekanizmaları kullanın. Yedek durumlara örnek olarak şunlar verilebilir: kotanın aşılması, beklenmedik yanıt kodları ve gecikme veya mevcut davranışla karşılaştırıldığında beklenmedik yanıtlar.
Yeni özellikler istemek veya mevcut özelliklerde değişiklik önermek için sorun izleyiciyi kullanabilirsiniz. İsteğinize aşağıdakileri eklediğinizden emin olun:
Eklenmesini istediğiniz özelliği veya davranışı ve sizin için neden önemli olduğunu açıklayın.
Mümkünse kullanım alanınız ve özelliğin olanak tanıyacağı yeni fırsatlar hakkında spesifik ayrıntılar ekleyin.
Bu geri bildiriminiz veya özelliklerle ilgili diğer sorularınız için Adres Doğrulama Yardım Hattı'na e-posta gönderin: address-validation-hotline@google.com.