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