Method: places.searchNearby

ค้นหาสถานที่ใกล้กับตำแหน่ง

คำขอ HTTP

POST https://places.googleapis.com/v1/places:searchNearby

URL ใช้ไวยากรณ์การแปลง gRPC

เนื้อหาของคำขอ

เนื้อหาของคำขอมีข้อมูลที่มีโครงสร้างต่อไปนี้

การแสดง JSON 
{
  "languageCode": string,
  "regionCode": string,
  "includedTypes": [
    string
  ],
  "excludedTypes": [
    string
  ],
  "includedPrimaryTypes": [
    string
  ],
  "excludedPrimaryTypes": [
    string
  ],
  "maxResultCount": integer,
  "locationRestriction": {
    object (LocationRestriction)
  },
  "rankPreference": enum (RankPreference)
}
ช่อง
languageCode

string

รายละเอียดสถานที่จะแสดงเป็นภาษาที่ต้องการ หากมี หากไม่ได้ระบุรหัสภาษาหรือไม่รู้จัก ระบบอาจแสดงรายละเอียดของสถานที่ของภาษาใดๆ โดยใช้ค่ากำหนดเป็นอังกฤษ หากมีรายละเอียดดังกล่าว

รายการภาษาที่รองรับในปัจจุบันคือ https://developers.google.com/maps/faq#languagesupport
regionCode

string

รหัสประเทศ/ภูมิภาคแบบ Unicode (CLDR) ของตำแหน่งที่มาของคำขอ พารามิเตอร์นี้ใช้เพื่อแสดงรายละเอียดสถานที่ เช่น ชื่อสถานที่ที่เจาะจงภูมิภาค หากมี พารามิเตอร์อาจส่งผลต่อผลลัพธ์ซึ่งเป็นไปตามกฎหมายที่เกี่ยวข้อง

ดูข้อมูลเพิ่มเติมได้ที่ https://www.unicode.org/cldr/charts/latest/supplemental/territory_language_information.html

โปรดทราบว่าปัจจุบันยังไม่รองรับรหัสภูมิภาค 3 หลัก
includedTypes[]

string

ระบุประเภทสถานที่ (เช่น "ร้านอาหาร" หรือ "gas_station") จาก https://developers.google.com/maps/documentation/places/web-service/place-types

ระบุได้สูงสุด 50 ประเภทจากตาราง ก

หากมีประเภทที่ขัดแย้งกัน เช่น ประเภทหนึ่งปรากฏในทั้งincludeTypes และ excludedTypes ระบบจะแสดงผลข้อผิดพลาด INVALID_ARGUMENT

หากระบุประเภทสถานที่โดยมีข้อจำกัดหลายประเภท ระบบจะแสดงผลเฉพาะสถานที่ที่ตรงกับข้อจำกัดทั้งหมดเท่านั้น เช่น หากเรามี {includedTypes = ["restaurant"], excludedPrimaryTypes = ["Restaurant"]} สถานที่ที่กลับมาก็จะให้บริการที่เกี่ยวข้องกับ "ร้านอาหาร" แต่ไม่ได้ดำเนินธุรกิจในฐานะ "ร้านอาหาร" เป็นหลัก
excludedTypes[]

string

ประเภทสถานที่ที่ยกเว้น (เช่น "ร้านอาหาร" หรือ "gas_station") จาก https://developers.google.com/maps/documentation/places/web-service/place-types

ระบุได้สูงสุด 50 ประเภทจากตาราง ก

หากลูกค้าระบุทั้งincludeTypes (เช่น ร้านอาหาร) และ excludedTypes (เช่น คาเฟ่) คำตอบควรรวมสถานที่ที่เป็นร้านอาหาร แต่ไม่มีคาเฟ่ การตอบสนองจะรวมสถานที่ที่ตรงกับ IncludeTypes อย่างน้อย 1 รายการ และไม่มี excludedTypes อย่างน้อย 1 รายการ

หากมีประเภทที่ขัดแย้งกัน เช่น ประเภทหนึ่งปรากฏในทั้งincludeTypes และ excludedTypes ระบบจะแสดงผลข้อผิดพลาด INVALID_ARGUMENT

หากระบุประเภทสถานที่โดยมีข้อจำกัดหลายประเภท ระบบจะแสดงผลเฉพาะสถานที่ที่ตรงกับข้อจำกัดทั้งหมดเท่านั้น เช่น หากเรามี {includedTypes = ["restaurant"], excludedPrimaryTypes = ["Restaurant"]} สถานที่ที่กลับมาก็จะให้บริการที่เกี่ยวข้องกับ "ร้านอาหาร" แต่ไม่ได้ดำเนินธุรกิจในฐานะ "ร้านอาหาร" เป็นหลัก
includedPrimaryTypes[]

