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

Bu ürün veya özellik önizleme (GKST öncesi) sürümündedir. GKST öncesi ürünler ve özelliklere verilen destek sınırlı olabilir. Ayrıca bu ürünler ve özelliklerde yapılan değişiklikler, GKST öncesi diğer sürümlerle uyumlu olmayabilir. GKST Öncesi Teklifler, Google Haritalar Platformu Hizmetine Özgü Şartlar'a tabidir. Daha fazla bilgi için lansman aşamalarının açıklamalarını inceleyin.

Bir adresi İngilizceye dönüştürme, yerel dilde (İngilizce olmayan) ifade edilen her adres bileşenini İngilizce tabanlı bir sistem tarafından ayrıştırılabilecek bir bileşenle eşleme işlemidir.

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, sisteminizin İ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ığı bir ülkeye veya bu ülkeden kargo gönderebilir.

Adresi İngilizce olarak döndürme

İngilizce eşdeğer bileşenler içeren 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'sunu kullanır:

• ConfirmationLevel alanı yok
• Alan yok unconfirmedComponentTypes

Doğrulama kararı, İngilizce karşılığına değil, yerel dildeki adrese göre verilir.

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)
• 東京都渋谷区渋谷３−２１−３渋谷ストリーム５階 (Önerilmez)

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 durumda administrative_area, locality ve adresin diğer bileşenleri ayrı ayrı ele alınır. 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.

Not: Bu özellik genel kullanıma sunulana kadar adresi dönüştürme özelliği demoda kullanılamaz.

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ş bir sürümü olabilir. Örneğin, España ülkesi İspanyolca olarak Spain şeklinde ç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 alfabesine çevrilmiş 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şeninin İngilizce karşılığı yoksa hizmet, yerel dildeki İngilizce tabanlı olmayan karakterleri 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 karakterleriyle değiştirilir. Örneğin: ３丁目, 3-chome olur.
  • Japonca'nın ö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 olmayan Latin karakterleri yerine İngilizce karakterler kullanır.

İngilizce'de olmayan 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üştürme ö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 belirtilmiş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, Hizmetlerin ö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. Yedek durumlara ö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 [e-mail] adresine e-posta gönderin.