ย้ายข้อมูลไปยังการค้นหาใกล้เคียง (ใหม่)

Places API รองรับการค้นหาใกล้เคียงที่มีอยู่แล้ว หากคุณคุ้นเคยกับการค้นหาใกล้เคียงที่มีอยู่ การค้นหาใกล้เคียงเวอร์ชันใหม่จะทำการเปลี่ยนแปลงต่อไปนี้

• การค้นหาใกล้เคียงใหม่ใช้คำขอ HTTP POST ส่งพารามิเตอร์ในเนื้อหาคำขอหรือในส่วนหัวโดยเป็นส่วนหนึ่งของคำขอ HTTP POST ในทางตรงกันข้ามกับการค้นหา Nearby ที่มีอยู่ คุณจะส่งพารามิเตอร์ของ URL โดยใช้คำขอ HTTP GET
• ต้องมาสก์ช่อง คุณต้องระบุช่องที่ต้องการให้แสดงในคำตอบ ไม่มีรายการเริ่มต้นของฟิลด์ที่แสดงผล หากคุณไม่ใส่รายการนี้ เมธอดจะแสดงข้อผิดพลาด ดูข้อมูลเพิ่มเติมได้ใน FieldMask
• การค้นหา Nearby ใหม่รองรับทั้งคีย์ API และโทเค็น OAuth เป็นกลไกการตรวจสอบสิทธิ์
• รองรับเฉพาะ JSON เป็นรูปแบบการตอบสนองในการค้นหา Nearby ใหม่
• ตอนนี้คำขอทั้งหมดที่มีการค้นหาข้อความควรใช้การค้นหาข้อความ (ใหม่) เนื่องจากการค้นหาใกล้เคียง (ใหม่) ไม่รองรับการป้อนข้อความ
• รูปแบบการตอบสนอง JSON สำหรับ Nearby Search (ใหม่) API เปลี่ยนจากรูปแบบของ API ที่มีอยู่ ดูรายละเอียดเพิ่มเติมได้ที่ย้ายข้อมูลการตอบกลับของ Places API

ตารางต่อไปนี้แสดงรายการพารามิเตอร์ในการค้นหา Nearby ที่มีอยู่แล้วซึ่งมีการเปลี่ยนชื่อหรือแก้ไขสำหรับการค้นหา Nearby ใหม่ หรือพารามิเตอร์ที่ระบบไม่รองรับอีกต่อไป

พารามิเตอร์ปัจจุบัน	พารามิเตอร์ใหม่	Notes
keyword		ไม่รองรับ โปรดใช้การค้นหาข้อความ (ใหม่) แทน
language	languageCode
location	locationRestriction	ต้องระบุ
maxprice/minprice		ไม่รองรับ
	maxResultCount	พารามิเตอร์ใหม่
opennow		ไม่รองรับ
pagetoken		ไม่รองรับ
radius		ใช้ locationRestriction เลย
rankby	rankPreference
	regionCode	พารามิเตอร์ใหม่
type	includedTypes excludedTypes includedPrimaryTypes excludedPrimaryTypes	นอกจากนี้ พารามิเตอร์ใหม่ยังยอมรับค่าหลายประเภทด้วย โดย API ที่มีอยู่จะยอมรับเพียงค่าเดียวเท่านั้น

ตัวอย่างคำขอ

ตัวอย่างคำขอ GET ต่อไปนี้ใช้การค้นหา Nearby ที่มีอยู่ ในตัวอย่างนี้ คุณขอการตอบกลับ JSON ที่มีข้อมูลเกี่ยวกับตำแหน่งประเภท restaurant และส่งพารามิเตอร์ทั้งหมดเป็นพารามิเตอร์ของ URL

curl -L -X GET \
'https://maps.googleapis.com/maps/api/place/nearbysearch/json?location=37.7937%2C-122.3965&radius=500&type=restaurant&key=API_KEY'

เมื่อใช้การค้นหาใกล้เคียง (ใหม่) คุณจะส่งคำขอ POST และส่งพารามิเตอร์ทั้งหมดในเนื้อหาของคำขอ JSON หรือในส่วนหัวให้เป็นส่วนหนึ่งของคำขอ POST ตัวอย่างนี้ยังใช้มาสก์ฟิลด์เพื่อให้การตอบกลับมีเฉพาะชื่อที่แสดงและที่อยู่ที่จัดรูปแบบของสถานที่ด้วย

curl -X POST -d '{
  "includedTypes": ["restaurant"],
  "locationRestriction": {
    "circle": {
      "center": {
        "latitude": 37.7937,
        "longitude": -122.3965},
      "radius": 500.0
    }
  }
}' \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: places.displayName,places.formattedAddress" \
https://places.googleapis.com/v1/places:searchNearby