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

ภาพรวม

เว็บ 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

ตัวอย่างนี้ใช้สิ่งต่อไปนี้ Places API

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

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

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

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

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

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

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

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

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

ตัวอย่างนี้ใช้สิ่งต่อไปนี้ Places API มีให้ใช้งานด้วย: Places SDK สำหรับ Android | Places SDK สำหรับ iOS | Places Library, 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

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

API URL https://maps.googleapis.com/maps/api/staticmap?
ขนาดรูปภาพ ขนาด=640x480
เครื่องหมายสถานที่ตั้งของผู้ขาย (การใช้การเข้ารหัส URL) เครื่องหมาย=สี:สีแดง%7C25.033976%2C121.5645389
รูปแบบแผนที่ในระบบคลาวด์ map_id=b224095f76859890
คีย์ API key=YOUR_API_KEY
ลายเซ็นดิจิทัล (ดูวิธีเซ็นชื่อแบบดิจิทัลในคำขอ) ลายเซ็น=BASE64_SIGNATURE
พารามิเตอร์ช่องทางโซลูชัน (ดูเอกสารประกอบเกี่ยวกับพารามิเตอร์) solution_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 คุณสามารถวางเครื่องหมายโดยใช้พิกัดจากข้อมูลในรายละเอียดสถานที่ได้

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