บทนำ
เมื่อมีรหัสสถานที่แล้ว คุณสามารถขอรายละเอียดเพิ่มเติมเกี่ยวกับสถานที่ประกอบธุรกิจหรือจุดที่น่าสนใจที่เฉพาะเจาะจงได้โดยเริ่มคำขอรายละเอียดสถานที่ (ใหม่) คำขอรายละเอียดสถานที่ (ใหม่) จะแสดงข้อมูลที่ครอบคลุมมากขึ้นเกี่ยวกับสถานที่ที่ระบุ เช่น ที่อยู่ หมายเลขโทรศัพท์ การให้คะแนนของผู้ใช้ และรีวิวที่สมบูรณ์
คุณสามารถรับรหัสสถานที่ได้หลายวิธี โดยคุณสามารถใช้สิ่งต่อไปนี้ได้
- การค้นหาข้อความ (ใหม่) หรือการค้นหาในบริเวณใกล้เคียง (ใหม่)
- Geocoding API
- Routes API
- Address Validation API
- 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
consumerAlert
id
movedPlace
movedPlaceId
name*
photos
* ช่อง
nameมีชื่อทรัพยากรของสถานที่ในรูปแบบplaces/PLACE_IDหากต้องการรับชื่อข้อความของสถานที่ ให้ขอช่องdisplayNameใน SKU ระดับ Proดูรายการฟิลด์ข้อมูลและ SKU ที่เกี่ยวข้องทั้งหมดได้ที่ช่องข้อมูลสถานที่ (ใหม่)
ช่องต่อไปนี้จะทริกเกอร์ SKU รายละเอียดสถานที่ที่จำเป็น
addressComponents
addressDescriptor*
adrFormatAddress
formattedAddress
location
plusCode
postalAddress
shortFormattedAddress
types
viewport
* โดยทั่วไปแล้ว รายละเอียดที่อยู่จะพร้อมให้บริการแก่ลูกค้าในอินเดีย และอยู่ระหว่างการทดสอบในประเทศอื่นๆ
ดูรายการฟิลด์ข้อมูลและ SKU ที่เกี่ยวข้องทั้งหมดได้ที่ช่องข้อมูลสถานที่ (ใหม่)
ช่องต่อไปนี้จะทริกเกอร์ SKU รายละเอียดสถานที่แบบมือโปร
accessibilityOptions
businessStatus
containingPlaces
displayName
googleMapsLinks
googleMapsTypeLabel
googleMapsUri
iconBackgroundColor
iconMaskBaseUri
openingDate
primaryType
primaryTypeDisplayName
pureServiceAreaBusiness
subDestinations
timeZone
utcOffsetMinutes
ดูรายการฟิลด์ข้อมูลและ SKU ที่เกี่ยวข้องทั้งหมดได้ที่ช่องข้อมูลสถานที่ (ใหม่)
ช่องต่อไปนี้จะทริกเกอร์ SKU ระดับองค์กรสำหรับรายละเอียดสถานที่
currentOpeningHours
currentSecondaryOpeningHours
internationalPhoneNumber
nationalPhoneNumber
priceLevel
priceRange
rating
regularOpeningHours
regularSecondaryOpeningHours
transitStation
userRatingCount
websiteUriดูรายการฟิลด์ข้อมูลและ SKU ที่เกี่ยวข้องทั้งหมดได้ที่ช่องข้อมูลสถานที่ (ใหม่)
ช่องต่อไปนี้จะทริกเกอร์ SKU รายละเอียดสถานที่ Enterprise + บรรยากาศ
allowsDogs
curbsidePickup
delivery
dineIn
editorialSummary
evChargeAmenitySummary
evChargeOptions
fuelOptions
generativeSummary
goodForChildren
goodForGroups
goodForWatchingSports
liveMusic
menuForChildren
neighborhoodSummary
parkingOptions
paymentOptions
outdoorSeating
reservable
restroom
reviews
reviewSummary
routingSummaries*
servesBeer
servesBreakfast
servesBrunch
servesCocktails
servesCoffee
servesDessert
servesDinner
servesLunch
servesVegetarianFood
servesWine
takeout
* การค้นหาข้อความและการค้นหาในบริเวณใกล้เคียงเท่านั้นดูรายการฟิลด์ข้อมูลและ SKU ที่เกี่ยวข้องทั้งหมดได้ที่ช่องข้อมูลสถานที่ (ใหม่)
-
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" } }
ดูคะแนน จำนวนรีวิว และรีวิว
หากต้องการดึงข้อมูลการให้ดาวเฉลี่ยของธุรกิจ จำนวนการให้คะแนนทั้งหมด (รีวิวทั้งหมด) หรือข้อความรีวิวจากลูกค้า ให้ใส่ฟิลด์ที่เกี่ยวข้องในส่วนหัว X-Goog-FieldMask ดังนี้
ratingและuserRatingCount: แสดงคะแนนเฉลี่ยของสถานที่ (ตั้งแต่1.0ถึง5.0) และจำนวนรีวิวทั้งหมด การขอช่องเหล่านี้จะทริกเกอร์ SKU ระดับองค์กรของรายละเอียดสถานที่reviewsและreviewSummary: แสดงผลออบเจ็กต์Reviewที่ผู้ใช้ส่งมาสูงสุด 5 รายการและสรุปรีวิวที่ AI สร้างขึ้น การขอฟิลด์เหล่านี้จะทริกเกอร์ SKU รายละเอียดสถานที่ Enterprise + Atmosphere
หากแอปต้องการเพียงคะแนนดาวและจำนวนรีวิวทั้งหมด ให้ส่งคำขอ
rating
และ
userRatingCount
โดยไม่ต้องมี
reviews
เพื่อให้คำขออยู่ในระดับ
SKU ระดับองค์กรสำหรับรายละเอียดสถานที่ ดังนี้
curl -X GET -H 'Content-Type: application/json' \ -H "X-Goog-Api-Key: API_KEY" \ -H "X-Goog-FieldMask: id,displayName,rating,userRatingCount" \ https://places.googleapis.com/v1/places/ChIJj61dQgK6j4AR4GeTYWZsKWw
หากต้องการดึงออบเจ็กต์ Review ที่ผู้ใช้ส่งมาสูงสุด 5 รายการด้วย ให้เพิ่ม reviews ลงในมาสก์ฟิลด์ (เรียกเก็บเงินที่ระดับ SKU รายละเอียดสถานที่ Enterprise + บรรยากาศ)
curl -X GET -H 'Content-Type: application/json' \ -H "X-Goog-Api-Key: API_KEY" \ -H "X-Goog-FieldMask: id,displayName,rating,userRatingCount,reviews" \ https://places.googleapis.com/v1/places/ChIJj61dQgK6j4AR4GeTYWZsKWw
การตอบกลับประกอบด้วยคะแนน จำนวนคะแนนทั้งหมด และอาร์เรย์ reviews ดังนี้
{ "id": "ChIJj61dQgK6j4AR4GeTYWZsKWw", "displayName": { "text": "Googleplex", "languageCode": "en" }, "rating": 4.2, "userRatingCount": 2594, "reviews": [ { "name": "places/ChIJj61dQgK6j4AR4GeTYWZsKWw/reviews/...", "relativePublishTimeDescription": "a month ago", "rating": 5, "text": { "text": "Iconic tech campus with visitor areas and cafes.", "languageCode": "en" }, "authorAttribution": { "displayName": "Alex Rivera" } } ] }
รับคำอธิบายที่อยู่
Address Descriptor ให้ข้อมูลเชิงสัมพันธ์เกี่ยวกับตำแหน่งของสถานที่ ซึ่งรวมถึงจุดสังเกตใกล้เคียงและพื้นที่ที่มีอยู่
ตัวอย่างต่อไปนี้แสดงคำขอรายละเอียดสถานที่ (ใหม่) สำหรับห้างสรรพสินค้าในซานโฮเซ ในตัวอย่างนี้ คุณรวม addressDescriptors ไว้ในมาสก์ฟิลด์
curl -X GET https://places.googleapis.com/v1/places/ChIJ8WvuSB7Lj4ARFyHppkxDRQ4 \ -H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \ -H "X-Goog-FieldMask: name,displayName,addressDescriptor"
การตอบกลับประกอบด้วยสถานที่ที่ระบุในคำขอ รายการจุดสังเกตใกล้เคียงและระยะทางจากสถานที่นั้น รวมถึงรายการพื้นที่และความสัมพันธ์ของการครอบคลุมกับสถานที่นั้น ดังนี้
{ "name": "places/ChIJ8WvuSB7Lj4ARFyHppkxDRQ4", "displayName": { "text": "Macy's", "languageCode": "en" }, "addressDescriptor": { "landmarks": [ { "name": "places/ChIJVVVVUB7Lj4ARXyb4HFVDV8s", "placeId": "ChIJVVVVUB7Lj4ARXyb4HFVDV8s", "displayName": { "text": "Westfield Valley Fair", "languageCode": "en" }, "types": [ "clothing_store", "department_store", "establishment", "food", "movie_theater", "point_of_interest", "restaurant", "shoe_store", "shopping_mall", "store" ], "spatialRelationship": "WITHIN", "straightLineDistanceMeters": 220.29175 }, { "name": "places/ChIJ62_oCR7Lj4AR_MGWkSPotD4", "placeId": "ChIJ62_oCR7Lj4AR_MGWkSPotD4", "displayName": { "text": "Nordstrom", "languageCode": "en" }, "types": [ "clothing_store", "department_store", "establishment", "point_of_interest", "shoe_store", "store" ], "straightLineDistanceMeters": 329.45178 }, { "name": "places/ChIJmx1c5x7Lj4ARJXJy_CU_JbE", "placeId": "ChIJmx1c5x7Lj4ARJXJy_CU_JbE", "displayName": { "text": "Monroe Parking Garage", "languageCode": "en" }, "types": [ "establishment", "parking", "point_of_interest" ], "straightLineDistanceMeters": 227.05153 }, { "name": "places/ChIJxcwBziHLj4ARUQLAvtzkRCM", "placeId": "ChIJxcwBziHLj4ARUQLAvtzkRCM", "displayName": { "text": "Studios Inn by Daiwa Living California Inc.", "languageCode": "en" }, "types": [ "establishment", "lodging", "point_of_interest", "real_estate_agency" ], "straightLineDistanceMeters": 299.9955 }, { "name": "places/ChIJWWIlNx7Lj4ARpe1E0ob-_GI", "placeId": "ChIJWWIlNx7Lj4ARpe1E0ob-_GI", "displayName": { "text": "Din Tai Fung", "languageCode": "en" }, "types": [ "establishment", "food", "point_of_interest", "restaurant" ], "straightLineDistanceMeters": 157.70943 } ], "areas": [ { "name": "places/ChIJb3F-EB7Lj4ARnHApQ_Hu1gI", "placeId": "ChIJb3F-EB7Lj4ARnHApQ_Hu1gI", "displayName": { "text": "Westfield Valley Fair", "languageCode": "en" }, "containment": "WITHIN" }, { "name": "places/ChIJXYuykB_Lj4AR1Ot8nU5q26Q", "placeId": "ChIJXYuykB_Lj4AR1Ot8nU5q26Q", "displayName": { "text": "Valley Fair", "languageCode": "en" }, "containment": "WITHIN" }, { "name": "places/ChIJtYoUX2DLj4ARKoKOb1G0CpM", "placeId": "ChIJtYoUX2DLj4ARKoKOb1G0CpM", "displayName": { "text": "Central San Jose", "languageCode": "en" }, "containment": "WITHIN" } ] } }
ดูรายละเอียดสถานที่สำหรับสถานที่ที่ย้ายแล้ว
หากสถานที่ที่อ้างอิงในแอปย้ายไปแล้ว คุณสามารถใช้ช่อง movedPlace และ movedPlaceId เพื่อดูรายละเอียดของสถานที่ใหม่ได้
สำหรับสถานที่ที่ปิดถาวร รายละเอียดสถานที่ (ใหม่) จะแสดงผล CLOSED_PERMANENTLY ในช่อง businessStatus และละเว้นช่อง movedPlace และ movedPlaceId ในเนื้อหาการตอบกลับ
สำหรับสถานที่ที่ย้ายไปยังตำแหน่งใหม่ รายละเอียดสถานที่ (ใหม่) จะแสดงผล CLOSED_PERMANENTLY ในช่อง businessStatus และแสดงผลตำแหน่งใหม่ในช่อง movedPlace และ movedPlaceId ของเนื้อหาการตอบกลับ
สำหรับสถานที่ที่ไม่ได้ย้าย รายละเอียดสถานที่ (ใหม่) จะไม่แสดง movedPlace หรือ movedPlaceId ในเนื้อหาการตอบกลับ
ตัวอย่างต่อไปนี้ขอข้อมูลสถานที่เกี่ยวกับ Marche IGA St-Canut ในควิเบก แคนาดา
curl -X GET -H 'Content-Type: application/json' \ -H 'x-Goog-Api-Key: API_KEY' \ -H 'X-Goog-FieldMask: id,displayName,businessStatus,movedPlace,movedPlaceId' \ https://places.googleapis.com/v1/places/ChIJUfQdGInVzkwRzAjmjzWB7CQ
คำขอจะแสดงผลการตอบกลับต่อไปนี้
{ "id": "ChIJUfQdGInVzkwRzAjmjzWB7CQ", "businessStatus": "CLOSED_PERMANENTLY", "displayName": { "text": "Marche IGA St-Canut", "languageCode": "en" }, "movedPlace": "places/ChIJ36QT7n8qz0wRDqVZ_UBlUlQ", "movedPlaceId": "ChIJ36QT7n8qz0wRDqVZ_UBlUlQ" }
หากต้องการขอรายละเอียดเกี่ยวกับสถานที่ใหม่ ให้ใช้ชื่อทรัพยากรสถานที่ในช่อง movedPlace ในคำขอรายละเอียดสถานที่ (ใหม่) รายการใหม่
สำหรับสถานที่ที่ย้ายหลายครั้ง การดูรายละเอียดเกี่ยวกับตำแหน่งปัจจุบันอาจต้องใช้คำขอรายละเอียดสถานที่ (ใหม่) ที่เชื่อมโยงกันหลายรายการ ช่อง movedPlace และ movedPlaceId ของผลลัพธ์สถานที่ชี้ไปยังตำแหน่งถัดไปเท่านั้น ไม่ใช่ตำแหน่งที่ทราบล่าสุด สถานที่ตั้งจะอยู่ในตำแหน่งปัจจุบันหากคำขอรายละเอียดสถานที่ (ใหม่) ละเว้นฟิลด์ movedPlace และ movedPlaceId ในเนื้อหาการตอบกลับ
ค้นหาธุรกิจที่จะเปิดในอนาคต
คุณขอรายละเอียดเกี่ยวกับธุรกิจที่คาดว่าจะเปิดในอนาคตได้
การค้นหาในบริเวณใกล้เคียง (ใหม่) จะป้อนข้อมูลในช่อง openingDate หากวันที่เปิดทำการที่คาดการณ์ไว้อย่างน้อยระบุเดือนและเหลือเวลาอีกไม่ถึง 90 วัน
ตัวอย่างต่อไปนี้แสดงคำขอการค้นหาในบริเวณใกล้เคียง (ใหม่) สำหรับธุรกิจที่กำลังจะเปิดในอนาคตในนิวเมโดวส์ รัฐไอดาโฮ
curl -X GET \ -H "Content-Type: application/json" \ -H "X-Goog-Api-Key: API_KEY" \ -H "X-Goog-FieldMask: id,businessStatus,openingDate" \ "https://places.googleapis.com/v1/places/ChIJp1-VoKWJplQRMz8g-7Wa3Do"
การตอบกลับจะมีสถานะทางธุรกิจของสถานที่และวันที่คาดว่าจะเปิดทำการ ดังนี้
{ "id": "ChIJp1-VoKWJplQRMz8g-7Wa3Do", "businessStatus": "FUTURE_OPENING", "openingDate": { "year": 2026, "month": 4, "day": 15 } }
ดูข้อมูลสถานีขนส่ง
คุณสามารถใช้รายละเอียดสถานที่ (ใหม่) เพื่อดูข้อมูลเกี่ยวกับสถานีขนส่งได้ เนื้อหาการตอบกลับประกอบด้วยข้อมูลเกี่ยวกับสถานี ซึ่งรวมถึงชื่อสถานี บริษัทขนส่งที่เกี่ยวข้อง และสายขนส่งที่ให้บริการสถานี นอกจากนี้ การตอบกลับยังมีไอคอนยานพาหนะและสีที่คุณใช้แสดงข้อมูลสถานีขนส่งได้ด้วย
ตัวอย่างต่อไปนี้แสดงคำขอข้อมูลสถานีขนส่งสำหรับสถานี Grand Central
curl -X GET \ -H "Content-Type: application/json" \ -H "X-Goog-Api-Key: API_KEY" \ -H "X-Goog-FieldMask: id,displayName,transitStation" \ "https://places.googleapis.com/v1/places/ChIJLVaKiQFZwokRgcybX3K6Pzg"
เนื้อหาการตอบกลับประกอบด้วยข้อมูลเกี่ยวกับสถานีแต่ละแห่งภายในรัศมี สายที่ให้บริการโดยสถานี การแจ้งเตือนที่ออกโดยบริษัทขนส่งที่ป้ายหยุดรถนั้น และข้อมูลการออกเดินทาง ดังนี้
{ "id": "ChIJLVaKiQFZwokRgcybX3K6Pzg", "displayName": { "text": "Grand Central", "languageCode": "en" }, "transitStation": { "displayName": { "text": "Grand Central", "languageCode": "en" }, "agencies": [ { "displayName": { "text": "MTA New York City Transit", "languageCode": "en" }, "url": "http://www.mta.info/", "lines": [ { "id": "ChIJ420yFwBZwokR903kVZLSsFc", "vehicleType": "SUBWAY", "displayName": { "text": "42 St Shuttle", "languageCode": "en" }, "shortDisplayName": { "text": "S", "languageCode": "en" }, "textColor": "#FFFFFF", "backgroundColor": "#808183", "url": "https://www.mta.info/schedules/subway/42-st-shuttle", "icon": { "url": "https://maps.gstatic.com/mapfiles/transit/iw2/svg/us-ny-mta/S.svg", "nameIncluded": true }, "vehicleIcon": { "url": "https://maps.gstatic.com/mapfiles/transit/iw2/svg/subway2.svg" } }, { "id": "ChIJDdd_uEdfwokRHbLvWrdBdDM", "vehicleType": "SUBWAY", "displayName": { "text": "5 Train (Lexington Av Express)", "languageCode": "en" }, "shortDisplayName": { "text": "5 Line", "languageCode": "en" }, "textColor": "#FFFFFF", "backgroundColor": "#00933C", "url": "https://www.mta.info/schedules/subway/5-train", "icon": { "url": "https://maps.gstatic.com/mapfiles/transit/iw2/svg/us-ny-mta/5.svg", "nameIncluded": true }, "vehicleIcon": { "url": "https://maps.gstatic.com/mapfiles/transit/iw2/svg/subway2.svg" } } ... ] }, { "displayName": { "text": "MTA", "languageCode": "en" }, "url": "https://new.mta.info/", "lines": [ { "id": "ChIJcwVpzKpZwokR24EBeh8arww", "vehicleType": "BUS", "displayName": { "text": "United Nations - W 42 St Pier", "languageCode": "en" }, "shortDisplayName": { "text": "M42", "languageCode": "en" }, "textColor": "#FFFFFF", "backgroundColor": "#1D59B3", "vehicleIcon": { "url": "https://maps.gstatic.com/mapfiles/transit/iw2/svg/bus2.svg" } } ] }, { "displayName": { "text": "Long Island Rail Road", "languageCode": "en" }, "url": "http://www.mta.info/lirr", "lines": [ { "id": "ChIJv9m8uWM56IkRUcVBQ6Q_In0", "vehicleType": "HEAVY_RAIL", "displayName": { "text": "Ronkonkoma Branch", "languageCode": "en" }, "shortDisplayName": { "text": "LIRR", "languageCode": "en" }, "textColor": "#FFFFFF", "backgroundColor": "#A626AA", "vehicleIcon": { "url": "https://maps.gstatic.com/mapfiles/transit/iw2/svg/rail2.svg" } } ... ] } ], "stops": [ { "id": "ChIJRcemlf1YwokRhFqqw5jKBFM", "stopCode": { "text": "GCT" }, "location": { "latitude": 40.755161, "longitude": -73.975456 }, "wheelchairAccessibleEntrance": true }, { "id": "ChIJ57l2zANZwokRD1pyhuwpfKY", "signageText": { "text": "34 St-Hudson Yards & Main St-Flushing, Queens, 7", "languageCode": "en" }, "location": { "latitude": 40.750983, "longitude": -73.9750686 }, "wheelchairAccessibleEntrance": true }, { "id": "ChIJoVXJgQFZwokR1yzq_WVuEuc", "displayName": { "text": "E 42 St/Park Av", "languageCode": "en" }, "location": { "latitude": 40.7518199, "longitude": -73.9771918 }, "wheelchairAccessibleEntrance": true } ... ] } }
ดูทางเข้าและจุดนำทาง
คุณสามารถขอทางเข้าและจุดนําทางสําหรับจุดหมายได้ ทางเข้าจะกำหนดจุดเข้าและออกของสถานที่ (เช่น ประตูต่างๆ ที่สนามบินหรือห้างสรรพสินค้า) จุดนำทางจะกำหนดตำแหน่งริมถนนที่การนำทางควรสิ้นสุด ซึ่งเป็นประโยชน์ในการนำทางผู้ใช้ไปยังฝั่งถนนที่ถูกต้องหรือจุดส่งผู้โดยสารที่เฉพาะเจาะจง
จุดนำทางจะแสดงผลเป็น navigationPointToken คุณสามารถส่งโทเค็นนี้ไปยัง Navigation SDK (ใช้ได้กับ Android หรือ iOS) หรือ Routes API เพื่อนำทางคนขับไปยังสถานที่ที่เจาะจงนั้นได้ ดูข้อมูลเพิ่มเติมได้ที่โทเค็นจุดนำทาง
ตัวอย่างต่อไปนี้ขอรายละเอียดของสนามบินนานาชาติซานฟรานซิสโก (รหัสสถานที่ ChIJVVVVVYx3j4ARP-3NGldc8qQ) รวมถึง entrances และ navigationPoints ในมาสก์ฟิลด์
curl -X GET -H 'Content-Type: application/json' \ -H "X-Goog-Api-Key: API_KEY" \ -H "X-Goog-FieldMask: id,displayName,entrances,navigationPoints" \ https://places.googleapis.com/v1/places/ChIJVVVVVYx3j4ARP-3NGldc8qQ
การตอบกลับจะมีทางเข้าและจุดนําทางสําหรับสถานที่นั้นๆ ดังนี้
{ "id": "ChIJVVVVVYx3j4ARP-3NGldc8qQ", "displayName": { "text": "San Francisco International Airport", "languageCode": "en" }, "entrances": [ { "location": { "latitude": 37.6172154, "longitude": -122.3839724 } }, { "location": { "latitude": 37.6174073, "longitude": -122.384196 } }, ... ], "navigationPoints": [ { "navigationPointToken": "ChIJoioBjMLOQkAR0A3yH_eYXsA...", "displayName": { "text": "International Terminal Departures Level", "languageCode": "en" }, "location": { "latitude": 37.6153121, "longitude": -122.3900833 }, "travelModes": ["WALK"] }, { "navigationPointToken": "ChIJy5JKws_OQkAROx0jNN2YXsA...", "displayName": { "text": "Domestic Garage - SFO Short Term Parking", "languageCode": "en" }, "location": { "latitude": 37.6157153, "longitude": -122.3885012 }, "travelModes": ["DRIVE", "WALK"], "usages": ["PARKING"] }, ... ] }
ลองใช้งาน
โปรแกรมสำรวจ API ช่วยให้คุณสร้างคำขอตัวอย่างเพื่อให้คุ้นเคยกับ API และตัวเลือก API ได้
เลือกไอคอน API api ทางด้านขวาของหน้า
แก้ไขพารามิเตอร์คำขอ (ไม่บังคับ)
เลือกปุ่มดำเนินการ ในกล่องโต้ตอบ ให้เลือกบัญชีที่ต้องการใช้เพื่อส่งคำขอ
ในแผงโปรแกรมสำรวจ API ให้เลือกไอคอนเต็มหน้าจอ fullscreen เพื่อขยายหน้าต่างโปรแกรมสำรวจ API