เหตุผลที่ควรใช้ Places API
สร้างฟีเจอร์ที่ทราบตำแหน่งเพื่อให้ผู้ใช้เข้าถึงข้อมูลตำแหน่งโดยละเอียดได้ ข้อมูลที่มีให้ผ่าน Places API สร้างขึ้นจากโมเดลสถานที่ในโลกแห่งความเป็นจริงที่แม่นยำ อัปเดต และครอบคลุมที่สุดแห่งหนึ่ง ตัวอย่าง Use Case สําหรับแอปพลิเคชันมีดังนี้
- แสดงที่พักให้เช่าในเขตเมืองใหญ่ที่มีผลการค้นหาที่กำหนดเป้าหมายไปยังเมืองโดยเฉพาะ
- ระบุรายละเอียดสถานที่ในการอัปเดตสถานะการนำส่งหรือการรับสินค้า
- แสดงรายการสวนสาธารณะในพื้นที่พร้อมกับรูปภาพและรีวิวที่ผู้ใช้ส่ง
- ระบุข้อมูลติดต่อ รีวิว และระดับราคาของสถานที่ตั้งต่างๆ ตลอดเส้นทางสำหรับผู้ที่กำลังวางแผนการเดินทาง
สิ่งที่คุณทําได้ด้วย Places API
คุณสามารถใช้ Places API เพื่อรวมฟีเจอร์ต่อไปนี้ไว้ในแอปพลิเคชันได้
- แสดงผลการค้นหาสถานที่จากการค้นหาของผู้ใช้ประเภทต่างๆ เช่น การป้อนข้อความ สถานที่ใกล้เคียง และการค้นหาของผู้ใช้ที่ไม่ชัดเจนหรือเป็นหมวดหมู่
- เปิดใช้ฟีเจอร์เติมข้อความอัตโนมัติสำหรับการค้นหาประเภทต่างๆ ไม่ว่าจะเป็นการค้นหาข้อความที่เฉพาะเจาะจงหรือการค้นหาตามหมวดหมู่
- ปรับแต่งประเภทรายละเอียดที่แสดงเกี่ยวกับสถานที่ เช่น เวลาทําการ สรุป รีวิวของผู้ใช้ และรูปภาพ
- เพิ่มรูปภาพคุณภาพสูงไปยังสถานที่ที่แสดงโดยแอปพลิเคชันของคุณ
API ของ Google Maps Platform หลายรายการรองรับรหัสสถานที่ ซึ่งรหัสสถานที่จะระบุสถานที่ในฐานข้อมูล Google Places และใน Google Maps โดยไม่ซ้ำกัน คุณรับรหัสสถานที่ได้หลายวิธี ซึ่งรวมถึงจาก Places API และจาก Geocoding API, Routes API และ Address Validation API
เมื่อคุณมีรหัสสถานที่แล้ว คุณจะใช้ Places API เพื่อขอรายละเอียดเพิ่มเติมเกี่ยวกับสถานที่ตั้งหรือจุดที่น่าสนใจหนึ่งๆ ได้ เช่น ที่อยู่ หมายเลขโทรศัพท์ การให้คะแนนของผู้ใช้ และรีวิว
เลือกเวอร์ชันของ Places API
Places API รองรับ API 2 เวอร์ชัน ได้แก่ Places API ซึ่งเป็น API ที่มีอยู่ และ Places API (ใหม่) ซึ่งเป็น API เวอร์ชันถัดไป
เมื่อมีการเปิดตัว Places API (ใหม่) งานแรกของคุณคือเลือกชุด API ที่จะใช้ กรณีนี้จะเกิดขึ้นหากคุณเป็นลูกค้าใหม่หรือลูกค้าเดิมที่ใช้ API อยู่แล้ว ใช้คู่มือนี้เพื่อดูความแตกต่างที่สำคัญระหว่าง API 2 ประเภทนี้
วิธีการทํางานของ Places API
Places API (ใหม่)
Places API (ใหม่) จะยอมรับคําขอเป็น URL มาตรฐานที่มีปลายทางบริการที่เฉพาะเจาะจง เช่น /places หรือ places:searchText และแสดงผลลัพธ์เป็น JSON Places API (ใหม่) รองรับการให้สิทธิ์ด้วยคีย์ API และโทเค็น OAuth
ตัวอย่างต่อไปนี้แสดงคําขอรายละเอียดสถานที่เพื่อแสดงองค์ประกอบที่อยู่สําหรับรหัสสถานที่โดยใช้คีย์ API
https://places.googleapis.com/v1/places/GyuEmsRBfy61i59si0?fields=addressComponents &key=YOUR_API_KEY
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
แหล่งข้อมูล
ตารางต่อไปนี้สรุปแหล่งข้อมูลที่มีผ่าน Places API
| Places API | Places API (ใหม่) | หมายเหตุ |
|---|---|---|
| ค้นหาสถานที่ | การค้นหาข้อความ (ใหม่) | ฟีเจอร์ค้นหาสถานที่ไม่มีเวอร์ชันใหม่ เราได้แทนที่ด้วย "การค้นหาข้อความ (ใหม่)" แล้ว |
| การค้นหาในบริเวณใกล้เคียง | การค้นหาในบริเวณใกล้เคียง (ใหม่) | คำขอทั้งหมดที่ใช้ API ที่มีอยู่ซึ่งมีข้อความค้นหาควรใช้การค้นหาข้อความ (ใหม่) เนื่องจากการค้นหาในพื้นที่ใกล้เคียง (ใหม่) ไม่รองรับการป้อนข้อความ |
| การค้นหาข้อความ | การค้นหาข้อความ (ใหม่) | |
| รายละเอียดสถานที่ | รายละเอียดสถานที่ (ใหม่) | |
| Place Photo | Place Photo (ใหม่) | |
| Place Autocomplete | เติมข้อความอัตโนมัติ (ใหม่) | |
| การเติมข้อความอัตโนมัติของคําค้นหา | เติมข้อความอัตโนมัติ (ใหม่) | ความสามารถที่เพิ่มลงในฟีเจอร์เติมข้อความอัตโนมัติ (ใหม่) |
วิธีใช้ Places API
ขั้นตอนด้านล่างครอบคลุมกรณีการใช้งานทั่วไปในการใช้บริการ Places API ขณะสร้างโซลูชัน คุณสามารถใช้ปลายทางเพิ่มเติมได้ เช่น การค้นหาใกล้เคียงและ Place Photos| 1 | ตั้งค่า | เริ่มต้นด้วยตั้งค่าโปรเจ็กต์ Google Cloud แล้วทําตามวิธีการตั้งค่าที่ระบุไว้ จากนั้นดูวิธีใช้คีย์ API สําหรับ Places API (ใหม่) คุณจะใช้โทเค็น OAuth ได้ด้วย |
| 2 | ลองใช้การค้นหาข้อความพื้นฐาน | ทำการค้นหาข้อความโดยใช้การค้นหาข้อความ (ใหม่) หรือการค้นหาข้อความ |
| 3 | ใช้รหัสสถานที่เพื่อดูรายละเอียดเพิ่มเติม | API ของ Google Maps Platform หลายรายการจะแสดงผลรหัสสถานที่เป็นส่วนหนึ่งของการตอบกลับ ใช้รหัสสถานที่เพื่อดูรายละเอียดเกี่ยวกับสถานที่ ดูรายละเอียดสถานที่ (ใหม่) และรายละเอียดสถานที่ |
| 4 | ดูรูปภาพสำหรับสถานที่ | บริการรูปภาพสถานที่ช่วยให้คุณเข้าถึงรูปภาพหลายล้านรูปที่จัดเก็บไว้ในฐานข้อมูลสถานที่ได้ ใช้รูปภาพสถานที่ (ใหม่) หรือรายละเอียดสถานที่เพื่อเข้าถึงรูปภาพของสถานที่ |