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

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

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

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

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

languageOptions: { returnEnglishLatinAddress: "true" }.

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

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'

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

ช่อง englishLatinAddress ใช้โปรโตที่อยู่เดียวกันกับที่ช่อง address ใช้ โดยมีข้อยกเว้นต่อไปนี้

• ไม่มีช่อง ConfirmationLevel
• ช่อง unconfirmedComponentTypes

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

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

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

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

ใช้ภาษาอังกฤษที่แปลทั้งหมดหากเป็นไปได้

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

ใช้การทำให้เป็นภาษาท้องถิ่นของภาษาท้องถิ่นหากไม่มีภาษาอังกฤษ

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

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

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

อักขระละตินที่ไม่ได้เป็นภาษาอังกฤษจะถูกแทนที่ด้วยอักขระภาษาอังกฤษที่เทียบเท่ากัน ตัวอย่างเช่น อักขระแต่ละตัวต่อไปนี้จะถูกแทนที่ด้วยอักขระ "o" ได้แก่ ให้เสร็จสิ้น, ò, ó, ô, õ, ö, ø, ō, », ő, ơ, ṍ, ṏ, ṑ, ṓ, สำหรับคำสั่งซื้อ, JavaScript, ố, ồ, ổ, ở , ồ, ổ, ở เช่น

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

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

ตัวอย่างต่อไปนี้แสดงการตอบกลับการตรวจสอบจากคำขอสำหรับ Palacio de lasDueñ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 จะไม่รองรับเวอร์ชันดูตัวอย่าง ฟีเจอร์ หรือฟังก์ชันการทำงานของบริการ แต่เราจะพิจารณาคำขอในขั้นการพัฒนาเหล่านี้แยกเป็นรายกรณี

ใช้คำแนะนำเหล่านี้สำหรับเวอร์ชันก่อนเวอร์ชันสำหรับผู้ใช้ทั่วไป

• ฟีเจอร์ก่อนเวอร์ชันสำหรับผู้ใช้ทั่วไปไม่อยู่ภายใต้ SLA ของ Google Maps Platform

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

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

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

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

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