วัตถุประสงค์
เอกสารนี้อธิบายวิธีการผสานรวม Place Autocomplete, Address Validation API1 และ Maps ในการชำระเงินของอีคอมเมิร์ซเพื่อรวบรวมที่อยู่คุณภาพสูง
ข้อกำหนดเบื้องต้น
Google ขอแนะนำให้คุณมีความคุ้นเคยกับสิ่งต่อไปนี้
- เอกสารประกอบสำหรับนักพัฒนาแอป JavaScript ของ Place Autocomplete
- ทำความเข้าใจวิธีการทำงานของ Place Autocomplete และตัวเลือกการใช้งานจากมุมมองทางเทคนิค
- คู่มือ การใช้งานการชำระเงิน
สำหรับ Place Autocomplete
- ตัวอย่างแนวทางปฏิบัติแนะนำในการใช้งาน Place Autocomplete ในการชำระเงินของอีคอมเมิร์ซ
- เอกสารประกอบของผลิตภัณฑ์ Address Validation API โดยเน้นที่หัวข้อ, สร้างตรรกะการตรวจสอบความถูกต้อง
- ทำความเข้าใจวิธีการทำงานของ Address Validation API จากมุมมองทางเทคนิค และตรวจสอบสัญญาณที่กำหนดคุณภาพของที่อยู่
การยืนยันที่อยู่คืออะไร
Address Validation API เป็นบริการที่รับที่อยู่ โดยจะระบุคอมโพเนนต์ของที่อยู่และตรวจสอบความถูกต้อง นอกจากนี้ยังกำหนดที่อยู่ให้เป็นมาตรฐานสำหรับการส่งทางไปรษณีย์ และค้นหาพิกัดละติจูด/ลองจิจูดที่ทราบกันดีที่สุดสำหรับที่อยู่นั้น คุณยังเปิดใช้ ระบบสนับสนุนความถูกต้องของการเข้ารหัส (CASS™) สำหรับที่อยู่ในสหรัฐอเมริกาและเปอร์โตริโกได้ด้วย (ไม่บังคับ)เหตุใดคุณจึงต้องมีการยืนยันที่อยู่ในการชำระเงิน
รวบรวมที่อยู่ที่ถูกต้องในระหว่างกระบวนการสั่งซื้อ:
ขั้นตอนนี้มีความสำคัญในการส่งเสริมการจัดส่งที่สำเร็จ เพิ่มการดำเนินการตามคำสั่งซื้อตรงเวลา
และลดค่าใช้จ่ายในการแก้ไขที่อยู่
แนะนำลูกค้าให้ป้อนที่อยู่อย่างรวดเร็วและถูกต้อง:
Place Autocomplete ช่วยเร่งการป้อนที่อยู่และลดข้อผิดพลาดในการป้อนข้อมูล ทำให้
ลูกค้าดำเนินการชำระเงินได้อย่างง่ายดาย Address Validation ให้ความคิดเห็น
เกี่ยวกับคุณภาพโดยรวมของที่อยู่ ทำการแก้ไข เช่น การกำหนดให้เป็นมาตรฐานและ
การสะกดผิด และปรับปรุงข้อมูลเมตา เช่น การระบุว่าเป็นที่อยู่อาศัยหรือ
ที่อยู่ธุรกิจ (มีให้บริการใน บาง
ภูมิภาค)
ภาพรวมการใช้งาน
ส่วนนี้จะสรุปเวิร์กโฟลว์การป้อนที่อยู่ที่แนะนำสำหรับการชำระเงินของอีคอมเมิร์ซ กระบวนการนี้ประกอบด้วย 3 ขั้นตอนดังนี้
- ใช้ Place Autocomplete เพื่อรวบรวมที่อยู่ในขั้นต้น
- ใช้ Address Validation API เพื่อยืนยันที่อยู่ที่ป้อน
- แสดงตำแหน่งของที่อยู่ที่ป้อนบนแผนที่เพื่อให้ลูกค้ามั่นใจในการจัดส่ง
จากนั้นเราจะเจาะลึกแต่ละขั้นตอน
ขั้นตอนที่ 1: ขั้นตอนการป้อนที่อยู่ - ใช้บริการ Place Autocomplete
ใช้ JavaScript API เพื่อติดตั้งใช้งาน Place Autocomplete ในบรรทัดแรกของแบบฟอร์มป้อนที่อยู่
Place Autocomplete จะแสดงคำแนะนำแก่ลูกค้าขณะที่ป้อนรายละเอียดที่อยู่ เมื่อติดตั้งใช้งานโดยใช้ JavaScript API เมื่อผู้ใช้เริ่มพิมพ์ ช่องแบบฟอร์มป้อนที่อยู่จะปรากฏขึ้นพร้อมผลลัพธ์จากบริการ Autocomplete ซึ่งจะอัปเดตทุกครั้งที่พิมพ์ เมื่อผู้ใช้ป้อนข้อมูลมากพอที่จะค้นหาที่อยู่ได้แล้ว ให้เลือกที่อยู่จากรายการแบบเลื่อนลง การดำเนินการนี้จะป้อนข้อมูลที่อยู่ลงในช่องแบบฟอร์มโดยอัตโนมัติ
คุณสามารถแสดงรูปแบบการป้อนแบบฟอร์ม 2 รูปแบบให้ผู้ใช้ด้วย Place Autocomplete ได้แก่ การแสดงช่องที่อยู่ทั้งหมด หรือการแสดงช่องป้อนข้อมูลช่องเดียว ช่องป้อนข้อมูลช่องเดียวนี้จะแจ้งให้ผู้ใช้เริ่มค้นหาขณะที่พิมพ์ แทนที่จะป้อนคอมโพเนนต์ของที่อยู่ทีละรายการ เมื่อการเติมข้อความอัตโนมัติป้อนข้อมูลที่อยู่แล้ว เวิร์กโฟลว์จะขยายช่องแบบฟอร์มด้วยข้อมูลที่อยู่ ทำให้ลูกค้าตรวจสอบและแก้ไขได้ เช่น การเพิ่มหมายเลขอพาร์ตเมนต์หรือหมายเลขห้อง
นี่คือตัวอย่างลักษณะที่ขั้นตอนการทำงานนี้อาจปรากฏขึ้นเมื่อใช้ช่องป้อนข้อมูลช่องเดียว

