Halaman ini diterjemahkan oleh Cloud Translation API.

Konversikan alamat ke dalam bahasa Inggris

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

Perusahaan Anda mungkin memenuhi permintaan pengiriman dari seluruh dunia dan menggunakan karakter Latin yang 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 di alamat yang diberikan.

Cara mengembalikan alamat dalam bahasa Inggris

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

languageOptions: { returnEnglishLatinAddress: "true" }.

Contoh berikut meminta komponen berbasis bahasa Inggris saat memverifikasi alamat 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 Contoh konversi alamat di bawah untuk mengetahui detailnya. Setiap komponen alamat bahasa lokal yang ditampilkan dikonversi sebaik mungkin ke dalam bahasa Inggris. Alamat yang dikonversi tidak dapat digunakan kembali sebagai input untuk API.

Kolom englishLatinAddress menggunakan prototipe Address yang sama seperti yang digunakan kolom address, dengan pengecualian berikut:

Tidak ada kolom ConfirmationLevel
Tidak ada kolom unconfirmedComponentTypes

Cara kerja konversi alamat

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

Diagram berikut mengilustrasikan tampilan konversi bahasa Inggris untuk 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 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. Dalam hal ini, layanan tersebut menggunakan versi bahasa Inggris. Hal ini biasanya terjadi untuk komponen alamat yang lebih besar seperti country dan administrative_area_level_1.

Menggunakan latinisasi bahasa lokal jika bahasa Inggris tidak tersedia

Latinisasi berarti bahasa lokal dikonversi ke skrip Latin menggunakan transkripsi.

Jika bahasa lokal alamat menggunakan himpunan karakter Latin, dan tidak ada padanan bahasa Inggris untuk komponen alamat, layanan akan mengganti karakter dari bahasa lokal yang bukan berbasis bahasa Inggris. Misalnya, Calle Dueñas menjadi Calle Duenas, dengan ñ diganti dengan n.
Jika bahasa lokal alamat tidak menggunakan himpunan karakter berbasis Latin, dan tidak ada padanan bahasa Inggris untuk komponen alamat, layanan akan 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 Latin berbasis bahasa Inggris. Misalnya: 3丁目 menjadi 3-chome.
- Perhatikan bahwa bahasa Jepang belum diaktifkan untuk pratinjau
Jika versi bahasa Latin tidak tersedia, komponen akan ditampilkan dalam bahasa lokal.

Mengganti karakter Latin yang tidak dalam bahasa Inggris

Karakter Latin yang tidak berbahasa Inggris akan diganti dengan karakter bahasa Inggris yang setara. Misalnya, setiap karakter berikut akan diganti dengan karakter "o": 📣, ỗ, ô, õ, ö, ø, ō, kombinasi, ő, ơ, ṍ, ṏ, ṑ, ṓ, ọ, ỏ, ố, energi, ổ, ỗợ demografi 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 di 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, fitur, atau fungsi Pratinjau, kami mempertimbangkan permintaan pada tahap pengembangan ini berdasarkan 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 fitur pra-GA di lingkungan produksi. Beberapa contoh situasi penggantian adalah: kuota terlampaui, latensi dan kode respons yang tidak terduga, atau respons tidak terduga jika dibandingkan dengan perilaku yang sudah ada.

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

Jelaskan fitur atau perilaku spesifik yang Anda ingin agar ditambahkan, serta alasan yang menurut Anda penting.
Jika memungkinkan, sertakan detail spesifik tentang kasus penggunaan Anda dan peluang baru yang akan dimungkinkan oleh fitur tersebut.

Untuk menerima masukan ini atau jika ada pertanyaan lain terkait fitur, kirimkan email ke Saluran Validasi Alamat: address-validation-hotline@google.com.