ภาพรวม
Google Maps Platform มีให้บริการบนเว็บ (JS, TS), Android และ iOS และยังมี API ของบริการเว็บสำหรับการรับข้อมูลเกี่ยวกับสถานที่ เส้นทาง และระยะทางอีกด้วย ตัวอย่างในคู่มือนี้เขียนขึ้นสำหรับแพลตฟอร์มหนึ่ง แต่จะมีลิงก์เอกสารประกอบสำหรับการใช้งานบนแพลตฟอร์มอื่นๆ
ผู้ใช้มักจะเข้าใจใบแจ้งยอดธุรกรรมได้ยาก การใช้ตัวย่อ เช่น "ACMEHCORP" แทนที่จะใช้ชื่อผู้ขาย เช่น "Acme Houseware" ซึ่งอาจทำให้มีการโทรติดต่อฝ่ายสนับสนุนลูกค้ามากขึ้นและข้อพิพาทที่มีค่าใช้จ่ายสูง ธุรกรรมที่สมบูรณ์ขึ้นจะช่วยให้ธุรกรรมเหล่านี้ง่ายขึ้น และทำให้ผู้ใช้เข้าใจได้ง่ายขึ้นโดยระบุชื่อเต็มและหมวดหมู่ธุรกิจของผู้ขาย รูปภาพหน้าร้าน ที่อยู่และตำแหน่งบนแผนที่ ข้อมูลติดต่อแบบเต็ม และอื่นๆ การดำเนินการนี้ช่วยเพิ่มความพึงพอใจและความโปร่งใสให้กับผู้ใช้ และยังลดการโทรขอรับการสนับสนุนลูกค้า เพิ่ม NPS และใช้เวลาในการใช้แอปมากขึ้น
ธุรกรรมที่สมบูรณ์ขึ้น คู่มือการใช้งานและเคล็ดลับการปรับแต่งที่เราให้ในหัวข้อนี้ คือส่วนผสมที่ลงตัวของ Google Maps Platform API ในการสร้างประสบการณ์การใช้งานที่ดีให้กับประวัติการทำธุรกรรมของผู้ใช้ คู่มือการใช้งานนี้จะแสดงวิธีจับคู่สถานที่ตั้งกับผู้ขายที่เจาะจงและแสดงข้อมูลโดยละเอียด
![หน้าจอตัวอย่างธุรกรรมที่สมบูรณ์ขึ้น](https://developers-dot-devsite-v2-prod.appspot.com/static/maps/solutions/enriched-transactions/images/diagram.png?authuser=6&hl=th)
กำลังเปิดใช้ API
หากต้องการใช้ธุรกรรมที่สมบูรณ์ขึ้น คุณต้องเปิดใช้ API ต่อไปนี้ใน Google Cloud Console ไฮเปอร์ลิงก์ต่อไปนี้จะส่งคุณไปยัง Google Cloud Console เพื่อเปิดใช้ API แต่ละรายการสำหรับโปรเจ็กต์ที่เลือก
ดูข้อมูลเพิ่มเติมเกี่ยวกับการตั้งค่าได้ที่การเริ่มต้นใช้งาน Google Maps Platformส่วนต่างๆ ของคู่มือการติดตั้งใช้งาน
ต่อไปนี้คือการใช้งานและการปรับแต่งที่เราจะกล่าวถึงในหัวข้อนี้
- ไอคอนเครื่องหมายถูกเป็นขั้นตอนหลักในการใช้งาน
- ไอคอนดาวเป็นการปรับแต่งที่ไม่บังคับแต่แนะนำให้ปรับแต่งเพื่อเพิ่มประสิทธิภาพโซลูชัน
การจับคู่ผู้ขายกับ Google Maps Platform | การเชื่อมโยงผู้ขายในประวัติการทำธุรกรรมกับสถานที่ใน Google Maps Platform | |
การแสดงรายละเอียดผู้ขาย | แสดงธุรกรรมที่มีข้อมูลจำนวนมากซึ่งแสดงข้อมูลที่เป็นประโยชน์เกี่ยวกับผู้ขาย เพื่อให้ผู้ใช้จดจำธุรกรรมดังกล่าวได้อย่างรวดเร็ว | |
การเพิ่มแผนที่ของสถานที่ตั้งผู้ขาย | เพิ่มแผนที่ของสถานที่ตั้งผู้ขาย |
การจับคู่ผู้ขายกับ Google Maps Platform
ตัวอย่างนี้ใช้สิ่งต่อไปนี้ Places API |
แผนภาพต่อไปนี้แสดงวิธีที่แอปพลิเคชันของคุณจับคู่ธุรกรรมของผู้ขายเพื่อส่งคืนผลลัพธ์โดยใช้รายละเอียดสถานที่จากฐานข้อมูลผู้ขายที่มีอยู่หรือผ่านทางคำขอการค้นหาสถานที่
![เมทริกซ์ขั้นตอนการจับคู่ผู้ขาย](https://developers-dot-devsite-v2-prod.appspot.com/static/maps/solutions/enriched-transactions/images/decision-matrix-diagram.png?authuser=6&hl=th)
การรับรหัสสถานที่ของ 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 เพื่อขอรายละเอียดสถานที่แล้ว คุณสามารถกรองและแสดงผลการตอบกลับในหน้าต่างข้อมูล แถบด้านข้างบนเว็บ หรือด้วยวิธีอื่นๆ ตามต้องการ
![ตัวอย่างหน้าจอรายละเอียดผู้ขาย](https://developers-dot-devsite-v2-prod.appspot.com/static/maps/solutions/enriched-transactions/images/enriched-transactions.png?authuser=6&hl=th)
หากต้องการขอรายละเอียดสถานที่ คุณจะต้องใช้รหัสสถานที่ของสถานที่แต่ละแห่ง ดูการดูรหัสสถานที่ เพื่อเรียกดูรหัสสถานที่ของสถานที่ตั้ง
คำขอรายละเอียดสถานที่ต่อไปนี้จะแสดงที่อยู่ พิกัด เว็บไซต์ หมายเลขโทรศัพท์ คะแนน และเวลาทำการในเอาต์พุต 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 |
ซึ่งมีรูปภาพดังรูปด้านล่างนี้
คุณยังสามารถใช้ที่อยู่เป็นเครื่องหมายระบุตำแหน่งได้ด้วย
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