บทนำ
เมื่อมีรหัสสถานที่แล้ว คุณจะ ขอรายละเอียดเพิ่มเติมเกี่ยวกับสถานประกอบการหรือ จุดที่น่าสนใจโดยการเริ่มคำขอ รายละเอียดสถานที่ (ใหม่) ได้ คำขอรายละเอียดสถานที่ (ใหม่) จะแสดงข้อมูลที่ครอบคลุมมากขึ้นเกี่ยวกับสถานที่ที่ระบุ เช่น ที่อยู่แบบเต็ม หมายเลขโทรศัพท์ การให้คะแนนและรีวิวของผู้ใช้
คุณขอรับรหัสสถานที่ได้หลายวิธี โดยคุณสามารถใช้สิ่งต่อไปนี้ได้
- การค้นหาข้อความ (ใหม่) หรือ การค้นหาในบริเวณใกล้เคียง (ใหม่)
- Geocoding API
- Routes API
- Address Validation API
- เติมข้อความอัตโนมัติ (ใหม่)
โปรแกรมสำรวจ 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ใน Pro SKUดูรายการฟิลด์และ SKU ที่เกี่ยวข้องทั้งหมดได้ที่ฟิลด์ข้อมูลสถานที่ (ใหม่)
ฟิลด์ต่อไปนี้จะทริกเกอร์ Place Details Essentials SKU
addressComponents
addressDescriptor*
adrFormatAddress
formattedAddress
location
plusCode
postalAddress
shortFormattedAddress
types
viewport
* โดยทั่วไปแล้ว ตัวอธิบายที่อยู่จะพร้อมให้บริการแก่ลูกค้าในอินเดีย และเป็นเวอร์ชันทดลองในประเทศอื่นๆ
ดูรายการฟิลด์และ SKU ที่เกี่ยวข้องทั้งหมดได้ที่ฟิลด์ข้อมูลสถานที่ (ใหม่)
ฟิลด์ต่อไปนี้จะทริกเกอร์ Place Details Pro 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 ที่เกี่ยวข้องทั้งหมดได้ที่ฟิลด์ข้อมูลสถานที่ (ใหม่)
ฟิลด์ต่อไปนี้จะทริกเกอร์ รายละเอียดสถานที่ Enterprise + Atmosphere SKU
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 มักจะอัปเดต ภาษาที่รองรับอยู่เสมอ ดังนั้นรายการนี้อาจไม่ครอบคลุมทั้งหมด
-
หากไม่ได้ระบุ
languageCodeAPI จะใช้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" } }
รับตัวอธิบายที่อยู่
ข้อบ่งชี้ที่อยู่จะให้ข้อมูลเชิงสัมพันธ์เกี่ยวกับตำแหน่งของสถานที่ ซึ่งรวมถึงสถานที่สำคัญและพื้นที่โดยรอบ
ตัวอย่างต่อไปนี้แสดงคำขอรายละเอียดสถานที่ (ใหม่) สำหรับห้างสรรพสินค้า
ในห้างสรรพสินค้าในซานโฮเซ ในตัวอย่างนี้ คุณจะใส่ 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 } }
ดูข้อมูลสถานีขนส่ง
คุณใช้รายละเอียดสถานที่ (ใหม่) เพื่อรับข้อมูลเกี่ยวกับสถานีขนส่งสาธารณะได้ เนื้อหาการตอบกลับประกอบด้วยข้อมูลเกี่ยวกับสถานี ซึ่งรวมถึงชื่อสถานี บริษัทขนส่งที่เกี่ยวข้อง และสายขนส่งที่ให้บริการในสถานี นอกจากนี้ คำตอบยังมีไอคอนและสีของยานพาหนะที่คุณใช้แสดงข้อมูลสถานีขนส่งได้ด้วย
ตัวอย่างต่อไปนี้แสดงคำขอข้อมูลสถานีขนส่งสำหรับสถานีแกรนด์เซ็นทรัล
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