Bu sayfa, Cloud Translation API ile çevrilmiştir.

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

Address Validation API'yi kullanırken doğrulama yanıtının, İngilizceye dönüştürülmüş adresi de döndürmesini isteyebilirsiniz. Bu özelliği, sisteminiz İngilizce olmayan bir dildeki adresi alırken adres bilgilerini İngilizce tabanlı Latin karakterleriyle sağlaması gerektiğinde kullanın. Örneğin:

Şirketiniz dünyanın her yerinden gelen kargo isteklerini karşılayabilir ve tüm adresleri standartlaştırmak için İngilizce ile İngilizce tabanlı Latin karakterlerini kullanabilir.
İşletmeniz, sağlanan adresin dilinden farklı bir dilin kullanıldığı ülkelere ve bu ülkelerden kargo gönderebilir.

Adresi İngilizce olarak döndürme

İngilizceye eşdeğer bileşenlerin yer aldığı 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 tabanlı bileşenler isteniyor:

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'

Yanıt, englishLatinAddress alanında İ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 dildeki adresin her bileşeni, mümkün olduğunca iyi şekilde İ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 dışında address alanı ile aynı Address proto'yu kullanır:

ConfirmationLevel alanı yok
Alan unconfirmedComponentTypes yok

Japonca adres dönüşümlerinin kalitesini artırma

İngilizceye dönüştürülecek bir Japonca adres gönderirken adresin aşağıdaki bölümleri arasına boşluk veya ayırıcı (ör. "-") ekleyin:

Bina numarası (tesis) ve bina adı.
Bina numarası (tesis) ve alt tesis / birim numarası.
Bina adı ve alt tesis.

Örneğin:

東京都渋谷区渋谷　３−２１−３　渋谷ストリーム　５階 (Recommended)
東京都渋谷区渋谷３−２１−３渋谷ストリーム５階 (Not recommended)

Bina adının olmadığı durumlara örnekler:

東京都渋谷区渋谷３丁目２１−３　５階 (Recommended)
東京都渋谷区渋谷３丁目２１−３−５階 (Recommended)
東京都渋谷区渋谷３丁目２１−３５階 (Önerilmez)

Adres dönüşümünün işleyiş şekli

Address Validation API, adresin her bileşenine İngilizce dönüştürme uygular. Bu, administrative_area, locality ve adresin diğer bileşenlerinin ayrı ayrı işlendiği anlamına gelir. Adres bileşenlerinin listesi için referans belgelerdeki AddressComponent bölümüne bakın.

Aşağıdaki şemada, Calle Dueñas, 5, 41003 Sevilla, España adresinin İngilizceye dönüştürülmüş hali gösterilmektedir.

Rota, ülke ve yerleşim yeri dahil olmak üzere çevrilmiş adres bileşenleri

Hizmet, İngilizce çeviri 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ır.

Bazı adres bileşenlerinin, kullanıma hazır tam çevrilmiş sürümleri olabilir. Örneğin, España ülkesi İspanya, 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 Latinleştirilmiş halini kullanır.

Latinleştirme, yerel dilin transkripsiyon 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şeni için İngilizce karşılığı yoksa hizmet, İngilizce tabanlı olmayan yerel dil karakterlerini değiştirir. Örneğin, Calle Dueñas, Calle Duenas olur. Burada ñ yerine n kullanılır.
Adresin yerel dilinde Latin alfabesi tabanlı bir karakter seti kullanılmıyorsa ve adres bileşeni için İngilizce karşılığı yoksa hizmet, varsa yerel dilin Latinleştirilmiş bir sürümünü kullanır. Örneğin, Japonca bir dönüşüm, Japonca'nın Latin alfabesine çevrilmiş halini döndürür. İngilizce ve Latin alfabesi dışındaki tüm karakterler, İngilizce tabanlı Latin alfabesi karakterleriyle değiştirilir. Örneğin: ３丁目, 3-chome olur.
- Japonca dilinin önizleme için henüz etkinleştirilmediğini unutmayın.
Dilin Latin alfabesine çevrilmiş sürümü yoksa bileşenler yerel dilde döndürülür.

İngilizce'de bulunmayan Latin karakterleri yerine İngilizce karakterler kullanır.

İngilizce'de bulunmayan tüm Latin karakterler, İngilizce karakter karşılıklarıyla değiştirilir. Örneğin, aşağıdaki karakterlerin her biri "o" karakteriyle değiştirilir: ð, ò, ó, ô, õ, ö, ø, ō, ŏ, ő, ơ, ṍ, ṏ, ṑ, ṓ, ọ, ỏ, ố, ồ, ổ, ỗ, ộ, ớ, ờ, ở, ỡ ve ợ. Örneğin:

Calle de Ruiz de Alarcón, Calle de Ruiz de Alarcon olarak değiştiriliyor.

Adres dönüşümü örneği

Aşağıdaki örnekte, İspanya'daki Palacio de las Dueñas için yapılan bir isteğe ilişkin doğrulama yanıtı gösterilmektedir. englishLatinAddress simgesi kalın olarak gösterilmiştir. Bu istekte, girişin 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 bu geliştirme aşamalarındaki talepleri duruma göre değerlendiririz.

GKST öncesi sürümler için bu önerileri kullanın:

GKST öncesi özellikler, Google Haritalar Platformu HDS kapsamında değildir.
Özellikle üretim ortamında GA öncesi bir özellik kullanıyorsanız yedek mekanizmalar kullanın. Yedekleme durumlarına örnek olarak şunlar verilebilir: kota aşıldı, beklenmedik yanıt kodları ve gecikme ya da 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 eklemeyi unutmayın:

Eklenmesini istediğiniz özelliği veya davranışı ve bunun neden önemli olduğunu düşündüğünüzü açıklayın.
Mümkünse kullanım alanınız ve özelliğin sağlayacağı yeni fırsatlar hakkında ayrıntılı bilgi verin.

Bu geri bildirim veya özelliklerle ilgili diğer sorularınız için address-validation-hotline@google.com adresine e-posta gönderin.