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