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

บทนำ

Places API รองรับการค้นหาใกล้เคียง (เดิม) หากคุณคุ้นเคยกับการค้นหาใกล้เคียง (เดิม) การค้นหาใกล้เคียง (ใหม่) จะทำการเปลี่ยนแปลงต่อไปนี้

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

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

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

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

คำขอ GET ตัวอย่างต่อไปนี้ใช้การค้นหาใกล้เคียง (เดิม) ในตัวอย่างนี้ คุณขอการตอบกลับ 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