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

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

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

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

พารามิเตอร์ปัจจุบัน	พารามิเตอร์ใหม่	Notes
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