บทนำ
เมื่อมีรหัสสถานที่แล้ว คุณสามารถ ขอรายละเอียดเพิ่มเติมเกี่ยวกับสถานประกอบการหรือ จุดที่น่าสนใจที่เฉพาะเจาะจงได้โดยเริ่มคำขอ รายละเอียดสถานที่ (ใหม่) คำขอรายละเอียดสถานที่ (ใหม่) จะแสดงข้อมูลที่ครอบคลุมมากขึ้นเกี่ยวกับสถานที่ที่ระบุ เช่น ที่อยู่แบบเต็ม หมายเลขโทรศัพท์ คะแนนและรีวิวจากผู้ใช้
คุณรับรหัสสถานที่ได้หลายวิธี โดยสามารถใช้สิ่งต่อไปนี้
- การค้นหาข้อความ (ใหม่) หรือ การค้นหาในบริเวณใกล้เคียง (ใหม่)
- 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 เป็นการตอบกลับ โดยในการตอบกลับจะมีข้อมูลดังนี้
- การตอบกลับจะแสดงด้วยออบเจ็กต์
PlacePlaceซึ่งมีข้อมูลโดยละเอียดเกี่ยวกับ สถานที่ - FieldMask ที่ส่งในคำขอจะระบุรายการฟิลด์
ที่แสดงผลในออบเจ็กต์
Place
ออบเจ็กต์ JSON ที่สมบูรณ์จะอยู่ในรูปแบบดังนี้
{ "name": "places/ChIJkR8FdQNB0VQRm64T_lv1g1g", "id": "ChIJkR8FdQNB0VQRm64T_lv1g1g", "displayName": { "text": "Trinidad" } ... }
พารามิเตอร์ที่จำเป็น
-
FieldMask
ระบุรายการฟิลด์ที่จะแสดงผลในการตอบกลับโดยสร้าง FieldMask ของการตอบกลับ ส่ง FieldMask ของการตอบกลับไปยังเมธอดโดยใช้พารามิเตอร์ URL
$fieldsหรือfieldsหรือโดยใช้ส่วนหัว HTTPX-Goog-FieldMaskการตอบกลับจะไม่มีรายการฟิลด์เริ่มต้นที่แสดงผล หากไม่ระบุ FieldMask เมธอดจะแสดงข้อผิดพลาดการมาสก์ฟิลด์เป็นแนวทางปฏิบัติแนะนำในการออกแบบเพื่อให้มั่นใจว่าคุณจะไม่ขอ ข้อมูลที่ไม่จำเป็น ซึ่งจะช่วยหลีกเลี่ยงเวลาในการประมวลผลและ ค่าบริการที่ไม่จำเป็น
ระบุรายการประเภทข้อมูลสถานที่ที่คั่นด้วยคอมมาที่จะแสดงผล เช่น หากต้องการดึงชื่อที่แสดงและที่อยู่ของสถานที่
X-Goog-FieldMask: displayName,formattedAddress
ใช้
*เพื่อดึงข้อมูลทุกฟิลด์X-Goog-FieldMask: *
ระบุฟิลด์ต่อไปนี้อย่างน้อย 1 รายการ
ฟิลด์ต่อไปนี้จะทริกเกอร์ SKU รายละเอียดสถานที่แบบจำเป็น (เฉพาะรหัส):
attributions
consumerAlert
id
movedPlace
movedPlaceId
name*
photos
* ฟิลด์
nameมี ชื่อทรัพยากร ของสถานที่ในรูปแบบplaces/PLACE_IDหากต้องการรับชื่อข้อความของสถานที่ ให้ขอฟิลด์displayNameใน SKU ระดับโปรดูรายการฟิลด์ทั้งหมดและ 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 รายละเอียดสถานที่ระดับ Enterprise:
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 มักจะอัปเดต ภาษาที่รองรับ ดังนั้นรายการนี้อาจไม่ครอบคลุมทั้งหมด
-
หากไม่ได้ระบุ
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" } }
เพิ่มประเภทข้อมูลเพิ่มเติมลงใน FieldMask เพื่อแสดงข้อมูลเพิ่มเติม
เช่น เพิ่ม 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
ไว้ใน FieldMask
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 ใน FieldMask
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