คู่มือการใช้งานธุรกรรมที่สมบูรณ์ขึ้น

ภาพรวม

ผู้ใช้มักเข้าใจรายการธุรกรรมได้ยาก เนื่องจากมีการใช้อักษรย่อ เช่น "ACMEHCORP" แทนชื่อผู้ขาย เช่น "Acme Houseware" ซึ่งอาจส่งผลให้มีการโทรติดต่อฝ่ายสนับสนุนลูกค้าและการโต้แย้งที่มีค่าใช้จ่ายมากขึ้น ธุรกรรมที่สมบูรณ์จะลดความซับซ้อนของธุรกรรมเหล่านี้และทําให้ใช้งานได้ง่ายขึ้นด้วยการระบุชื่อเต็มและหมวดหมู่ธุรกิจของผู้ขาย รูปภาพหน้าร้าน ที่อยู่และตําแหน่งบนแผนที่ ข้อมูลติดต่อแบบเต็ม และอื่นๆ วิธีนี้จะช่วยเพิ่มความพึงพอใจและความโปร่งใสของผู้ใช้ รวมถึงลดการโทรติดต่อฝ่ายสนับสนุนลูกค้า เพิ่ม NPS และกระตุ้นให้ผู้ใช้ใช้เวลาในแอปนานขึ้น

ธุรกรรมที่สมบูรณ์ยิ่งขึ้น ซึ่งเป็นคู่มือการใช้งานและเคล็ดลับการปรับแต่งที่เราให้ไว้ในหัวข้อนี้ เป็นตัวเลือกที่แนะนำสำหรับการใช้ Google Maps Platform API ร่วมกันอย่างมีประสิทธิภาพสูงสุดเพื่อสร้างประสบการณ์การใช้งานประวัติธุรกรรมที่ยอดเยี่ยมให้แก่ผู้ใช้ คู่มือการใช้งานนี้จะแสดงวิธีจับคู่สถานที่ตั้งกับผู้ขายที่เฉพาะเจาะจงและแสดงข้อมูลโดยละเอียดของผู้ขาย

กำลังเปิดใช้ API

หากต้องการใช้ธุรกรรมที่สมบูรณ์ยิ่งขึ้น คุณต้องเปิดใช้ API ต่อไปนี้ในคอนโซล Google Cloud ไฮเปอร์ลิงก์ต่อไปนี้จะนำคุณไปยัง Google Cloud Console เพื่อเปิดใช้ API แต่ละรายการสําหรับโปรเจ็กต์ที่เลือก

• Places API
• Geocoding API
• Maps Static API, Maps SDK สําหรับ Android หรือ Maps SDK สําหรับ iOS

ส่วนต่างๆ ในคู่มือการใช้งาน

ต่อไปนี้คือการติดตั้งใช้งานและการปรับแต่งที่เราจะกล่าวถึงในหัวข้อนี้

• check_circle_filled ไอคอนเครื่องหมายถูกเป็นขั้นตอนการติดตั้งใช้งานหลัก
• stars ไอคอนดาวเป็นการปรับแต่งที่ไม่บังคับแต่แนะนําเพื่อปรับปรุงโซลูชัน

แผนภาพต่อไปนี้แสดงวิธีที่แอปพลิเคชันจับคู่ธุรกรรมของผู้ขายเพื่อแสดงผลลัพธ์โดยใช้รายละเอียดสถานที่จากฐานข้อมูลที่มีอยู่ของผู้ขาย หรือผ่านคำขอค้นหาสถานที่

การขอรหัสสถานที่ของ Google Maps Platform

คุณอาจมีฐานข้อมูลผู้ขายที่มีข้อมูลพื้นฐาน เช่น ชื่อและที่อยู่ของธุรกิจ หากต้องการดูข้อมูลที่ Google Maps Platform มีเกี่ยวกับสถานที่นั้น ซึ่งรวมถึงข้อมูลติดต่อและข้อมูลที่ผู้ใช้ให้ไว้ คุณจะต้องมีรหัสสถานที่ของ Google Maps Platform ที่สอดคล้องกับผู้ขายแต่ละรายในฐานข้อมูล

หากต้องการรับรหัสสถานที่ของธุรกิจ ให้ส่งคำขอไปยังปลายทาง /findplacefromtext ใน Places API และขอเฉพาะช่อง place_id เพื่อเรียกเก็บเงินคำขอเป็นการค้นหาสถานที่ - รหัสเท่านั้นแบบไม่เสียค่าใช้จ่าย หากผู้ขายมีสถานที่ตั้งหลายแห่ง ให้ใช้ชื่อผู้ขายร่วมกับชื่อเมืองหรือชื่อถนน คุณภาพของข้อมูลที่การเรียกใช้แสดงจะแตกต่างกันไป คุณจึงต้องตรวจสอบว่าผลลัพธ์ที่แสดงตรงกับผู้ขายที่ต้องการจริงหรือไม่