string

ระบุประเภทสถานที่หลัก (เช่น "ร้านอาหาร" หรือ "gas_station") จาก https://developers.google.com/maps/documentation/places/web-service/place-types สถานที่สามารถมีประเภทหลักได้เพียงประเภทเดียวจากตารางประเภทที่รองรับซึ่งเชื่อมโยงกับสถานที่ดังกล่าว

ระบุได้สูงสุด 50 ประเภทจากตาราง ก

ถ้ามีประเภทหลักที่ขัดแย้งกัน เช่น ประเภทหนึ่งปรากฏทั้งใน includePrimaryTypes และ excludedPrimaryTypes ระบบจะแสดงผลข้อผิดพลาด INVALID_ARGUMENT

หากระบุประเภทสถานที่โดยมีข้อจำกัดหลายประเภท ระบบจะแสดงผลเฉพาะสถานที่ที่ตรงกับข้อจำกัดทั้งหมดเท่านั้น เช่น หากเรามี {includedTypes = ["restaurant"], excludedPrimaryTypes = ["Restaurant"]} สถานที่ที่กลับมาก็จะให้บริการที่เกี่ยวข้องกับ "ร้านอาหาร" แต่ไม่ได้ดำเนินธุรกิจในฐานะ "ร้านอาหาร" เป็นหลัก
excludedPrimaryTypes[]

string

ประเภทสถานที่หลักที่ได้รับการยกเว้น (เช่น "ร้านอาหาร" หรือ "gas_station") จาก https://developers.google.com/maps/documentation/places/web-service/place-types

ระบุได้สูงสุด 50 ประเภทจากตาราง ก

ถ้ามีประเภทหลักที่ขัดแย้งกัน เช่น ประเภทหนึ่งปรากฏทั้งใน includePrimaryTypes และ excludedPrimaryTypes ระบบจะแสดงผลข้อผิดพลาด INVALID_ARGUMENT

หากระบุประเภทสถานที่โดยมีข้อจำกัดหลายประเภท ระบบจะแสดงผลเฉพาะสถานที่ที่ตรงกับข้อจำกัดทั้งหมดเท่านั้น เช่น หากเรามี {includedTypes = ["restaurant"], excludedPrimaryTypes = ["Restaurant"]} สถานที่ที่กลับมาก็จะให้บริการที่เกี่ยวข้องกับ "ร้านอาหาร" แต่ไม่ได้ดำเนินธุรกิจในฐานะ "ร้านอาหาร" เป็นหลัก
maxResultCount

integer

จำนวนผลลัพธ์สูงสุดที่จะแสดง ค่านี้ต้องมีค่าตั้งแต่ 1 ถึง 20 (ค่าเริ่มต้น) โดยรวมทั้งสองค่า หากไม่ได้ตั้งค่า หมายเลขจะกลับไปเป็นขีดจำกัดสูงสุด หากตั้งค่าจำนวนเป็นลบหรือเกินขีดจำกัดสูงสุด ระบบจะแสดงข้อผิดพลาด INVALID_ARGUMENT
locationRestriction

object (LocationRestriction)

ต้องระบุ ภูมิภาคที่จะค้นหา
rankPreference

enum (RankPreference)

วิธีจัดอันดับผลการค้นหาในการตอบกลับ

เนื้อหาการตอบกลับ

ส่ง Proto สำหรับการค้นหาใกล้เคียง

หากทำสำเร็จ เนื้อหาการตอบกลับจะมีข้อมูลซึ่งมีโครงสร้างดังต่อไปนี้

การแสดง JSON 
{
  "places": [
    {
      object (Place)
    }
  ]
}
ช่อง
places[]

object (Place)

รายการสถานที่ที่ตรงกับข้อกำหนดของผู้ใช้ เช่น ประเภทสถานที่ จำนวนสถานที่ และการจำกัดสถานที่ที่เจาะจง

LocationRestriction

ภูมิภาคที่จะค้นหา

การแสดง JSON 
{

  // Union field type can be only one of the following:
  "circle": {
    object (Circle)
  }
  // End of list of possible types for union field type.
}
ช่อง

ฟิลด์การรวม type

type ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
circle

object (Circle)

วงกลมที่กำหนดโดยจุดศูนย์กลางและรัศมี

RankPreference

วิธีจัดอันดับผลการค้นหาในการตอบกลับ

Enum
RANK_PREFERENCE_UNSPECIFIED ไม่ได้ตั้งค่า RankPreference จะใช้อันดับตาม POPULARITY โดยค่าเริ่มต้น
DISTANCE จัดอันดับผลลัพธ์ตามระยะทาง
POPULARITY จัดอันดับผลการค้นหาตามความนิยม