เหตุผลที่ควรใช้ Places API
สร้างฟีเจอร์ที่รับรู้ถึงตำแหน่งเพื่อให้ผู้ใช้สามารถใช้ข้อมูลตำแหน่งโดยละเอียดได้โดยง่าย ข้อมูลที่มีผ่านทาง Places API สร้างขึ้นจากหนึ่งในโมเดลสถานที่ที่แม่นยำ ทันสมัย และครอบคลุมมากที่สุดในโลกจริง ต่อไปนี้คือตัวอย่างกรณีการใช้งานสำหรับแอปพลิเคชัน
- แสดงการเช่าคอนโดภายในเขตเมืองใหญ่ พร้อมผลลัพธ์ที่กำหนดเป้าหมายไปยังเมืองต่างๆ โดยเฉพาะ
- ระบุรายละเอียดสถานที่ในการอัปเดตสถานะการรับสินค้าหรือการจัดส่ง
- แสดงรายชื่อสวนสาธารณะในพื้นที่ พร้อมภาพถ่ายและความเห็นที่ผู้ใช้ส่งมา
- ให้ข้อมูลติดต่อ รีวิว และระดับราคาสำหรับสถานประกอบการระหว่างทางแก่ผู้ที่วางแผนการเดินทาง
คุณสามารถใช้ Places API ทำอะไรได้บ้าง
คุณใช้ Places API เพื่อรวมฟีเจอร์ต่อไปนี้ในแอปพลิเคชันได้
- ให้ผลการค้นหาสถานที่จากคำค้นหาของผู้ใช้ประเภทต่างๆ เช่น การป้อนข้อความ สถานที่ตั้งใกล้เคียง และคำค้นหาของผู้ใช้ที่กำกวมหรือเชิงหมวดหมู่
- เปิดใช้ฟีเจอร์เติมข้อความอัตโนมัติสำหรับประเภทการค้นหาต่างๆ ไม่ว่าจะเป็นข้อความค้นหาที่เจาะจงหรือการค้นหาตามหมวดหมู่
- ปรับแต่งประเภทรายละเอียดที่แสดงเกี่ยวกับสถานที่ เช่น เวลาทำการ สรุป รีวิวของผู้ใช้ และรูปภาพ
- เพิ่มรูปภาพคุณภาพสูงลงในตำแหน่งที่แอปพลิเคชันของคุณให้บริการ
Google Maps Platform API จำนวนมากรองรับรหัสสถานที่ ซึ่งรหัสสถานที่จะระบุสถานที่ในฐานข้อมูล 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 ทั้งสอง
วิธีการทำงานของ 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 (ใหม่) | หมายเหตุ |
|---|---|---|
| ค้นหาสถานที่ | การค้นหาข้อความ (ใหม่) | ไม่มีเวอร์ชันใหม่ของ "Find Place" เราแทนที่การค้นหาข้อความ (ใหม่) แล้ว |
| การค้นหาใกล้เคียง | การค้นหาใกล้เคียง (ใหม่) | คำขอทั้งหมดที่ใช้ API ที่มีอยู่ซึ่งมีข้อความค้นหาควรใช้การค้นหาข้อความ (ใหม่) เนื่องจากการค้นหาใกล้เคียง (ใหม่) ไม่รองรับการป้อนข้อความ |
| การค้นหาข้อความ | การค้นหาข้อความ (ใหม่) | |
| รายละเอียดสถานที่ | รายละเอียดสถานที่ (ใหม่) | |
| รูปภาพสถานที่ | รูปภาพสถานที่ (ใหม่) | |
| เติมข้อความอัตโนมัติเกี่ยวกับสถานที่ | เติมข้อความอัตโนมัติ (ใหม่) | |
| เติมคำค้นหาอัตโนมัติ | เติมข้อความอัตโนมัติ (ใหม่) | เพิ่มความสามารถไปยังการเติมข้อความอัตโนมัติ (ใหม่) |
วิธีใช้ Places API
ขั้นตอนด้านล่างครอบคลุมกรณีการใช้งานทั่วไปสำหรับการใช้บริการ Places API ระหว่างสร้างโซลูชัน คุณสามารถใช้ปลายทางเพิ่มเติม เช่น การค้นหาใกล้เคียงและรูปภาพสถานที่| 1 | เริ่มตั้งค่า | เริ่มด้วยการตั้งค่าโปรเจ็กต์ Google Cloud และทำตามวิธีการตั้งค่าให้เสร็จสมบูรณ์ จากนั้นให้ดูวิธีใช้คีย์ API สำหรับ Places API (ใหม่) คุณยังใช้โทเค็น OAuth ได้ด้วย |
| 2 | ลองใช้การค้นหาข้อความพื้นฐาน | ค้นหาข้อความอย่างง่ายโดยใช้การค้นหาข้อความ (ใหม่) หรือ การค้นหาข้อความ |
| 3 | ใช้รหัสสถานที่เพื่อดูรายละเอียดเพิ่มเติม | Google Maps Platform API จำนวนมากจะแสดงรหัสสถานที่เป็นส่วนหนึ่งของคำตอบ ใช้รหัสสถานที่เพื่อดูรายละเอียดเกี่ยวกับสถานที่ ดูรายละเอียดสถานที่ (ใหม่) และรายละเอียดสถานที่ |
| 4 | ถ่ายรูปสถานที่ | บริการรูปภาพสถานที่ให้คุณเข้าถึงรูปภาพนับล้านๆ รูปที่เก็บไว้ในฐานข้อมูลของ Places ใช้รูปภาพสถานที่ (ใหม่) หรือรายละเอียดสถานที่เพื่อเข้าถึงรูปภาพของสถานที่ |