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

ภาพรวม

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

ตัวอย่างนี้ใช้ข้อมูลต่อไปนี้ API ของ Places

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

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

การรับรหัสสถานที่ของ 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

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

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

ตัวอย่างนี้ใช้ข้อมูลต่อไปนี้ API ของ Places ตัวเลือกดังกล่าวมีดังนี้ Places SDK สำหรับ Android | Places SDK สำหรับ iOS | ไลบรารีสถานที่, 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 | 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

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

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

สำหรับเว็บบนเดสก์ท็อปและเว็บบนอุปกรณ์เคลื่อนที่ ให้สร้าง Maps Static API URL ที่มีเครื่องหมายเดียว ที่ละติจูด/ลองจิจูดหรือที่อยู่ของผู้ขาย คุณสามารถใช้ 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
ลายเซ็นดิจิทัล (ดูวิธีเซ็นชื่อแบบดิจิทัลในคำขอ) signature=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 คุณสามารถวางเครื่องหมายได้โดยใช้ พิกัดจากข้อมูลในรายละเอียดสถานที่

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