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

Bu ürün veya özellik önizleme sürümündedir (GKST öncesi). 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 Hizmete Ö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 işlemi, yerel dilde (İngilizce olmayan) ifade edilen her adres bileşenini, İngilizce tabanlı bir sistem tarafından ayrıştırılabilen bir bileşenle eşleme işlemidir.

Address Validation API'yi kullanırken doğrulama yanıtının, adresi İngilizceye dönüştürülmüş şekilde de döndürmesini isteyebilirsiniz. İngilizce dışında bir dilde gelen bir adresi alırken sisteminizin adres bilgilerini İngilizce tabanlı Latin alfabesi harfleriyle sağlaması gerektiğinde bu özelliği kullanın. Örneğin:

• Şirketiniz dünyanın her yerinden gelen gönderim isteklerini yerine getirebilir ve tüm adresleri standartlaştırmak için İngilizce ve İngilizce tabanlı Latin alfabesi karakterlerini kullanabilir.
• İşletmeniz, belirtilen adresin dilinden farklı bir dil kullanan bir ülkeye veya ülkeden kargo gönderip alabilir.

Adresi İngilizce olarak iade etme

İngilizce eşdeğer bileşenleri 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 adresini doğrularken İngilizce tabanlı bileşenler istenir:

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üşümü örneğine 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 girişi olarak yeniden kullanılamaz.

englishLatinAddress alanı, aşağıdaki istisnalar dışında address alanıyla aynı Address prototipini kullanır:

• ConfirmationLevel alanı yok
• unconfirmedComponentTypes alanı yok

Doğrulama sonucu, İngilizce dil eşdeğerine değil yerel dil adresine dayanır.

Adres dönüşümü nasıl çalışır?

Address Validation API, adresin her bir bileşenine İngilizce dönüşüm uygular. Bu, administrative_area, locality ve adresin diğer bileşenlerinin ayrı ayrı ele alındığı anlamına gelir. Adres bileşenlerinin listesi için referans dokümanlarında AddressComponent bölümüne bakın.

Aşağıdaki şemada, Calle Dueñas, 5, 41003 Sevilla, España adresinin İngilizce dönüşümü gösterilmektedir.

Not: Adres dönüşümü, genel kullanıma sunuluncaya kadar demoda kullanılamaz.

Hizmet, İngilizce dönüşüm için değerlendirilen her bileşende 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 tamamen çevrilmiş bir sürümü kullanılabilir. Örneğin, İspanyolca konuşulan España ülkesi Spain olarak çevrilir. Bu durumda, hizmet İngilizce sürümünü 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 dönüştürülmüş hali kullanılır.

Latinleştirme, yerel dilin transkripsiyon kullanılarak Latin alfabesine dönüştürülmesi anlamına gelir.

• Adresin yerel dilinde Latin alfabesi kullanılıyorsa ve adres bileşeni için İngilizce eşdeğeri yoksa hizmet, yerel dilde bulunan ve İngilizce olmayan karakterleri değiştirir. Örneğin, Calle Dueñas dönüştürülüp Calle Duenas haline gelir. Bu durumda ñ, n ile değiştirilir.
• Adresin yerel dilinde Latin alfabesi kullanılmayan bir karakter grubu varsa ve adres bileşeni için İngilizce eşdeğeri yoksa hizmet, varsa yerel dilin Latin alfabesine çevrilmiş sürümünü kullanır. Örneğin, Japonca bir dönüşüm, Japonca'nın romanizasyonunu döndürür. İngilizce ve Latin alfabesinde bulunmayan karakterler İngilizce tabanlı Latin alfabesi karakterleriyle değiştirilir. Örneğin: ３丁目, 3-chome olur.
  • Japonca henüz önizleme için etkinleştirilmemiştir
• Dilin Latin alfabesine göre yazılmış bir sürümü yoksa bileşenler yerel dilde döndürülür.

İngilizce olmayan Latin karakterlerini değiştirir

İngilizce olmayan Latin alfabesi karakterleri, İngilizce karakter eşdeğerleriyle 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 olur.

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

Aşağıdaki örnekte, İspanya'daki Palacio de las Dueñas için yapılan bir istekten alınan doğrulama yanıtı gösterilmektedir. englishLatinAddress kalın olarak yazılmıştır. Bu istek, girişteki languageOptions parametresinde returnEnglishLatinAddress alanını kullandı.

"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 istekleri durum özelinde değerlendiririz.

GKST öncesi sürümler için aşağıdaki ö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 durum örnekleri şunlardır: kota aşıldı, beklenmedik yanıt kodları ve gecikmeler veya mevcut davranışa kıyasla 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 bunun neden önemli olduğunu açıklayın.

• Mümkünse kullanım alanınız ve özelliğin sunacağı yeni fırsatlarla ilgili ayrıntılı bilgi verin.

Bu geri bildirim veya özelliklerle ilgili diğer sorular için adres doğrulama yardım hattına e-posta gönderin: [e-mail].