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