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

Adres Doğrulama API'sini 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 İngilizce tabanlı Latin karakterleriyle adres bilgisi 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.

İngilizce adres döndürme

İngilizce eşdeğer bileşenlerin dahil edildiği bir adres doğrulaması istemek için doğrulama isteği içeriğine 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'ne bakın. Döndürülen yerel dildeki adresin her bileşeni, mümkün olduğunca İ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:

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

İngilizceye dönüştürülecek bir Japon 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ının olmadığı durumlara örnekler:

  • 東京都渋谷区渋谷３丁目２１−３　５階 (Önerilir)
  • 東京都渋谷区渋谷３丁目２１−３−５階 (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ı ele alındığı anlamına gelir. Adres bileşenlerinin listesi için referans belgelerindeki AddressComponent bölümüne bakın.

Aşağıdaki diyagramda, Calle Dueñas, 5, 41003 Sevilla, İspanya adresinin İngilizceye çevrilmiş hali 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ş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 tamamen çevrilmiş bir sürümü kullanılabilir. Örneğin, España ülkesi 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ş versiyonunu 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, İngilizce tabanlı olmayan yerel dildeki 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 alfabesiyle yazılışını 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'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 karakterlerin yerine İngilizce karakterler koyar.

İngilizce'de olmayan tüm Latin karakterler, İ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 olarak değişiyor.

Adres dönüştürme örneği

Aşağıdaki örnekte, İspanya'daki Palacio de las Dueñas için yapılan bir isteğin doğrulama yanıtı gösterilmektedir. englishLatinAddress simgesi kalın olarak belirtilmiş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"

Ö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ümlerde şu önerileri kullanın:

  • GKST öncesi özellikler, Google Haritalar Platformu HDS kapsamında değildir.

  • Özellikle üretim ortamında GKST öncesi bir özellik kullanıyorsanız yedek mekanizmalar kullanın. Yedek durumlara bazı örnekler: kota aşıldı, beklenmeyen yanıt kodları ve gecikme ya da mevcut davranışla karşılaştırıldığında beklenmeyen 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 işlevi veya davranışı ve 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 sorun izleyicide hata kaydı oluşturun.