ขั้นตอนที่ 2: ใช้ Address Validation API เพื่อยืนยันที่อยู่
หลังจากที่ผู้ใช้ป้อนที่อยู่แล้ว Google ขอแนะนำให้คุณเรียก Address Validation API ในการชำระเงินเพื่อยืนยันว่าที่อยู่ถูกต้องและสมบูรณ์ เรียก Address Validation API เมื่อผู้ใช้คลิกปุ่ม "ถัดไป" หรือ "ดำเนินการต่อ" ในแบบฟอร์มที่อยู่ ปุ่มนี้มักจะนำไปยังหน้าการชำระเงิน
Google ขอแนะนำให้เรียก Address Validation API สำหรับทุกธุรกรรม
แผนภาพขั้นตอนการทำงานต่อไปนี้แสดงตัวอย่างการผสานรวม Address Validation API แบบครบวงจรภายในขั้นตอนการชำระเงิน

เอกสารนี้จะกล่าวถึงสถานการณ์การยอมรับที่อยู่ในภายหลัง
ขั้นตอนที่ 3: แสดงการยืนยันด้วยภาพ
หลังจากป้อนที่อยู่แล้ว ให้แสดงการยืนยันตำแหน่งการจัดส่งด้วยภาพแก่ผู้ใช้โดยแสดงตำแหน่งบนแผนที่ วิธีนี้จะช่วยให้ลูกค้ามั่นใจมากขึ้นว่าที่อยู่ถูกต้อง และลดความล้มเหลวในการจัดส่งหรือการรับสินค้า
คุณสามารถแสดงแผนที่ในระหว่างกระบวนการชำระเงิน หรือส่งแผนที่ภายในอีเมลยืนยันธุรกรรม ทั้ง 2 กรณีการใช้งานนี้สามารถทำได้ด้วย API ต่อไปนี้
| Maps JavaScript API มีแผนที่แบบโต้ตอบสำหรับแสดงตำแหน่งของผู้ใช้ | Maps Static API อนุญาตให้ฝังรูปภาพภายในหน้าเว็บหรือในอีเมลในขั้นตอนต่อมา |
|---|---|
![]() |
![]() |
เจาะลึก - สถานการณ์การยอมรับที่อยู่
คุณสามารถจัดหมวดหมู่การตอบกลับของ Address Validation API เป็น 3 สถานการณ์หลักๆ ได้ดังนี้
- แก้ไข—ที่อยู่มีคุณภาพต่ำ คุณควรแจ้งให้ผู้ใช้ป้อนข้อมูลเพิ่มเติม
- ยืนยัน—ที่อยู่มีคุณภาพสูง แต่มีการ เปลี่ยนแปลงจากที่อยู่ที่ป้อน คุณอาจแจ้งให้ผู้ใช้ยืนยัน
- ยอมรับ—ที่อยู่มีคุณภาพสูง คุณสามารถ ยอมรับที่อยู่ที่ระบุได้
แนวคิดนี้ครอบคลุมอยู่ในส่วนสร้างตรรกะการตรวจสอบความถูกต้อง ของเอกสารประกอบ Address Validation API และเราจะกล่าวถึงแต่ละสถานการณ์ใน ส่วนนี้
แก้ไข
ส่วนนี้แสดงวิธีแก้ไขที่อยู่ที่ป้อน ดูข้อมูลเกี่ยวกับสัญญาณเฉพาะ ที่ Address Validation API ส่งคืนเพื่อระบุว่าที่อยู่มีคุณภาพต่ำ ได้ที่หัวข้อแก้ไขที่อยู่ ในเอกสารประกอบสร้างตรรกะการตรวจสอบความถูกต้อง
หากการตอบกลับจาก Address Validation API ระบุว่าที่อยู่ไม่ถูกต้อง ให้เปลี่ยนเส้นทางลูกค้าไปยังแบบฟอร์มป้อนที่อยู่เพื่อให้ตรวจสอบข้อมูลที่ป้อน เมื่อแก้ไขที่อยู่แล้ว บริการของคุณควรส่งที่อยู่อีกครั้งไปยัง Address Validation API เพื่อให้แน่ใจว่าการแก้ไขถูกต้อง
นอกจากนี้ คุณยังไฮไลต์ข้อผิดพลาดเฉพาะบรรทัดที่อยู่ได้โดยใช้สัญญาณที่ส่งคืนในระดับ addressComponents ตัวอย่างของสัญญาณนี้จะแสดงในภาพหน้าจอทางด้านขวา
ยืนยัน
ส่วนนี้แสดงวิธียืนยันที่อยู่ ดูข้อมูลเกี่ยวกับสัญญาณเฉพาะที่ Address Validation API ส่งคืนเพื่อระบุว่าควรยืนยันที่อยู่ได้ที่ หัวข้อการยืนยันที่อยู่ ในเอกสารประกอบสร้างตรรกะการตรวจสอบความถูกต้อง
ระบบมักจะแจ้งให้ผู้ใช้ยืนยันที่อยู่ ตัวอย่างเช่น ลูกค้าสะกดชื่อเมืองผิด ซึ่ง Address Validation API จะแก้ไขให้ถูกต้อง คุณควรยืนยันการแก้ไขนี้กับลูกค้า เนื่องจากการเปลี่ยนแปลงที่ API ทำอาจเปลี่ยนแปลงข้อมูลที่ป้อนไว้เดิมโดยสิ้นเชิง
ใช้โมดัลคั่นระหว่างหน้าเพื่อแสดงข้อมูลแก่ลูกค้า โดยมี 3 ตัวเลือกให้ดำเนินการต่อดังนี้
- ยืนยันที่อยู่ที่ API ส่งคืน และกระบวนการชำระเงินจะดำเนินต่อไปโดยใช้ที่อยู่ที่แก้ไขแล้ว
- เลือกที่อยู่ที่ป้อนไว้เดิม โดยไม่สนใจการแก้ไขจาก Address Validation API กระบวนการชำระเงินจะดำเนินต่อไปตามปกติ และระบบอาจติดแฟล็กคำสั่งซื้อเพื่อตรวจสอบเพิ่มเติมก่อนจัดส่ง หากกระบวนการของคุณอนุญาต
- ลูกค้ายกเลิกหรือออกจากโมดัล ซึ่งจะนำลูกค้ากลับไปยังขั้นตอนการป้อนที่อยู่ของกระบวนการชำระเงิน โดยลูกค้าสามารถป้อนที่อยู่อีกครั้งตั้งแต่ต้นเพื่อเริ่มกระบวนการใหม่
ตัวอย่างของสัญญาณนี้จะแสดงในภาพหน้าจอทางด้านขวา
ยอมรับ
ส่วนนี้แสดงวิธียอมรับที่อยู่ ดูข้อมูลเกี่ยวกับสัญญาณเฉพาะที่ Address Validation API ส่งคืนเพื่อระบุว่าที่อยู่มีคุณภาพดีและควรยอมรับได้ที่หัวข้อการยอมรับที่อยู่ในเอกสารประกอบสร้างตรรกะการตรวจสอบความถูกต้อง
ในสถานการณ์นี้ กระบวนการชำระเงินควรย้ายไปยังขั้นตอนถัดไป ซึ่งน่าจะเป็นการเรียกเก็บเงิน โดยไม่มีการแจ้งให้ลูกค้าทราบเกี่ยวกับคุณภาพของที่อยู่ API ได้ยืนยันแล้วว่าที่อยู่ที่ลูกค้าป้อนมีคุณภาพดีและจัดส่งได้
เราขอแนะนำให้ใช้ข้อมูลที่อยู่ที่ส่งคืนจาก Address Validation API กับคำสั่งซื้อ เนื่องจากข้อมูลนี้อาจมีการแก้ไขและการเพิ่มเล็กน้อย เช่น
- การใช้อักษรตัวพิมพ์ใหญ่
- การแก้ไขการจัดรูปแบบ เช่น
- Street เป็น St
- การจัดลำดับคอมโพเนนต์ของที่อยู่ที่ถูกต้อง
- ZIP+4 ในสหรัฐอเมริกา
ข้อควรพิจารณาในการติดตั้งใช้งาน
เมื่อสร้างตรรกะการยอมรับที่อยู่ โปรดตรวจสอบว่าการติดตั้งใช้งานของคุณไม่ได้บล็อกไม่ให้ลูกค้าชำระเงินเนื่องจากป้อนที่อยู่ไม่ถูกต้อง สร้างตรรกะในลักษณะที่ป้องกันไม่ให้เกิดลูปไม่สิ้นสุดหาก API ระบุซ้ำๆ ว่าข้อมูลที่ป้อนไม่ถูกต้อง
Google ขอแนะนำให้คุณให้โอกาสลูกค้าป้อนที่อยู่ได้สูงสุด 2 ครั้ง และยอมรับข้อมูลที่ป้อนในการป้อนครั้งที่ 2 แม้ว่าข้อมูลนั้นจะไม่ผ่านการตรวจสอบความถูกต้องก็ตาม เป้าหมายในการป้อนครั้งที่ 2 คือการอนุญาตให้ลูกค้าดำเนินการต่อได้โดยไม่คำนึงถึงการตรวจสอบความถูกต้อง
2 วิธีที่แนะนำในการยอมรับการป้อนครั้งที่ 2
- บังคับให้ดำเนินการต่อ: แสดงโมดัลแก่ลูกค้าเพื่ออธิบายว่าที่อยู่ไม่ผ่านการตรวจสอบความถูกต้อง แต่ให้ตัวเลือกในการดำเนินการต่อด้วยที่อยู่ที่พิมพ์
- การยอมรับแบบเงียบ: ยอมรับการป้อนครั้งที่ 2 โดยอัตโนมัติโดยไม่มีขั้นตอนการยืนยัน แม้ว่าที่อยู่จะไม่ผ่านการตรวจสอบความถูกต้องอย่างสมบูรณ์ก็ตาม
หากเป็นไปได้ ให้ออกแบบระบบเพื่อติดแฟล็กที่อยู่ที่ไม่ผ่านการตรวจสอบความถูกต้อง เพื่อให้ตัวแทนฝ่ายบริการลูกค้าตรวจสอบที่อยู่เหล่านั้นได้ก่อนจัดส่งคำสั่งซื้อ มาตรการเพิ่มเติมนี้จะช่วยให้คุณตรวจพบข้อผิดพลาด
การก่อสร้างอาคารใหม่เป็นตัวอย่างที่ดีที่แสดงให้เห็นว่าเหตุใดจึงแนะนำให้ตรวจสอบนี้ อาจมีช่องว่างระหว่างเวลาที่การก่อสร้างอาคารใหม่เสร็จสิ้นกับเวลาที่ระบบป้อนที่อยู่ของอาคารนั้นลงในฐานข้อมูลที่อยู่ไปรษณีย์ ลูกค้าควรมีตัวเลือกในการบังคับให้ดำเนินการต่อผ่านหน้าชำระเงินด้วยที่อยู่ที่พิมพ์ แม้ว่าที่อยู่นั้นจะไม่ผ่านการตรวจสอบความถูกต้องก็ตาม
เมื่อเซสชันการชำระเงินเสร็จสมบูรณ์แล้ว ให้ใช้
provideValidationFeedback
เพื่อส่งความคิดเห็นเกี่ยวกับความพยายามในการยืนยันที่อยู่เฉพาะไปยัง Google (ไม่บังคับ)
บทสรุป
เอกสารนี้ได้ให้ภาพรวมของขั้นตอนการชำระเงินที่ใช้การเติมข้อความอัตโนมัติ Address Validation และการยืนยันด้วยภาพบน Google Maps ใช้เอกสารนี้เป็นจุดเริ่มต้นในการออกแบบการติดตั้งใช้งานโดยทำตามขั้นตอนการป้อนที่อยู่ที่แนะนำ
ขั้นตอนถัดไป
อ่านเพิ่มเติมที่แนะนำ

- เอกสารประกอบของ Place Autocomplete
- เอกสารประกอบของ Address Validation API
- การรายงานของ Google Maps Platform
ผู้ร่วมให้ข้อมูล
Henrik Valve | วิศวกรโซลูชัน
Thomas Anglaret | วิศวกรโซลูชัน
Sarthak Ganguly | วิศวกรโซลูชัน
-
ผู้รับอนุญาตแบบไม่ผูกขาดของไปรษณีย์สหรัฐอเมริกา เครื่องหมายการค้าต่อไปนี้เป็นของไปรษณีย์สหรัฐอเมริกา® และใช้โดยได้รับอนุญาต: CASS™, USPS®, DPV® ↩

