ค้นหาสถานที่ที่อยู่ใกล้ตำแหน่ง
คำขอ 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 ( |
ช่อง | |
---|---|
languageCode |
รายละเอียดสถานที่จะแสดงเป็นภาษาที่ต้องการ ถ้ามี หากไม่ระบุหรือไม่รู้จักรหัสภาษา รายละเอียดสถานที่ของภาษาใดๆ อาจแสดงผล โดยแนะนำให้เป็นภาษาอังกฤษหากมีรายละเอียดดังกล่าว รายการภาษาที่สนับสนุนในปัจจุบัน: https://developers.google.com/maps/faq#languagesupport |
regionCode |
รหัสประเทศ/ภูมิภาคแบบ Unicode (CLDR) ของประเทศที่ส่งคำขอ พารามิเตอร์นี้ใช้เพื่อแสดงรายละเอียดสถานที่ เช่น ชื่อสถานที่เฉพาะภูมิภาค (หากมี) พารามิเตอร์อาจส่งผลต่อผลลัพธ์ตามกฎหมายที่เกี่ยวข้อง ดูข้อมูลเพิ่มเติมได้ที่ https://www.unicode.org/cldr/charts/latest/supplemental/territory_language_information.html โปรดทราบว่าขณะนี้ระบบยังไม่รองรับรหัสภูมิภาค 3 หลัก |
includedTypes[] |
ประเภทสถานที่ที่ระบุ (เช่น "ร้านอาหาร" หรือ "gas_station") จาก https://developers.google.com/maps/documentation/places/web-service/place-types ระบุประเภทจากตาราง A ได้สูงสุด 50 ประเภท หากมีประเภทที่ขัดแย้งกัน กล่าวคือ มีประเภทหนึ่งๆ ปรากฏในทั้ง includeTypes และ excludedTypes ระบบจะแสดงข้อผิดพลาด INVALID_ARGUMENT หากระบุประเภทสถานที่พร้อมข้อจำกัดหลายประเภท ระบบจะแสดงเฉพาะสถานที่ที่เป็นไปตามข้อจำกัดทั้งหมด เช่น หากเรามี {includedTypes = ["hotel"], excludedPrimaryTypes = ["restaurant"]} สถานที่ที่ส่งกลับจะมีคำว่า "ร้านอาหาร" ที่เกี่ยวข้อง แต่ไม่ได้ดำเนินธุรกิจเป็น "ร้านอาหาร" เป็นหลัก |
excludedTypes[] |
ประเภทสถานที่ที่ยกเว้น (เช่น "ร้านอาหาร" หรือ "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[] |
รวมประเภทสถานที่หลัก (เช่น "ร้านอาหาร" หรือ "gas_station") จาก https://developers.google.com/maps/documentation/places/web-service/place-types สถานที่หนึ่งๆ จะมีประเภทหลักได้เพียงประเภทเดียวจากตารางประเภทที่รองรับที่เชื่อมโยงกับสถานที่นั้น ระบุประเภทจากตาราง A ได้สูงสุด 50 ประเภท หากมีประเภทหลักที่ขัดแย้งกัน กล่าวคือ มีประเภทปรากฏในทั้งincludePrimaryTypesและ excludedPrimaryTypes ระบบจะแสดงข้อผิดพลาด INVALID_ARGUMENT หากระบุประเภทสถานที่พร้อมข้อจำกัดหลายประเภท ระบบจะแสดงเฉพาะสถานที่ที่เป็นไปตามข้อจำกัดทั้งหมด เช่น หากเรามี {includedTypes = ["hotel"], excludedPrimaryTypes = ["restaurant"]} สถานที่ที่ส่งกลับจะมีคำว่า "ร้านอาหาร" ที่เกี่ยวข้อง แต่ไม่ได้ดำเนินธุรกิจเป็น "ร้านอาหาร" เป็นหลัก |
excludedPrimaryTypes[] |
ยกเว้นประเภทสถานที่หลัก (เช่น "ร้านอาหาร" หรือ "gas_station") จาก https://developers.google.com/maps/documentation/places/web-service/place-types ระบุประเภทจากตาราง A ได้สูงสุด 50 ประเภท หากมีประเภทหลักที่ขัดแย้งกัน กล่าวคือ มีประเภทปรากฏในทั้งincludePrimaryTypesและ excludedPrimaryTypes ระบบจะแสดงข้อผิดพลาด INVALID_ARGUMENT หากระบุประเภทสถานที่พร้อมข้อจำกัดหลายประเภท ระบบจะแสดงเฉพาะสถานที่ที่เป็นไปตามข้อจำกัดทั้งหมด เช่น หากเรามี {includedTypes = ["hotel"], excludedPrimaryTypes = ["restaurant"]} สถานที่ที่ส่งกลับจะมีคำว่า "ร้านอาหาร" ที่เกี่ยวข้อง แต่ไม่ได้ดำเนินธุรกิจเป็น "ร้านอาหาร" เป็นหลัก |
maxResultCount |
จำนวนผลลัพธ์สูงสุดที่จะแสดง และต้องอยู่ระหว่าง 1 ถึง 20 (ค่าเริ่มต้น) รวมแล้ว หากไม่ได้ตั้งค่าจำนวน หมายเลขดังกล่าวจะกลับไปเป็นขีดจำกัดสูงสุด หากตั้งค่าจำนวนเป็นลบหรือเกินขีดจำกัดสูงสุด ระบบจะแสดงข้อผิดพลาด INVALID_ARGUMENT |
locationRestriction |
ต้องระบุ ภูมิภาคที่จะค้นหา |
rankPreference |
วิธีจัดอันดับผลการค้นหาในคำตอบ |
เนื้อหาการตอบกลับ
โปรโตคอลการตอบกลับสำหรับ Search Nearby
หากทำสำเร็จ เนื้อหาการตอบกลับจะมีข้อมูลซึ่งมีโครงสร้างดังต่อไปนี้
การแสดง JSON |
---|
{
"places": [
{
object ( |
ช่อง | |
---|---|
places[] |
รายการสถานที่ที่ตรงตามข้อกำหนดของผู้ใช้ เช่น ประเภทสถานที่ จำนวนสถานที่ และการจำกัดสถานที่ตั้งที่เฉพาะเจาะจง |
LocationRestriction
ภูมิภาคที่จะค้นหา
การแสดง JSON |
---|
{ // Union field |
ช่อง | |
---|---|
ช่องการรวม
|
|
circle |
วงกลมที่กำหนดโดยจุดศูนย์กลางและรัศมี |
RankPreference
วิธีจัดอันดับผลการค้นหาในคำตอบ
Enum | |
---|---|
RANK_PREFERENCE_UNSPECIFIED |
ไม่ได้ตั้งค่า RankPreference จะใช้อันดับตาม POPULARITY โดยค่าเริ่มต้น |
DISTANCE |
จัดอันดับผลการค้นหาตามระยะทาง |
POPULARITY |
จัดอันดับผลการค้นหาตามความนิยม |