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

ภาพรวม

เว็บ iOS API

Google Maps Platform มีให้บริการสำหรับเว็บ (JS, TS), Android และ iOS และยังมี API ของบริการบนเว็บสำหรับรับข้อมูลเกี่ยวกับสถานที่ เส้นทาง และระยะทาง ตัวอย่างในคู่มือนี้เขียนขึ้นสําหรับแพลตฟอร์มหนึ่ง แต่มีลิงก์เอกสารประกอบสําหรับการติดตั้งใช้งานในแพลตฟอร์มอื่นๆ

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

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

หน้าจอตัวอย่างธุรกรรมที่สมบูรณ์ขึ้น
หน้าจอตัวอย่างธุรกรรมที่สมบูรณ์ขึ้น (คลิกเพื่อขยาย)

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

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

ดูข้อมูลเพิ่มเติมเกี่ยวกับการตั้งค่าได้ที่การเริ่มต้นใช้งาน Google Maps Platform

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

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

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

การจับคู่ผู้ขายกับ Google Maps Platform

ตัวอย่างนี้ใช้ Place API

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

เมทริกซ์โฟลว์การจับคู่ผู้ขาย
เมทริกซ์โฟลว์การจับคู่ของผู้ขาย (คลิกเพื่อขยาย)

รับรหัสสถานที่ของ 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 Platform เกี่ยวกับผู้ขายสำหรับคำขอในอนาคต คุณสามารถจัดเก็บรหัสสถานที่นี้ในฐานข้อมูลอย่างไม่มีกำหนด เพื่อเป็นแอตทริบิวต์ของบันทึกผู้ขาย คุณควรทำคำขอ "ค้นหาสถานที่" เพียงครั้งเดียวต่อผู้ขาย 1 ราย นอกจากนี้ยังค้นหารหัสสถานที่ทุกครั้งที่ผู้ใช้ขอรายละเอียดธุรกรรมได้อีกด้วย

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

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

การแสดงรายละเอียดผู้ขาย

ตัวอย่างนี้ใช้ Place API นอกจากนี้ ยังมี: Places SDK สำหรับ Android | Places SDK สำหรับ iOS | ไลบรารี Places, Maps JavaScript API

คุณสามารถแชร์รายละเอียดสถานที่ที่ผู้ใช้จำเป็นต้องทราบหลังจากที่ได้เข้าชมสถานที่แห่งใดแห่งหนึ่งของคุณ ด้วยรายละเอียดสถานที่ที่สมบูรณ์ เช่น ข้อมูลติดต่อ เวลาทำการ การให้คะแนนของผู้ใช้ และรูปภาพของผู้ใช้ แอปของคุณสามารถช่วยเตือนผู้ใช้ถึงธุรกรรมที่เสร็จสมบูรณ์แล้ว หลังจากเรียก 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

การเพิ่มแผนที่ของสถานที่ตั้งของผู้ขาย

ตัวอย่างนี้ใช้ Geocoding API | Maps Static API ไม่พร้อมใช้งาน: Android | iOS

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

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

รายละเอียดนี้จะแบ่งออกเป็นส่วนต่างๆ ต่อไปนี้

URL ของ API https://maps.googleapis.com/maps/api/staticmap?
ขนาดรูปภาพ ขนาด=640x480
เครื่องหมายตำแหน่งผู้ขาย (การใช้การเข้ารหัส URL) Marker=color:red%7C25.033976%2C121.5645389
รูปแบบแผนที่ในระบบคลาวด์ รหัสแผนที่=B224095f76859890
คีย์ API คีย์=YOUR_API_KEY
ลายเซ็นดิจิทัล (ดูวิธีลงนามคำขอแบบดิจิทัล) ลายเซ็น=BASE64_SIGNATURE
พารามิเตอร์แชแนลของโซลูชัน (ดูเอกสารประกอบของพารามิเตอร์) Solutions_channel=GMP_guides_enrichedtransactions_v1_a

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

รูปภาพแผนที่แบบคงที่ของสำนักงาน Google ไทเป

นอกจากนี้ คุณยังสามารถใช้ที่อยู่เป็นตำแหน่งของเครื่องหมายได้:

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 คุณสามารถวางเครื่องหมายโดยใช้พิกัดจากข้อมูลในรายละเอียดสถานที่ได้

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