ทําไมต้องใช้ Places API
สร้างคุณลักษณะที่รับรู้ตําแหน่ง เพื่อให้ผู้ใช้สามารถเข้าถึงข้อมูลรายละเอียดได้อย่างง่ายดาย ข้อมูลที่นําเสนอผ่าน Places API สร้างขึ้นในโมเดลสถานที่ที่ถูกต้อง เป็นปัจจุบัน และครอบคลุมมากที่สุดในโลกจริง ต่อไปนี้เป็นตัวอย่างการใช้งานสําหรับแอปพลิเคชัน
- แสดงคอนโดให้เช่าภายในเขตเมืองใหญ่ที่มีผลการค้นหาเจาะจงเมือง
- รวมรายละเอียดสถานที่ในการอัปเดตสถานะการรับสินค้าหรือการจัดส่ง
- แสดงรายการของสวนสาธารณะในพื้นที่พร้อมกับภาพถ่ายและความเห็นที่ผู้ใช้ส่ง
- แสดงข้อมูลติดต่อ รีวิว และระดับของสถานประกอบการสําหรับสถานที่ต่างๆ ระหว่างที่วางแผนการเดินทาง
Places API ทําอะไรได้บ้าง
คุณสามารถใช้ Places API เพื่อใส่คุณลักษณะต่อไปนี้ในแอปพลิเคชันของคุณ:
- ให้ผลการค้นหาสถานที่จากข้อความค้นหาประเภทต่างๆ ของผู้ใช้ เช่น การป้อนข้อความ ตําแหน่งใกล้เคียง และข้อความค้นหาที่มีความหมายหรือกํากวมของผู้ใช้
- เปิดใช้ฟีเจอร์การเติมข้อความอัตโนมัติสําหรับการค้นหาประเภทต่างๆ ไม่ว่าจะเป็นการค้นหาข้อความที่เฉพาะเจาะจงหรือการค้นหาตามหมวดหมู่
- ปรับแต่งประเภทรายละเอียดที่แสดงเกี่ยวกับสถานที่ เช่น เวลาทําการ ข้อมูลสรุป รีวิวของผู้ใช้ และรูปภาพ
- เพิ่มรูปภาพคุณภาพสูงลงในตําแหน่งที่แอปพลิเคชันของคุณแสดง
Places API ทํางานอย่างไร
Places API จะยอมรับคําขอเป็น URL มาตรฐานซึ่งมีปลายทางบริการเฉพาะ เช่น /place
หรือ /photo
ปลายทางยังยอมรับประเภทของรูปแบบที่ระบุในคําขอด้วย ไม่ว่าจะเป็น JSON หรือ XML และสุดท้าย คําขอบริการใช้พารามิเตอร์ที่เกี่ยวข้องกับปลายทางนั้นๆ เพื่อปรับแต่งข้อมูลที่ส่งกลับ
ตัวอย่างเช่น คําขอรายละเอียดสถานที่ต่อไปนี้สําหรับคอมโพเนนต์ที่อยู่จะทํางานดังต่อไปนี้ โดยสมมติว่าการคืนสินค้าอยู่ในรูปแบบ JSON
https://maps.googleapis.com/maps/api/place/details/json ?place_id=ChIJrTLr-GyuEmsRBfy61i59si0 &fields=address_components &key=YOUR_API_KEY
ในกรณีนี้ บริการจะใช้รหัสสถานที่ที่ให้มาเพื่อค้นหาสถานที่ที่ขอและส่งคืนคอมโพเนนต์ที่อยู่ในรูปแบบ JSON
แหล่งข้อมูล
ตารางต่อไปนี้สรุปทรัพยากรที่มีผ่าน API ของ Places พร้อมกับข้อมูลที่แสดงผล
แหล่งข้อมูล | ข้อมูลที่แสดง | รูปแบบการคืนสินค้า |
---|---|---|
ค้นหาสถานที่ | ส่งกลับรายการสถ านที่ที่อิงตามตําแหน่งของอุปกรณ์หรือสตริงค้นหา
ดูรายละเอียดเกี่ยวกับการตอบกลับการค้นหาสถานที่ คําตอบการค้นหาใกล้เคียง และคําตอบจากการค้นหาข้อความ |
|
รายละเอียดสถานที่ | ส่งคืนข้อมูลโดยละเอียดเพิ่มเติมเกี่ยวกับสถานที่ที่เฉพาะเจาะจง รวมถึงรีวิวของผู้ใช้
ดูรายละเอียดในคําตอบรายละเอียดสถานที่ |
|
รูปภาพสถานที่ | ให้สิทธิ์เข้าถึงรูปภาพหลายล้านรูปที่เกี่ยวข้องกับสถานที่ที่จัดเก็บไว้ในฐานข้อมูลสถานที่ของ Google
ดูรายละเอียดการตอบรูปภาพ |
|
เติมข้อความอัตโนมัติในสถานที่ | กรอกชื่อและ/หรือที่อยู่ของสถานที่โดยอัตโนมัติขณะผู้ใช้พิมพ์
ดูรายละเอียดในการวางคําตอบที่เติมข้อความอัตโนมัติ |
|
เติมข้อความค้นหาอัตโนมัติ | ให้บริการคาดคะเนคําค้นหาสําหรับการค้นหาทางภูมิศาสตร์แบบข้อความ และแสดงผลคําค้นหาที่แนะนําขณะที่ผู้ใช้พิมพ์
ดูรายละเอียดสําหรับคําค้นหาที่เติมข้อความอัตโนมัติ |
|
วิธีใช้ Places API
ขั้นตอนด้านล่างครอบคลุมสถานการณ์กรณีการใช้งานทั่วไปสําหรับการใช้ปลายทาง 3 จุดในบริการ Places API เมื่อสร้างโซลูชัน คุณสามารถใช้ ปลายทางเพิ่มเติม เช่น การค้นหาใกล้เคียง รูปภาพสถานที่ และการเติมข้อความค้นหาอัตโนมัติ1 | รับการตั้งค่า | เริ่มต้นด้วยการตั้งค่า โปรเจ็กต์ Google Cloud และทําตามวิธีการติดตั้งให้เสร็จสมบูรณ์ จากนั้นเรียนรู้วิธีใช้คีย์ API |
2 | ลองใช้การค้นหาข้อความเบื้องต้น | เมื่อมีคีย์ API แล้ว ให้ทําการค้นหาข้อความธรรมดาตามที่อธิบายไว้ในตัวอย่างการค้นหาข้อความพื้นฐานในคู่มือการค้นหาข้อความ |
3 | ใช้คําขอหาสถานที่ | คําขอสถานที่จะแสดงรหัสสถานที่ พร้อมด้วยช่องข้อมูลที่คุณขอ เช่น เวลาทําการ ที่อยู่ และรูปภาพ ดูตัวอย่างสถานที่ และลองใช้ตัวอย่างที่เกี่ยวข้องมากขึ้นกับกรณีการใช้งานของคุณ |
4 | ทําความเข้าใจพื้นฐานคําตอบเกี่ยวกับสถานที่ | สํารวจข้อมูลที่ได้จากการตอบกลับ "ค้นหาสถานที่" ดูคําตอบเกี่ยวกับสถานที่สําหรับรายละเอียดเพิ่มเติม |
5 | ใช้รหัสสถานที่เพื่อดูรายละเอียดเพิ่มเติม | การค้นหาคําตอบสถานที่ไม่ได้ให้ข้อมูลทั้งหมดของสถานที่นั้นๆ คุณใช้รหัสสถานที่ที่แสดงผลจากการตอบกลับการค้นหาสถานที่เพื่อดูรายละเอียดเพิ่มเติมเกี่ยวกับสถานที่ได้ ดูรายละเอียดสถานที่ |
ไลบรารีของไคลเอ็นต์ที่ใช้ได้
เรียก API นี้ในภาษาที่คุณต้องการผ่านไลบรารีของไคลเอ็นต์ต่อไปนี้
- Java Client สําหรับบริการ Google Maps
- ไคลเอ็นต์ Python สําหรับบริการ Google Maps
- ให้ลูกค้าไปที่บริการ Google Maps
- ไคลเอ็นต์ Node.js สําหรับบริการ Google Maps
ไคลเอ็นต์ Java, ไคลเอ็นต์ Python, Go Client และ Node.js สําหรับ Google Maps คือไลบรารีไคลเอ็นต์ที่ได้รับการสนับสนุนจากชุมชน ซึ่งเปิดให้ใช้ภายใต้ใบอนุญาต Apache 2.0 ดาวน์โหลดได้จาก GitHub ซึ่งคุณสามารถอ่านคําแนะนําในการติดตั้งและโค้ดตัวอย่าง
ขั้นตอนถัดไป
- เริ่มใช้การค้นหา Places API: ไปที่Place Search
- รับคีย์ API: ไปที่การใช้คีย์ API