เมื่อคุณมีรหัสสถานที่แล้ว คุณสามารถขอรายละเอียดเพิ่มเติมเกี่ยวกับสถานประกอบการหรือจุดสนใจหนึ่งๆ โดยส่งคำขอรายละเอียดสถานที่ (ใหม่) คำขอรายละเอียดสถานที่ (ใหม่) จะแสดงข้อมูลที่ครอบคลุมมากขึ้นเกี่ยวกับสถานที่ที่ระบุ เช่น ที่อยู่ที่สมบูรณ์ หมายเลขโทรศัพท์ การให้คะแนนของผู้ใช้ และรีวิว
การขอรับรหัสสถานที่ทำได้หลายวิธี คุณสามารถใช้สิ่งต่อไปนี้
- การค้นหาข้อความ (ใหม่) หรือการค้นหาใกล้เคียง (ใหม่)
- API การระบุพิกัดทางภูมิศาสตร์
- Routes API
- API การตรวจสอบที่อยู่
- สถานที่ในการเติมข้อความอัตโนมัติ
API Explorer ช่วยให้คุณสามารถสร้างคำขอแบบเรียลไทม์เพื่อทำความคุ้นเคยกับ API และตัวเลือก API ดังนี้
ลองใช้งานคำขอรายละเอียดสถานที่ (ใหม่)
คำขอรายละเอียดสถานที่คือคำขอ HTTP GET ในแบบฟอร์ม
https://places.googleapis.com/v1/places/PLACE_ID
ส่งพารามิเตอร์ทั้งหมดเป็นพารามิเตอร์ของ URL หรือในส่วนหัวโดยเป็นส่วนหนึ่งของคำขอ GET เช่น
https://places.googleapis.com/v1/places/ChIJj61dQgK6j4AR4GeTYWZsKWw?fields=id,displayName&key=API_KEY
หรือด้วยคำสั่ง cURL:
curl -X GET -H 'Content-Type: application/json' \ -H "X-Goog-Api-Key: API_KEY" \ -H "X-Goog-FieldMask: id,displayName" \ https://places.googleapis.com/v1/places/ChIJj61dQgK6j4AR4GeTYWZsKWw
คำตอบในรายละเอียดสถานที่ (ใหม่)
รายละเอียดสถานที่ (ใหม่) แสดงผล ออบเจ็กต์ JSON เป็นการตอบกลับ คำตอบ:
- คําตอบจะแสดงด้วยออบเจ็กต์
Place
ออบเจ็กต์Place
มีข้อมูลโดยละเอียดเกี่ยวกับสถานที่ - FieldMask ที่ส่งผ่านในคำขอจะระบุรายการของช่อง
ที่แสดงผลในออบเจ็กต์
Place
ออบเจ็กต์ JSON ที่ครบถ้วนอยู่ในรูปแบบต่อไปนี้
{ "name": "places/ChIJkR8FdQNB0VQRm64T_lv1g1g", "id": "ChIJkR8FdQNB0VQRm64T_lv1g1g", "displayName": { "text": "Trinidad" } ... }
พารามิเตอร์ที่จำเป็น
-
FieldMask
ระบุรายการฟิลด์ที่จะแสดงผลในคำตอบด้วยการสร้างมาสก์ฟิลด์การตอบกลับ ส่งมาสก์ของช่องคำตอบไปยังเมธอดโดยใช้พารามิเตอร์ของ URL
$fields
หรือfields
หรือใช้ส่วนหัว HTTPX-Goog-FieldMask
ไม่มีรายการเริ่มต้นของฟิลด์ที่แสดงผลในคำตอบ หากคุณไม่ใส่ฟิลด์มาสก์ เมธอดจะแสดงข้อผิดพลาดการมาสก์ช่องเป็นแนวทางปฏิบัติในการออกแบบที่ดีเพื่อให้ไม่ขอข้อมูลที่ไม่จำเป็น ซึ่งจะช่วยหลีกเลี่ยงเวลาในการประมวลผลและการเรียกเก็บเงินที่ไม่จําเป็น
ระบุรายการประเภทข้อมูลสถานที่ที่จะแสดงโดยคั่นด้วยคอมมา เช่น เพื่อดึงข้อมูลชื่อที่แสดงและที่อยู่ของสถานที่
X-Goog-FieldMask: displayName,formattedAddress
ใช้
*
เพื่อเรียกข้อมูลช่องทั้งหมดX-Goog-FieldMask: *
ระบุช่องต่อไปนี้อย่างน้อย 1 ช่อง
ช่องต่อไปนี้จะเรียก SKU รายละเอียดสถานที่ (รหัสเท่านั้น)
id
,name
*,photos
* ช่องname
มีชื่อทรัพยากรสถานที่ในแบบฟอร์ม:places/PLACE_ID
ใช้displayName
เพื่อเข้าถึงชื่อข้อความของสถานที่ช่องต่อไปนี้จะเรียก SKU รายละเอียดสถานที่ (สถานที่ตั้งเท่านั้น)
addressComponents
,adrFormatAddress
,formattedAddress
,location
,plusCode
,shortFormattedAddress
,types
,viewport
ช่องต่อไปนี้จะเรียก SKU รายละเอียดสถานที่ (พื้นฐาน)
accessibilityOptions
,businessStatus
,displayName
,googleMapsUri
,iconBackgroundColor
,iconMaskBaseUri
,primaryType
,primaryTypeDisplayName
,subDestinations
,utcOffsetMinutes
ช่องต่อไปนี้จะเรียก SKU รายละเอียดสถานที่ (ขั้นสูง) ให้แสดง
currentOpeningHours
,currentSecondaryOpeningHours
,internationalPhoneNumber
,nationalPhoneNumber
,priceLevel
,rating
,regularOpeningHours
,regularSecondaryOpeningHours
,userRatingCount
,websiteUri
ช่องต่อไปนี้จะเรียก SKU รายละเอียดสถานที่ (ที่ต้องการ)
<br-ph - "ph - 2 - x" <br - 2 <br - "1 x x 2 x 2"><br - " TH <br - " <br - " ">
allowsDogs
curbsidePickup
delivery
dineIn
editorialSummary
evChargeOptions
fuelOptions
goodForChildren
goodForGroups
goodForWatchingSports
liveMusic
menuForChildren
parkingOptions
paymentOptions
outdoorSeating
reservable
restroom
reviews
servesBeer
servesBreakfast
servesBrunch
servesCocktails
servesCoffee
servesDesserts
servesDinner
servesLunch
servesVegetarianFood
servesWine
takeout
-
placeId
ตัวระบุข้อความที่ระบุสถานที่โดยไม่ซ้ำกัน ซึ่งแสดงผลจากการค้นหาข้อความ (ใหม่) หรือการค้นหาใกล้เคียง (ใหม่) ดูข้อมูลเพิ่มเติมเกี่ยวกับรหัสสถานที่ได้ที่ภาพรวมรหัสสถานที่
สตริง
places/PLACE_ID
มีชื่อเรียกอีกอย่างว่าชื่อทรัพยากรของสถานที่ ในการตอบกลับจากคำขอรายละเอียดสถานที่ (ใหม่), การค้นหาใกล้เคียง (ใหม่) และการค้นหาข้อความ (ใหม่) สตริงนี้จะอยู่ในช่องname
ของการตอบกลับ รหัสสถานที่แบบสแตนด์อโลนจะอยู่ในช่องid
ของการตอบกลับ
พารามิเตอร์ที่ไม่บังคับ
languageCode
ภาษาของผลการค้นหา
- ดูรายการภาษาที่รองรับ Google จะอัปเดตภาษาที่รองรับเป็นประจำ ดังนั้นรายการนี้จึงอาจไม่ครอบคลุมทั้งหมด
-
หากไม่ได้ให้
languageCode
ค่าเริ่มต้นของ API จะเป็นen
หากคุณระบุรหัสภาษาที่ไม่ถูกต้อง API จะแสดงข้อผิดพลาดINVALID_ARGUMENT
- API จะพยายามอย่างเต็มที่เพื่อระบุที่อยู่ที่ทั้งผู้ใช้และคนในพื้นที่อ่านได้ เพื่อให้บรรลุเป้าหมายดังกล่าว เครื่องมือจะแสดงที่อยู่ในภาษาท้องถิ่นที่ทับศัพท์เป็นสคริปต์ที่ผู้ใช้สามารถอ่านได้หากจำเป็น โดยสังเกตภาษาที่ต้องการใช้ แต่อีเมลอื่นๆ ทั้งหมดจะแสดงผลในภาษาที่ต้องการ คอมโพเนนต์ที่อยู่ทั้งหมดจะแสดงเป็นภาษาเดียวกัน ซึ่งจะเลือกจากคอมโพเนนต์แรก
- หากไม่มีชื่อในภาษาที่ต้องการ API จะใช้ชื่อที่ตรงกันที่ใกล้เคียงที่สุด
- ภาษาที่ต้องการมีอิทธิพลเล็กน้อยต่อชุดผลลัพธ์ที่ API เลือกที่จะแสดงผล และลำดับการแสดงผล โปรแกรมเข้ารหัสพิกัดภูมิศาสตร์จะตีความตัวย่อแตกต่างกันไปตามภาษา เช่น ตัวย่อของประเภทถนน หรือคำพ้องความหมายที่อาจใช้ได้ในภาษาหนึ่งแต่ไม่ถูกต้องในอีกภาษาหนึ่ง
regionCode
รหัสภูมิภาคที่ใช้ในการจัดรูปแบบการตอบกลับ ซึ่งระบุเป็นค่า รหัส CLDR แบบ 2 อักขระ ไม่มีค่าเริ่มต้น
หากชื่อประเทศของช่อง
formattedAddress
ในการตอบกลับตรงกับregionCode
รหัสประเทศจะไม่แสดงในformattedAddress
พารามิเตอร์นี้ไม่มีผลต่อadrFormatAddress
ซึ่งจะรวมชื่อประเทศเสมอ หรือในshortFormattedAddress
ซึ่งไม่รวมชื่อประเทศรหัส CLDR ส่วนใหญ่เหมือนกับรหัส ISO 3166-1 แต่มีข้อยกเว้นบางประการที่สำคัญ เช่น ccTLD ของสหราชอาณาจักรคือ "uk" (.co.uk) ส่วนรหัส ISO 3166-1 คือ "gb" (ทางเทคนิคสำหรับเอนทิตีของ "สหราชอาณาจักรบริเตนใหญ่และไอร์แลนด์เหนือ") พารามิเตอร์นี้อาจส่งผลต่อผลลัพธ์ตามกฎหมายที่เกี่ยวข้อง
-
sessionToken
โทเค็นเซสชันเป็นสตริงที่ผู้ใช้สร้างขึ้นซึ่งติดตามการเรียกการเติมข้อความอัตโนมัติ (ใหม่) เป็น "เซสชัน" การเติมข้อความอัตโนมัติ (ใหม่) ใช้โทเค็นเซสชันเพื่อจัดกลุ่มข้อความค้นหาและตำแหน่งที่เลือกของการค้นหาแบบเติมข้อความอัตโนมัติของผู้ใช้เป็นเซสชันที่แยกจากกันเพื่อวัตถุประสงค์ในการเรียกเก็บเงิน ระบบจะส่งโทเค็นเซสชันลงในการเรียกใช้รายละเอียดสถานที่ (ใหม่) ที่ตามมาจากการเรียกการเติมข้อความอัตโนมัติ (ใหม่) ดูข้อมูลเพิ่มเติมได้ที่โทเค็นของเซสชัน
ตัวอย่างรายละเอียดสถานที่
ตัวอย่างต่อไปนี้ขอรายละเอียดของสถานที่โดย placeId
curl -X GET -H 'Content-Type: application/json' \ -H "X-Goog-Api-Key: API_KEY" \ -H "X-Goog-FieldMask: id,displayName" \ https://places.googleapis.com/v1/places/ChIJj61dQgK6j4AR4GeTYWZsKWw
โปรดทราบว่าส่วนหัว X-Goog-FieldMask
ระบุว่าการตอบกลับจะมีช่องข้อมูลต่อไปนี้ id,displayName
คำตอบจะอยู่ในรูปดังนี้
{ "id": "ChIJj61dQgK6j4AR4GeTYWZsKWw", "displayName": { "text": "Googleplex", "languageCode": "en" } }
เพิ่มประเภทข้อมูลเพิ่มเติมลงในมาสก์ของช่องเพื่อแสดงข้อมูลเพิ่มเติม
เช่น เพิ่ม formattedAddress,plusCode
เพื่อใส่ที่อยู่และ Plus Code ในคำตอบ
curl -X GET -H 'Content-Type: application/json' \ -H "X-Goog-Api-Key: API_KEY" \ -H "X-Goog-FieldMask: id,displayName,formattedAddress,plusCode" \ https://places.googleapis.com/v1/places/ChIJj61dQgK6j4AR4GeTYWZsKWw
ตอนนี้การตอบกลับจะอยู่ในรูปแล้ว
{ "id": "ChIJj61dQgK6j4AR4GeTYWZsKWw", "formattedAddress": "1600 Amphitheatre Pkwy, Mountain View, CA 94043, USA", "plusCode": { "globalCode": "849VCWC7+RW", "compoundCode": "CWC7+RW Mountain View, CA, USA" }, "displayName": { "text": "Googleplex", "languageCode": "en" } }
ลองใช้เลย
โปรแกรมสำรวจ API ให้คุณสร้างคำขอตัวอย่างเพื่อทำความคุ้นเคยกับ API และตัวเลือก API
วิธีส่งคำขอ
- เลือกไอคอน API ทางด้านขวาของหน้า
- (ไม่บังคับ) ตั้งค่าพารามิเตอร์
name
เป็นplaces/PLACE_ID
- (ไม่บังคับ) ขยายแสดงพารามิเตอร์มาตรฐานและตั้งค่าพารามิเตอร์
fields
เป็นฟิลด์มาสก์ - เลือกปุ่มดำเนินการ ในป๊อปอัป ให้เลือกบัญชีที่ต้องการใช้ส่งคำขอ
ในแผง API Explorer ให้เลือกไอคอนขยาย เพื่อขยายหน้าต่าง API Explorer