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