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

บทนำ

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