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

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 dilin kullanıldığı bir ülkeye veya ülkeden kargo gönderip alabilir.

Adresi İngilizce olarak iade etme

İngilizce eşdeğer bileşenlerin dahil edildiği 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ılı bilgi 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:

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

İngilizceye dönüştürülecek bir Japonca adresi 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ı olmayan örnekler:

  • 東京都渋谷区渋谷３丁目２１−３　５階 (Recommended)
  • 東京都渋谷区渋谷３丁目２１−３−５階 (Recommended)
  • 東京都渋谷区渋谷３丁目２１−３５階 (Not recommended)

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.

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

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üş halini kullanı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, ñ yerine n kullanılarak Calle Duenas olur.
  • 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 duruma göre 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 arasında kota aşımı, beklenmedik yanıt kodları ve gecikmeler veya mevcut davranışa kıyasla beklenmedik yanıtlar yer alır.

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: address-validation-hotline@google.com.