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

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

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

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

string

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

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

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

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

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

string

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

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

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

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

string

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

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

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

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

integer

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

object (LocationRestriction)

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

enum (RankPreference)

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

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

โปรโตคอลการตอบกลับสำหรับ Search Nearby

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

การแสดง 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 จัดอันดับผลการค้นหาตามความนิยม