ต่อไปนี้คือตัวอย่างการขอรหัสสถานที่สำหรับสำนักงาน Google ในไทเปโดยใช้ชื่อผู้ขายและเมือง

https://maps.googleapis.com/maps/api/place/findplacefromtext/json?input=google%20taipei&inputtype=textquery&fields=place_id&key=YOUR_API_KEY&solution_channel=GMP_guides_enrichedtransactions_v1_a

อย่าลืมเข้ารหัส URL ของพารามิเตอร์อินพุตในคําขอ API

การจัดเก็บรหัสสถานที่

หากต้องการจัดเก็บข้อมูลจากแพลตฟอร์ม Google Maps เกี่ยวกับผู้ขายไว้ใช้สำหรับคำขอในอนาคต คุณสามารถจัดเก็บรหัสสถานที่นี้ไว้อย่างไม่มีกำหนดในฐานข้อมูลของคุณเป็นแอตทริบิวต์ของระเบียนผู้ขาย คุณควรส่งคำขอค้นหาสถานที่เพียงครั้งเดียวต่อผู้ขาย นอกจากนี้ คุณยังค้นหารหัสสถานที่ทุกครั้งที่ผู้ใช้ขอรายละเอียดธุรกรรมได้ด้วย

รีเฟรชรหัสสถานที่ทุก 12 เดือนโดยใช้คําขอรายละเอียดสถานที่ที่มีพารามิเตอร์ place_id เพื่อให้คุณมีข้อมูลที่ถูกต้องที่สุดเสมอ

ในกรณีที่รายละเอียดสถานที่ที่คุณแสดงไม่ตรงกับผู้ขายที่ผู้ใช้ทำธุรกรรม เราขอแนะนำให้คุณอนุญาตให้ผู้ใช้แสดงความคิดเห็นเกี่ยวกับคุณภาพของการจับคู่ผู้ขาย

คุณสามารถแชร์รายละเอียดสถานที่ที่ผู้ใช้จําเป็นต้องทราบหลังจากเข้าชมสถานที่ของคุณ รายละเอียดสถานที่อย่างละเอียด เช่น ข้อมูลติดต่อ เวลาทําการ การให้คะแนนของผู้ใช้ และรูปภาพของผู้ใช้ จะช่วยให้แอปของคุณช่วยเตือนผู้ใช้เกี่ยวกับธุรกรรมที่เสร็จสมบูรณ์ หลังจากเรียกใช้ Places API เพื่อรับรายละเอียดสถานที่แล้ว คุณสามารถกรองและแสดงผลคำตอบในหน้าต่างข้อมูล แถบด้านข้างของเว็บ หรือในลักษณะใดก็ได้ตามต้องการภายในขอบเขตของข้อกำหนดในการให้บริการ

หากต้องการขอรายละเอียดสถานที่ คุณจะต้องมีรหัสสถานที่ของสถานที่แต่ละแห่ง ดูการรับรหัสสถานที่เพื่อเรียกข้อมูลรหัสสถานที่ตั้งของคุณ

คําขอรายละเอียดสถานที่ต่อไปนี้จะแสดงที่อยู่ พิกัด เว็บไซต์ หมายเลขโทรศัพท์ คะแนน และเวลาทําการในjsonเอาต์พุตสําหรับรหัสสถานที่ Google Taipei 101

https://maps.googleapis.com/maps/api/place/details/json?placeid=ChIJraeA2rarQjQRyAqIxkx2vN8&fields=name%2Cformatted_address%2Cwebsite%2Cformatted_phone_number%2Cgeometry/location%2Cicon%2Copening_hours%2Crating&key=YOUR_API_KEY&solution_channel=GMP_guides_enrichedtransactions_v1_a

การกำหนดสถานที่ตั้งของผู้ขาย

Maps Static API ยอมรับที่อยู่หรือพิกัดเพื่อวางเครื่องหมาย หากระเบียนผู้ขายมีที่อยู่อยู่แล้ว คุณสามารถข้ามไปยังส่วนถัดไปได้ แต่เราขอแนะนำให้ใช้พิกัดแทนที่อยู่เพื่อให้แผนที่มีความแม่นยำ

