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

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

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