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

เมื่อใช้ 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 จะใช้ฟิลด์ ที่อยู่ Proto อย่างที่ฟิลด์ address ใช้ โดยมีข้อยกเว้นดังต่อไปนี้

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

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": ให้เสร็จสิ้น, ò, ó, ô, õ, ö, ø, ō, , ő, ơ, ṍ, ṏ, ṑ, ṓ, เป็นผู้นำ, ỏ, ố, ồ, ổ, ỗ, search, 红, ờ, ở, ỡ และ ợ เช่น

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

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

ตัวอย่างต่อไปนี้แสดงการตอบกลับการตรวจสอบจากคำขอสำหรับ Palacio de las Duetñ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