ภาพรวม
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 แต่ละรายการสำหรับโปรเจ็กต์ที่เลือก
- Places API
- API การระบุพิกัดทางภูมิศาสตร์
- Maps Static API, Maps SDK สำหรับ Android หรือ Maps SDK สำหรับ iOS
ส่วนของคู่มือการใช้งาน
ต่อไปนี้คือการใช้งานและการปรับแต่งที่เราจะกล่าวถึงในหัวข้อนี้
- ไอคอนเครื่องหมายถูกเป็นขั้นตอนการติดตั้งใช้งานหลัก
- ไอคอนดาวเป็นการปรับแต่งที่ไม่บังคับแต่แนะนำให้ทำเพื่อเพิ่มประสิทธิภาพโซลูชัน
การจับคู่ผู้ขายกับ 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 |
ซึ่งจะกลายเป็นรูปภาพดังที่แสดงด้านล่าง
นอกจากนี้ คุณยังสามารถใช้ที่อยู่เป็นตำแหน่งของเครื่องหมายได้:
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 โปรดดูบทแนะนำการเพิ่มแผนที่ด้วยเครื่องหมายและปิดใช้การควบคุมและท่าทางสัมผัสด้วยแฟล็ก
GMSUiSettings