เมื่อใช้ 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 ดูรายละเอียดได้ในตัวอย่างการแปลงที่อยู่ด้านล่าง ระบบจะแปลงคอมโพเนนต์ของที่อยู่ภาษาท้องถิ่นที่ส่งคืนเป็นภาษาอังกฤษให้ได้มากที่สุด ที่อยู่ที่แปลงแล้วจะนำมาใช้ซ้ำเป็นอินพุตไปยัง API ไม่ได้
ช่อง englishLatinAddress ใช้โปรโตคอลที่อยู่เดียวกับที่ช่อง address ใช้ โดยมีข้อยกเว้นต่อไปนี้
- ไม่มีช่อง
ConfirmationLevel - ไม่มี
unconfirmedComponentTypesช่อง
วิธีการทำงานของการแปลงที่อยู่
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 - หากภาษาท้องถิ่นของที่อยู่ไม่ได้ใช้ชุดอักขระแบบละติน และไม่มีภาษาอังกฤษที่เทียบเท่าสำหรับคอมโพเนนต์ที่อยู่ บริการจะใช้ภาษาท้องถิ่นของเวอร์ชันลาติน หากมี
ตัวอย่างเช่น Conversion ภาษาญี่ปุ่นจะแสดงอักษรญี่ปุ่นเป็นอักษรโรมัน
อักขระที่ไม่ใช่อักขระละตินที่ไม่ใช่ภาษาอังกฤษจะแทนที่ด้วยอักขระละตินที่ใช้ภาษาอังกฤษ เช่น 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"