Konversikan alamat ke dalam bahasa Inggris

Saat menggunakan Address Validation API, Anda dapat meminta agar validasi juga menampilkan alamat yang dikonversi ke bahasa Inggris. Gunakan fitur ini saat sistem Anda perlu menyediakan informasi alamat dalam bahasa Latin yang berbasis karakter karakter ketika menerima alamat yang berasal dari bahasa selain Inggris. Contoh:

  • Perusahaan Anda mungkin memenuhi permintaan pengiriman dari seluruh dunia dan menggunakan Karakter Latin berbasis bahasa Inggris dan Inggris untuk menstandarkan semua alamat.
  • Bisnis Anda mungkin menangani pengiriman ke dan dari negara yang menggunakan bahasa yang berbeda dengan bahasa alamat yang diberikan.

Cara mengembalikan alamat dalam bahasa Inggris

Untuk meminta validasi alamat dengan komponen setara dalam bahasa Inggris yang disertakan, tambahkan hal berikut ke isi permintaan validasi:

languageOptions: { returnEnglishLatinAddress: "true" }.

Contoh berikut meminta komponen berbasis bahasa Inggris saat memverifikasi ke Prado Museum:

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'

Respons akan menampilkan alamat dalam bahasa Inggris di kolom englishLatinAddress. Lihat Untuk mengetahui detailnya, lihat contoh konversi alamat di bawah ini. Masing-masing komponen alamat bahasa lokal yang dikembalikan dikonversi ke bahasa Inggris sebagai sebaik mungkin. Alamat yang dikonversi tidak dapat digunakan kembali sebagai input untuk API.

Kolom englishLatinAddress menggunakan kolom Alamat proto yang digunakan kolom address, dengan pengecualian berikut:

Cara kerja konversi alamat

Address Validation API menerapkan konversi bahasa Inggris ke setiap komponen dari alamat tersebut. Ini berarti bahwa administrative_area, locality, dan komponen alamat diperlakukan satu per satu. Lihat AddressComponent di dokumentasi referensi untuk mengetahui daftar komponen alamat.

Diagram berikut menggambarkan seperti apa konversi bahasa Inggris nantinya alamat Calle Dueñas, 5, 41003 Sevilla, España.

Komponen alamat yang diterjemahkan, termasuk Rute, Negara, dan Lokalitas

Untuk setiap komponen yang dievaluasi untuk konversi bahasa Inggris, layanan ini menggunakan atribut proses yang dijelaskan di bagian berikut.

Menggunakan bahasa Inggris yang diterjemahkan sepenuhnya jika memungkinkan

Beberapa komponen alamat mungkin memiliki versi terjemahan penuh yang tersedia untuk digunakan. Misalnya, negara Spanyol, España, akan diterjemahkan ke Spain. Di beberapa jika demikian, layanan tersebut menggunakan versi bahasa Inggris. Hal ini biasanya terjadi pada komponen alamat yang lebih besar seperti country dan administrative_area_level_1.

Menggunakan latinisasi bahasa lokal jika bahasa Inggris tidak tersedia

Latinisasi berarti bahwa bahasa lokal dikonversi ke skrip Latin menggunakan transkripsi.

  • Jika bahasa lokal alamat menggunakan karakter Latin diatur, dan tidak ada padanan dalam bahasa Inggris untuk komponen alamat, yakni layanan mengganti karakter dari bahasa lokal yang bukan berbasis bahasa Inggris. Misalnya, Calle Dueñas menjadi Calle Duenas, dengan ñ adalah diganti dengan n.
  • Jika bahasa lokal alamat tidak menggunakan bahasa Latin himpunan karakter, dan tidak ada padanan bahasa Inggris untuk komponen alamat, layanan menggunakan versi latin dari bahasa lokal, jika tersedia. Misalnya, konversi Jepang akan menampilkan huruf romawi dari bahasa Jepang. Semua karakter non-Inggris dan non-Latin akan diganti dengan karakter berbasis bahasa Inggris Karakter Latin. Misalnya: 3丁目 menjadi 3-chome.
    • Perhatikan bahwa bahasa Jepang belum diaktifkan untuk pratinjau
  • Jika versi bahasa Latin tidak tersedia, komponennya akan dalam bahasa lokal.

Mengganti karakter Latin yang tidak dalam bahasa Inggris

Karakter Latin yang tidak berbahasa Inggris diganti dengan karakter bahasa Inggris ekuivalen. Misalnya, masing-masing karakter berikut akan diganti dengan karakter "o": DI, ò, ó, ô, õ, ö, ø, ō, logo, ő, ơ, ṍ, ṏ, ṑ, ṓ, ọ, ỏ, ố, Kemudian, ổ, ỗ, Work, ờ, ờ, ở, ỡ, dan ợ. Contoh:

Calle de Ruiz de Alarcón menjadi Calle de Ruiz de Alarcon

Contoh konversi alamat

Contoh berikut menunjukkan respons validasi dari permintaan untuk Palacio de las Dueñas di Spanyol, dengan englishLatinAddress dicetak tebal. Permintaan ini menggunakan kolom returnEnglishLatinAddress dalam parameter languageOptions pada input.

"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"

Opsi dukungan untuk rilis Pratinjau

Meskipun Google tidak menyediakan dukungan untuk Versi Pratinjau, fitur, atau fungsi Layanan, kami mempertimbangkan permintaan pada tahapan perkembangan secara kasus per kasus.

Gunakan rekomendasi berikut untuk versi pra-GA:

  • Fitur Pra-GA tidak tercakup dalam SLA Google Maps Platform.

  • Gunakan mekanisme penggantian, terutama jika Anda menggunakan pra-GA di lingkungan produksi. Beberapa contoh penggantian yaitu: kuota terlampaui, kode respons dan latensi yang tidak terduga, yang tidak terduga jika dibandingkan dengan perilaku yang sudah ada.

Anda dapat menggunakan issue tracker untuk meminta fitur baru atau menyarankan modifikasi dengan fitur yang sudah ada. Pastikan untuk menyertakan hal berikut dalam permintaan Anda:

  • Jelaskan juga fitur atau perilaku spesifik yang ingin Anda tambahkan serta alasan mengapa Anda menganggap hal tersebut penting.

  • Jika memungkinkan, sertakan detail spesifik tentang kasus penggunaan Anda dan peluang yang memungkinkan untuk fitur tersebut.

Untuk masukan ini atau pertanyaan lain tentang fitur, kirim email ke Hotline Validasi Alamat: address-validation-hotline@google.com.