เมื่อใช้ 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
ใช้ โดยมีข้อยกเว้นต่อไปนี้
- ไม่มีช่อง
ConfirmationLevel
- ไม่มี
unconfirmedComponentTypes
ช่อง
วิธีการทำงานของ 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