Address Validation API'yi kullanırken bir doğrulama yanıtı, İngilizceye çevrilmiş adresi de döndürür. Bu özelliği şu durumlarda kullanın: sisteminizin adres bilgilerini İngilizce temelli Latin alfabesi dilinde sağlaması gerekir karakterleri kullanabilirsiniz. Örneğin:
- Şirketiniz, dünyanın dört bir yanından kargo isteklerini karşılayabilir ve Tüm adresleri standartlaştırmak için İngilizce ve İngilizce temelli Latin karakterler.
- İşletmeniz, belirtilen adresin dilinden farklı bir dil kullanıyor.
İngilizce adres nasıl döndürülür
İçerdiği İngilizce eşdeğeri bileşenlerle bir adres doğrulaması istemek için aşağıdakileri doğrulama isteği gövdesine ekleyin:
languageOptions: { returnEnglishLatinAddress: "true" }.
Aşağıdaki örnekte, Prado Müzesi'nin adresi:
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. Görüntüleyin
Ayrıntılar için aşağıdaki adres dönüştürme örneği bölümüne bakın. Her biri
bileşeni, aşağıdaki gibi İngilizce'ye dönüştürülür:
en iyisini seçin. Dönüştürülen adres, API'ye giriş olarak yeniden kullanılamaz.
englishLatinAddress
alanı, aynı değeri kullanır.
Adres
protokolü aşağıdaki istisnalarla address
alanında kullanıldığı gibidir:
- Hayır
ConfirmationLevel
alan - Sıra No:
unconfirmedComponentTypes
alan
Adres dönüştürmenin işleyiş şekli
Address Validation API, söz konusu URL'nin her bileşenine İngilizce dönüştürmeyi
yazmışsınızdır. Bu, administrative_area
, locality
ve diğer
bileşenleri tek tek ele alınır. Görüntüleyin
AddressComponent
referans dokümanlarında bulabilirsiniz.
Aşağıdaki şemada, İngilizce dönüşümün Calle Dueñas, 5, 41003 Sevilla, İspanya adresi.
İngilizce dönüştürme için değerlendirilen her bileşen için hizmet, ilişkili tüm işlemler gerçekleştirilebilir.
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. İçinde
bu durumda hizmet İngilizce sürümü kullanır. Bu durum genelde
country
ve administrative_area_level_1
gibi daha büyük adres bileşenleri
İngilizce kullanılamıyorsa yerel dilin Latin alfabesini kullanır.
Latinleştirme, yerel dilin Latin alfabesine dönüştürülmesi anlamına gelir veya transkript kullanın.
- Adresin yerel dilinde Latin alfabesinde karakter kullanılıyorsa
ve hizmet için adres bileşeni için İngilizce eşdeğeri yoktur.
İngilizce temelli olmayan yerel dildeki karakterleri değiştirir.
Örneğin,
Calle Dueñas
,Calle Duenas
haline gelir. Burada ñ değeri: n ile değiştirilir. - Adresin yerel dilinde Latin kökenli bir dil kullanılmıyorsa
karakter kümesidir ve adres bileşeni için İngilizce eşdeğeri yoktur.
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ı karakterler alır
Latin karakterler. Örneğin: 3丁目, 3-chome olur.
- Önizleme için Japonca'nın henüz etkinleştirilmediğini unutmayın
- Dilin latin alfabeli 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 karakterlerin yerine İngilizce karakterler getirilir eşdeğerdir. Örneğin, aşağıdaki karakterlerin her biri "o" karakteri: anlat, ò, ó, ô, õ, ö, ø, ō, ŏ, ő, ơ, ṍ, ṏ, ṑ, ṓ, ↘, ỏ, ố, yaşadığı, ổ, ỗ, ấ, 設, ờ, ở, ỡ ve ợ. Örneğin:
Calle de Ruiz de Alarcón, Calle de Ruiz de Alarcon oldu
Adres dönüşümü örneği
Aşağıdaki örnekte Palacio için bir istekten gelen doğrulama yanıtı gösterilmektedir
de las Dueñas adıyla İspanya'da. englishLatinAddress
kalın harflerle gösterilmiştir. Bu istek
languageOptions
parametresindeki returnEnglishLatinAddress
alanını kullanmıştır.
girdi.
"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, bu diller için destek sağlamasa da Önizleme sürümleri, veya Hizmetler'in işlevleri arasında yer alan taleplere ayrı ayrı gelişim aşamaları vardır.
GKST öncesi sürümler için aşağıdaki önerilerden yararlanın:
GKST öncesi özellikler Google Haritalar Platformu HDS'si.
Özellikle bir üretim ortamındaki GKST öncesi özelliği. Bazı yedek örnekleri şu durumlara örnektir: kotanın aşılması, beklenmedik yanıt kodları ve gecikme, mevcut davranışla karşılaştırıldığında beklenmedik yanıtlar vermelidir.
Yeni özellikler istemek veya değişiklik önermek için sorun izleyiciyi kullanabilirsiniz uyarlayabilirsiniz. İsteğinize aşağıdakileri eklediğinizden emin olun:
Eklenmesini istediğiniz özelliği veya davranışı da açıklayın düşünme neden olabilir.
Mümkünse kullanım alanınız ve yeni olanak tanıyacağı anlamına gelir.
Bu geri bildirim veya özelliklerle ilgili diğer sorularınız için şu adrese e-posta gönderin: Adres Doğrulama Yardım Hattı: address-validation-hotline@google.com.