แปลงที่อยู่เป็นภาษาอังกฤษ

เมื่อใช้ Address Validation API คุณสามารถขอให้การตอบกลับการตรวจสอบแสดงผลที่อยู่ที่แปลงเป็นภาษาอังกฤษด้วย ใช้ฟีเจอร์นี้เมื่อระบบของคุณต้องระบุข้อมูลที่อยู่ด้วยอักขระละตินตามภาษาอังกฤษเมื่อได้รับที่อยู่ซึ่งมาจากภาษาที่ไม่ใช่ภาษาอังกฤษ เช่น

  • บริษัทของคุณอาจดำเนินการตามคำขอจัดส่งจากทั่วโลก และใช้ตัวอักษรละตินและอักษรภาษาอังกฤษเพื่อทำให้ที่อยู่ทั้งหมดเป็นมาตรฐาน
  • ธุรกิจของคุณอาจจัดการการจัดส่งไปยังและจากประเทศที่ใช้ภาษาที่แตกต่างจากภาษาของที่อยู่ที่ให้ไว้

วิธีแสดงผลที่อยู่เป็นภาษาอังกฤษ

หากต้องการขอการยืนยันที่อยู่ที่มีองค์ประกอบที่เทียบเท่าภาษาอังกฤษรวมอยู่ด้วย ให้เพิ่มข้อมูลต่อไปนี้ลงในเนื้อหาคำขอการยืนยัน

"languageOptions": { "returnEnglishLatinAddress": "true" }

ตัวอย่างต่อไปนี้ขอคอมโพเนนต์ภาษาอังกฤษขณะยืนยันที่อยู่ของพิพิธภัณฑ์ Prado

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'

คำตอบจะแสดงที่อยู่ภาษาอังกฤษในช่อง englishLatinAddress ดูรายละเอียดได้จากตัวอย่าง Conversion ของที่อยู่ด้านล่าง ระบบจะแปลงองค์ประกอบแต่ละรายการของที่อยู่ภาษาท้องถิ่นที่แสดงผลเป็นภาษาอังกฤษอย่างดีที่สุด ที่อยู่แปลงแล้วจะใช้ซ้ำเป็นอินพุตของ API ไม่ได้

ฟิลด์ englishLatinAddress ใช้ Address proto เดียวกันกับที่ฟิลด์ address ใช้ โดยมีข้อยกเว้นต่อไปนี้

วิธีการทำงานของ Conversion ที่อยู่

Address Validation API จะใช้การแปลงภาษาอังกฤษกับองค์ประกอบแต่ละรายการของที่อยู่ ซึ่งหมายความว่าระบบจะจัดการ administrative_area, locality และองค์ประกอบอื่นๆ ของที่อยู่แยกกัน ดูรายการคอมโพเนนต์ที่อยู่ได้ที่ AddressComponent ในเอกสารอ้างอิง

แผนภาพต่อไปนี้แสดงลักษณะของการแปลงเป็นภาษาอังกฤษสำหรับที่อยู่ Calle Dueñas, 5, 41003 Sevilla, España

คอมโพเนนต์ที่อยู่ที่ได้รับการแปลแล้ว ซึ่งรวมถึงเส้นทาง ประเทศ และสถานที่

สําหรับคอมโพเนนต์แต่ละรายการที่ประเมินเพื่อแปลงเป็นภาษาอังกฤษ บริการจะใช้กระบวนการที่อธิบายไว้ในส่วนต่อไปนี้

ใช้ภาษาอังกฤษที่แปลแล้วอย่างสมบูรณ์เมื่อเป็นไปได้

องค์ประกอบที่อยู่บางรายการอาจมีเวอร์ชันที่แปลแล้วทั้งหมดให้ใช้งาน เช่น ประเทศ España ของสเปนจะแปลเป็น Spain ในกรณีนี้ บริการจะใช้เวอร์ชันภาษาอังกฤษ กรณีนี้มักเกิดขึ้นกับองค์ประกอบที่อยู่ขนาดใหญ่ เช่น country และ administrative_area_level_1

ใช้การถอดเสียงภาษาท้องถิ่นเป็นภาษาละตินหากไม่มีภาษาอังกฤษ

