เมื่อคุณมีรหัสสถานที่แล้ว คุณสามารถขอรายละเอียดเพิ่มเติมเกี่ยวกับสถานประกอบการหรือจุดที่น่าสนใจได้โดยการเริ่มคำขอรายละเอียดสถานที่ (ใหม่) คำขอรายละเอียดสถานที่ (ใหม่) จะแสดงข้อมูลที่ครอบคลุมมากขึ้นเกี่ยวกับสถานที่ที่ระบุ เช่น ที่อยู่ หมายเลขโทรศัพท์ คะแนน และรีวิวของผู้ใช้
คุณรับรหัสสถานที่ได้หลายวิธี คุณสามารถใช้สิ่งต่อไปนี้ได้
- การค้นหาข้อความ (ใหม่) หรือการค้นหาในบริเวณใกล้เคียง (ใหม่)
- Geocoding API
- Routes API
- Address Validation API
- Place Autocomplete
เครื่องมือสํารวจ API ช่วยให้คุณส่งคําขอแบบเรียลไทม์เพื่อให้คุณคุ้นเคยกับ 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 รายละเอียดสถานที่ (รหัสเท่านั้น)
attributions,id,name*,photos
* ช่องnameมีชื่อทรัพยากรสถานที่ในรูปแบบplaces/PLACE_IDใช้displayNameเพื่อเข้าถึงชื่อข้อความของสถานที่ฟิลด์ต่อไปนี้จะทริกเกอร์ SKU รายละเอียดสถานที่ (ตำแหน่งเท่านั้น)
addressComponents,adrFormatAddress,formattedAddress,location,plusCode,shortFormattedAddress,types,viewportฟิลด์ต่อไปนี้จะทริกเกอร์ SKU รายละเอียดสถานที่ (พื้นฐาน)
accessibilityOptions,businessStatus,containingPlaces,displayName,googleMapsLinks*,googleMapsUri,iconBackgroundColor,iconMaskBaseUri,primaryType,primaryTypeDisplayName,pureServiceAreaBusiness,subDestinations,utcOffsetMinutes
* ช่องgoogleMapsLinksอยู่ในช่วงเวอร์ชันตัวอย่างก่อน GA และไม่มีการเรียกเก็บเงิน ซึ่งหมายความว่าการเรียกเก็บเงินคือ 0 บาทสำหรับการใช้งานในช่วงเวอร์ชันตัวอย่างฟิลด์ต่อไปนี้จะทริกเกอร์ SKU รายละเอียดสถานที่ (ขั้นสูง)
currentOpeningHours,currentSecondaryOpeningHours,internationalPhoneNumber,nationalPhoneNumber,priceLevel,priceRange,rating,regularOpeningHours,regularSecondaryOpeningHours,userRatingCount,websiteUriฟิลด์ต่อไปนี้จะทริกเกอร์ Place Details (Preferred) SKU
allowsDogs,curbsidePickup,delivery,dineIn,editorialSummary,evChargeOptions,fuelOptions,goodForChildren,goodForGroups,goodForWatchingSports,liveMusic,menuForChildren,parkingOptions,paymentOptions,outdoorSeating,reservable,restroom,reviews,routingSummaries,*servesBeer,servesBreakfast,servesBrunch,servesCocktails,servesCoffee,servesDessert,servesDinner,servesLunch,servesVegetarianFood,servesWine,takeout
* การค้นหาข้อความและการค้นหาในพื้นที่เท่านั้น
-
placeId
ตัวระบุที่เป็นข้อความซึ่งระบุสถานที่อย่างเจาะจง ซึ่งแสดงผลจากการค้นหาข้อความ (ใหม่) หรือการค้นหาใกล้เคียง (ใหม่) ดูข้อมูลเพิ่มเติมเกี่ยวกับรหัสสถานที่ได้ที่ภาพรวมรหัสสถานที่
สตริง
places/PLACE_IDเรียกอีกอย่างว่าชื่อทรัพยากร ในคำตอบจากคำขอรายละเอียดสถานที่ (ใหม่) การค้นหาในพื้นที่ (ใหม่) และการค้นหาข้อความ (ใหม่) สตริงนี้จะอยู่ในช่องnameของคำตอบ รหัสสถานที่แบบสแตนด์อโลนจะอยู่ในฟิลด์idของคำตอบ
พารามิเตอร์ที่ไม่บังคับ
languageCode
ภาษาที่จะแสดงผลลัพธ์
- ดูรายการภาษาที่รองรับ Google อัปเดตภาษาที่รองรับอยู่บ่อยครั้ง รายการนี้จึงอาจไม่ครอบคลุมทั้งหมด
-
หากไม่ได้ระบุ
languageCodeระบบจะใช้enเป็นค่าเริ่มต้นของ API หากคุณระบุรหัสภาษาที่ไม่ถูกต้อง 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 ให้เลือกไอคอนขยาย
เพื่อขยายหน้าต่างโปรแกรมสำรวจ API