Adresleri İngilizce'ye dönüştür

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:

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.

Rota, Ülke ve Şehir dahil olmak üzere adres bileşenleri çevrildi

İ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"