เมื่อใช้ 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