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

Address Validation API'yi kullanırken bir doğrulama yanıtı, İngilizceye çevrilmiş adresi de döndürür. Bu özelliği şu durumlarda kullanın: sisteminizin adres bilgilerini İngilizce temelli Latin alfabesi dilinde sağlaması gerekir karakterleri kullanabilirsiniz. Örneğin:

  • Şirketiniz, dünyanın dört bir yanından kargo isteklerini karşılayabilir ve Tüm adresleri standartlaştırmak için İngilizce ve İngilizce temelli Latin karakterler.
  • İşletmeniz, belirtilen adresin dilinden farklı bir dil kullanıyor.

İngilizce adres nasıl döndürülür

İçerdiği İngilizce eşdeğeri bileşenlerle bir adres doğrulaması istemek için aşağıdakileri doğrulama isteği gövdesine ekleyin:

languageOptions: { returnEnglishLatinAddress: "true" }.

Aşağıdaki örnekte, Prado Müzesi'nin adresi:

curl -X POST -d '{
  "regionCode" : ["ES"],
  "addressLines": ["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ındaki İngilizce adresi döndürür. Görüntüleyin Ayrıntılar için aşağıdaki adres dönüştürme örneği bölümüne bakın. Her biri bileşeni, aşağıdaki gibi İngilizce'ye dönüştürülür: en iyisini seçin. Dönüştürülen adres, API'ye giriş olarak yeniden kullanılamaz.

englishLatinAddress alanı, aynı değeri kullanır. Adres protokolü aşağıdaki istisnalarla address alanında kullanıldığı gibidir:

ziyaret edin.

Adres dönüştürmenin işleyiş şekli

Address Validation API, söz konusu URL'nin her bileşenine İngilizce dönüştürmeyi yazmışsınızdır. Bu, administrative_area, locality ve diğer bileşenleri tek tek ele alınır. Görüntüleyin AddressComponent referans dokümanlarında bulabilirsiniz.

Aşağıdaki şemada, İngilizce dönüşümün Calle Dueñas, 5, 41003 Sevilla, İspanya adresi.

Rota, Ülke ve Konum dahil olmak üzere çevrilen adres bileşenleri

İngilizce dönüştürme için değerlendirilen her bileşen için hizmet, ilişkili tüm işlemler gerçekleştirilebilir.

Mümkün olduğunda tamamen çevrilmiş İngilizce kullanılmalıdır.

Bazı adres bileşenlerinin tam çevrilmiş sürümü kullanılabilir. Örneğin, İspanyolca ülkesi España olan dil Spain olarak çevrilir. İçinde bu durumda hizmet İngilizce sürümü kullanır. Bu durum genelde country ve administrative_area_level_1 gibi daha büyük adres bileşenleri

İngilizce kullanılamıyorsa yerel dilin Latin alfabesini kullanır.

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

  • Adresin yerel dilinde Latin alfabesinde karakter kullanılıyorsa ve hizmet için adres bileşeni için İngilizce eşdeğeri yoktur. İngilizce temelli olmayan yerel dildeki karakterleri değiştirir. Örneğin, Calle Dueñas, Calle Duenas haline gelir. Burada ñ değeri: n ile değiştirilir.
  • Adresin yerel dilinde Latin kökenli bir dil kullanılmıyorsa karakter kümesidir ve adres bileşeni için İngilizce eşdeğeri yoktur. hizmet, varsa yerel dilin latin alfabesini kullanır. Örneğin, Japonca bir dönüşüm, Japoncanın Latin alfabesini döndürür. İngilizce olmayan, Latin alfabesinde olmayan tüm karakterlerin yerini İngilizce tabanlı karakterler alır Latin karakterler. Örneğin: 3丁目, 3-chome olur.
    • Önizleme için Japonca'nın henüz etkinleştirilmediğini unutmayın
  • Dilin latin alfabeli sürümü mevcut değilse bileşenler yerel dilde döndürülür.

İngilizce olmayan Latin karakterlerini değiştirir

İngilizce olmayan Latin karakterlerin yerine İngilizce karakterler getirilir eşdeğerdir. Örneğin, aşağıdaki karakterlerin her biri "o" karakteri: anlat, ò, ó, ô, õ, ö, ø, ō, ŏ, ő, ơ, ṍ, ṏ, ṑ, ṓ, ↘, ỏ, ố, yaşadığı, ổ, ỗ, ấ, 設, ờ, ở, ỡ ve ợ. Örneğin:

Calle de Ruiz de Alarcón, Calle de Ruiz de Alarcon oldu

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

Aşağıdaki örnekte Palacio için bir istekten gelen doğrulama yanıtı gösterilmektedir de las Dueñas adıyla İspanya'da. englishLatinAddress kalın harflerle gösterilmiştir. Bu istek languageOptions parametresindeki returnEnglishLatinAddress alanını kullanmıştır. girdi.

"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, bu diller için destek sağlamasa da Önizleme sürümleri, veya Hizmetler'in işlevleri arasında yer alan taleplere ayrı ayrı gelişim aşamaları vardır.

GKST öncesi sürümler için aşağıdaki önerilerden yararlanın:

  • GKST öncesi özellikler Google Haritalar Platformu HDS'si.

  • Özellikle bir üretim ortamındaki GKST öncesi özelliği. Bazı yedek örnekleri şu durumlara örnektir: kotanın aşılması, beklenmedik yanıt kodları ve gecikme, mevcut davranışla karşılaştırıldığında beklenmedik yanıtlar vermelidir.

Yeni özellikler istemek veya değişiklik önermek için sorun izleyiciyi kullanabilirsiniz uyarlayabilirsiniz. İsteğinize aşağıdakileri eklediğinizden emin olun:

  • Eklenmesini istediğiniz özelliği veya davranışı da açıklayın düşünme neden olabilir.

  • Mümkünse kullanım alanınız ve yeni olanak tanıyacağı anlamına gelir.

Bu geri bildirim veya özelliklerle ilgili diğer sorularınız için şu adrese e-posta gönderin: Adres Doğrulama Yardım Hattı: address-validation-hotline@google.com.