การแปลงเป็นอักษรละตินหมายถึงการแปลงภาษาท้องถิ่นเป็นอักษรละตินโดยใช้การถอดเสียง

  • หากภาษาท้องถิ่นของที่อยู่ใช้ชุดอักขระละติน และไม่มีองค์ประกอบที่อยู่ภาษาอังกฤษที่เทียบเท่า บริการจะแทนที่อักขระจากภาษาท้องถิ่นที่ไม่ใช่ภาษาอังกฤษ เช่น Calle Dueñas จะกลายเป็น Calle Duenas โดยระบบจะแทนที่ ñ ด้วย n
  • หากภาษาท้องถิ่นของที่อยู่ไม่ได้ใช้ชุดอักขระจากภาษาละติน และไม่มีองค์ประกอบที่อยู่ภาษาอังกฤษที่เทียบเท่า บริการจะใช้ภาษาท้องถิ่นเวอร์ชันละติน (หากมี) เช่น การแปลงภาษาญี่ปุ่นจะแสดงการถอดเสียงภาษาญี่ปุ่นเป็นอักษรโรมัน ระบบจะแทนที่อักขระที่ไม่ใช่ภาษาอังกฤษและไม่ใช่ละตินด้วยอักขระละตินตามภาษาอังกฤษ เช่น 3丁目 จะกลายเป็น 3-chome
    • โปรดทราบว่าภาษาญี่ปุ่นยังไม่พร้อมใช้งานในเวอร์ชันตัวอย่าง
  • หากไม่มีภาษาเวอร์ชันละติน ระบบจะแสดงคอมโพเนนต์เป็นภาษาท้องถิ่น

แทนที่ด้วยอักขระละตินที่ไม่ใช่ภาษาอังกฤษ

ระบบจะแทนที่อักขระละตินที่ไม่ใช่ภาษาอังกฤษด้วยอักขระภาษาอังกฤษที่เทียบเท่า ตัวอย่างเช่น ระบบจะแทนที่อักขระต่อไปนี้ด้วยอักขระ "o" ð, ò, ó, ô, õ, ö, ø, ō, ŏ, ő, ơ, ṍ, ṏ, ṑ, ṓ, ọ, ỏ, ố, ồ, ổ, ỗ, ộ, ớ, ờ, ở, ỡ และ ợ เช่น

Calle de Ruiz de Alarcón เปลี่ยนเป็น Calle de Ruiz de Alarcon

ตัวอย่างการแปลงที่อยู่

ตัวอย่างต่อไปนี้แสดงการตอบกลับการตรวจสอบจากคำขอสำหรับ Palacio de las Dueñas ในสเปน โดยที่ englishLatinAddress เป็นตัวหนา คําขอนี้ใช้ช่อง returnEnglishLatinAddress ในพารามิเตอร์ languageOptions ในอินพุต

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

ตัวเลือกการสนับสนุนสำหรับรุ่นตัวอย่าง

แม้ว่า Google จะไม่ให้การสนับสนุนสำหรับเวอร์ชันตัวอย่าง ฟีเจอร์ หรือฟังก์ชันการทำงานของบริการ แต่เราจะพิจารณาคำขอในระยะการพัฒนาเหล่านี้เป็นกรณีไป

ใช้คําแนะนําเหล่านี้สําหรับเวอร์ชันก่อน GA

  • ฟีเจอร์ก่อนเปิดตัวทั่วไปไม่อยู่ภายใต้SLA ของ Google Maps Platform

  • ใช้กลไกสำรอง โดยเฉพาะหากคุณใช้ฟีเจอร์ก่อน GA ในสภาพแวดล้อมที่ใช้งานจริง ตัวอย่างสถานการณ์สําหรับการตอบกลับสำรอง ได้แก่ โค้ดการตอบกลับและเวลาในการตอบสนองที่ไม่คาดคิด โควต้าเกิน หรือคำตอบที่ไม่คาดคิดเมื่อเทียบกับลักษณะการทำงานที่มีอยู่

คุณสามารถใช้เครื่องมือติดตามปัญหาเพื่อขอฟีเจอร์ใหม่หรือแนะนำการแก้ไขฟีเจอร์ที่มีอยู่ได้ โปรดระบุข้อมูลต่อไปนี้ในคำขอของคุณ

  • อธิบายฟีเจอร์หรือลักษณะการทำงานที่เฉพาะเจาะจงที่คุณต้องการให้เพิ่ม รวมถึงเหตุผลที่คุณคิดว่าฟีเจอร์หรือลักษณะการทำงานนั้นสำคัญ

  • หากเป็นไปได้ ให้ระบุรายละเอียดที่เฉพาะเจาะจงเกี่ยวกับกรณีการใช้งานและโอกาสใหม่ๆ ที่ฟีเจอร์จะมอบให้

หากต้องการแสดงความคิดเห็นนี้หรือมีคำถามอื่นๆ เกี่ยวกับฟีเจอร์ โปรดส่งอีเมลไปที่สายด่วนสำหรับการยืนยันที่อยู่: address-validation-hotline@google.com