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

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