หากฐานข้อมูลของผู้ขายมีที่อยู่ แต่ไม่มีพิกัดทางภูมิศาสตร์ และคุณไม่ได้ขอรายละเอียดสถานที่ไว้แล้ว คุณสามารถใช้ Geocoding API เพื่อแปลงที่อยู่เป็นพิกัดละติจูด/ลองจิจูดฝั่งเซิร์ฟเวอร์ จัดเก็บพิกัดในฐานข้อมูล และรีเฟรชพิกัดอย่างน้อยทุก 30 วัน

ต่อไปนี้คือตัวอย่างการใช้ Geocoding API เพื่อรับละติจูดและลองจิจูดของรหัสสถานที่ตั้งสำนักงาน Google ในไทเป

https://maps.googleapis.com/maps/api/geocode/json?place_id=ChIJraeA2rarQjQRyAqIxkx2vN8&key=YOUR_API_KEY&solution_channel=GMP_guides_enrichedtransactions_v1_a

การเพิ่มเครื่องหมายตำแหน่งผู้ขายลงในแผนที่

เนื่องจากผู้ใช้จะเห็นแผนที่เพื่อยืนยันธุรกรรมแทนการเรียกดูหรือไปยังส่วนต่างๆ คุณจึงควรสร้างแผนที่ที่มีการโต้ตอบแบบจำกัด

สำหรับเว็บบนเดสก์ท็อปและอุปกรณ์เคลื่อนที่ ให้สร้าง URL ของ Maps Static API ที่มีเครื่องหมายเดียวที่ละติจูด/ลองจิจูดหรือที่อยู่ของผู้ขาย คุณสามารถใช้ Maps Static API โดยใช้การเรียกใช้บริการบนเว็บ ซึ่งจะสร้างแผนที่เวอร์ชันรูปภาพตามพารามิเตอร์ที่คุณระบุ สําหรับอุปกรณ์เคลื่อนที่ ให้ข้ามไปที่การเพิ่มแผนที่ในส่วนแอปพลิเคชันบนอุปกรณ์เคลื่อนที่

การเรียกใช้ต่อไปนี้แสดงแผนงานขนาด 640x480 พิกเซลที่กึ่งกลางเครื่องหมายที่สำนักงาน Google ในไทเปที่ระดับการซูมเริ่มต้น รวมถึงระบุเครื่องหมายตำแหน่งการนำส่งสีแดงและรูปแบบแผนที่ในระบบคลาวด์

    https://maps.googleapis.com/maps/api/staticmap?size=640x480&markers=color:red%7C25.033976%2C121.5645389&map_id=b224095f76859890&key=YOUR_API_KEY&signature=BASE64_SIGNATURE&solution_channel=GMP_guides_enrichedtransactions_v1_a

ซึ่งแบ่งออกเป็นส่วนต่อไปนี้

ซึ่งจะกลายเป็นรูปภาพดังที่แสดงด้านล่าง

คุณยังใช้ที่อยู่เป็นตำแหน่งเครื่องหมายได้ด้วย โดยทำดังนี้

https://maps.googleapis.com/maps/api/staticmap?size=640x480&markers=color:green%7CTaipei%20101%20Tower%2CNo.%207信義路五段信義區台北市%20Taiwan%20110&map_id=b224095f76859890&key=YOUR_API_KEY&signature=BASE64_SIGNATURE&solution_channel=GMP_guides_enrichedtransactions_v1_a

ดูตัวเลือกพารามิเตอร์เพิ่มเติมได้ในเอกสารประกอบ Maps Static API

การเพิ่มแผนที่ในแอปพลิเคชันบนอุปกรณ์เคลื่อนที่

หากใช้ Maps SDK สำหรับ Android หรือ Maps SDK สำหรับ iOS คุณจะวางเครื่องหมายโดยใช้พิกัดจากข้อมูลในรายละเอียดสถานที่ได้

เนื่องจากผู้ใช้จะเห็นแผนที่เพื่อยืนยันธุรกรรมแทนการเรียกดูหรือไปยังส่วนต่างๆ ให้เลือกแผนที่ที่มีการโต้ตอบแบบจำกัด ดังนี้

• สำหรับแอปพลิเคชัน Android โปรดดูบทแนะนำเกี่ยวกับการเพิ่มแผนที่ด้วยเครื่องหมาย และเปิดใช้โหมด Lite เพื่อมอบการโต้ตอบแบบจำกัด
• สําหรับแอปพลิเคชัน iOS โปรดดูบทแนะนําเกี่ยวกับการเพิ่มแผนที่ด้วยเครื่องหมาย และปิดใช้การควบคุมและท่าทางสัมผัสด้วย Flag GMSUiSettings