บทนำ
การค้นหาข้อความ (ใหม่) แสดงข้อมูลเกี่ยวกับชุดสถานที่ตามสตริง (เช่น "พิซซ่าในนิวยอร์ก" หรือ "ร้านขายรองเท้าใกล้ออตตาวา" หรือ "123 ถนนเมน") บริการจะตอบกลับด้วยรายการสถานที่ที่ตรงกับสตริงข้อความและค่าความเอนเอียงของสถานที่ ที่ตั้งไว้
นอกเหนือจากพารามิเตอร์ที่จําเป็นแล้ว การค้นหาข้อความ (ใหม่) ยังรองรับการปรับแต่งคําค้นหาโดยใช้ พารามิเตอร์ที่ไม่บังคับเพื่อให้ได้ผลลัพธ์ที่ดีขึ้น
โปรแกรมสำรวจ API ช่วยให้คุณส่งคำขอแบบเรียลไทม์เพื่อให้คุ้นเคยกับ API และตัวเลือก API ได้
คำขอการค้นหาข้อความ (ใหม่)
คำขอการค้นหาข้อความ (ใหม่) คือคำขอ HTTP POST ในรูปแบบต่อไปนี้
https://places.googleapis.com/v1/places:searchText
ส่งพารามิเตอร์ทั้งหมดในเนื้อหาคำขอ JSON หรือในส่วนหัวโดยเป็นส่วนหนึ่งของคำขอ POST เช่น
curl -X POST -d '{
"textQuery" : "Spicy Vegetarian Food in Sydney, Australia"
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \
-H 'X-Goog-FieldMask: places.displayName,places.formattedAddress,places.priceLevel' \
'https://places.googleapis.com/v1/places:searchText'คำตอบของการค้นหาข้อความ (ใหม่)
การค้นหาข้อความ (ใหม่) จะแสดง ออบเจ็กต์ JSON เป็นการตอบกลับ ในการตอบกลับ
- อาร์เรย์
placesมีสถานที่ที่ตรงกันทั้งหมด - สถานที่แต่ละแห่งในอาร์เรย์จะแสดงด้วยออบเจ็กต์
Placeออบเจ็กต์Placeมีข้อมูลโดยละเอียดเกี่ยวกับสถานที่เดียว - FieldMask ที่ส่งในคำขอจะระบุรายการฟิลด์ที่แสดงผลในออบเจ็กต์
Place - เราไม่รับประกันว่ารายการสถานที่ที่แสดงจะสอดคล้องกันสำหรับคำขอที่เหมือนกัน
ออบเจ็กต์ JSON ที่สมบูรณ์จะอยู่ในรูปแบบดังนี้
{
"places": [
{
object (Place)
}
]
}พารามิเตอร์ที่จำเป็น
-
FieldMask
ระบุรายการฟิลด์ที่จะแสดงในคำตอบโดยการสร้าง มาสก์ฟิลด์การตอบกลับ ส่งฟิลด์มาสก์การตอบกลับไปยังเมธอดโดยใช้พารามิเตอร์ของ URL
$fieldsหรือfieldsหรือโดยใช้ส่วนหัว HTTPX-Goog-FieldMaskไม่มีรายการฟิลด์เริ่มต้นที่แสดงในคำตอบ หากคุณละเว้นมาสก์ฟิลด์ เมธอดจะแสดงข้อผิดพลาดการมาสก์ฟิลด์เป็นแนวทางปฏิบัติแนะนำในการออกแบบเพื่อให้แน่ใจว่าคุณไม่ได้ขอข้อมูลที่ไม่จำเป็น ซึ่งจะช่วยหลีกเลี่ยงเวลาในการประมวลผลและการเรียกเก็บเงินที่ไม่จำเป็น
ระบุรายการประเภทข้อมูลสถานที่ที่คั่นด้วยคอมมาเพื่อส่งคืน เช่น เพื่อดึงชื่อที่แสดงและที่อยู่ของสถานที่
X-Goog-FieldMask: places.displayName,places.formattedAddress
ใช้
*เพื่อดึงข้อมูลทุกฟิลด์X-Goog-FieldMask: *
ระบุช่องต่อไปนี้อย่างน้อย 1 ช่อง
ฟิลด์ต่อไปนี้จะทริกเกอร์ การค้นหาข้อความ Search Essentials ID Only SKU
places.attributions
places.id
places.consumerAlert
places.name*
nextPageToken
places.movedPlace
places.movedPlaceId* ฟิลด์
places.nameมีชื่อทรัพยากรของสถานที่ในรูปแบบplaces/PLACE_IDใช้places.displayNameใน Pro SKU เพื่อเข้าถึงชื่อข้อความของสถานที่ดูรายการฟิลด์และ SKU ที่เกี่ยวข้องทั้งหมดได้ที่ฟิลด์ข้อมูลสถานที่ (ใหม่)
ฟิลด์ต่อไปนี้จะทริกเกอร์ SKU ของการค้นหาข้อความ Pro
places.accessibilityOptions
places.addressComponents
places.addressDescriptor*
places.adrFormatAddress
places.businessStatus
places.containingPlaces
places.displayName
places.formattedAddress
places.googleMapsLinks
places.googleMapsTypeLabel
places.googleMapsUri
places.iconBackgroundColor
places.iconMaskBaseUri
places.location
places.openingDate
places.photos
places.plusCode
places.postalAddress
places.primaryType
places.primaryTypeDisplayName
places.pureServiceAreaBusiness
places.shortFormattedAddress
places.searchUri
places.subDestinations
places.timeZone
places.types
places.utcOffsetMinutes
places.viewport
* โดยทั่วไปแล้ว ตัวอธิบายที่อยู่จะมีให้บริการแก่ลูกค้าในอินเดีย และเป็นเวอร์ชันทดลองในประเทศอื่นๆดูรายการฟิลด์และ SKU ที่เกี่ยวข้องทั้งหมดได้ที่ฟิลด์ข้อมูลสถานที่ (ใหม่)
ช่องต่อไปนี้จะทริกเกอร์ SKU ระดับองค์กรสำหรับการค้นหาข้อความ
places.currentOpeningHours
places.currentSecondaryOpeningHours
places.internationalPhoneNumber
places.nationalPhoneNumber
places.priceLevel
places.priceRange
places.rating
places.regularOpeningHours
places.regularSecondaryOpeningHours
places.transitStation
places.userRatingCount
places.websiteUriดูรายการฟิลด์ทั้งหมดและ SKU ที่เกี่ยวข้องได้ที่ฟิลด์ข้อมูลสถานที่ (ใหม่)
ช่องต่อไปนี้จะทริกเกอร์ SKU ของ การค้นหาข้อความ Enterprise + Atmosphere
places.allowsDogs
places.curbsidePickup
places.delivery
places.dineIn
places.editorialSummary
places.evChargeAmenitySummary
places.evChargeOptions
places.fuelOptions
places.generativeSummary
places.goodForChildren
places.goodForGroups
places.goodForWatchingSports
places.liveMusic
places.menuForChildren
places.neighborhoodSummary
places.parkingOptions
places.paymentOptions
places.outdoorSeating
places.reservable
places.restroom
places.reviews
places.reviewSummary
routingSummaries*
places.servesBeer
places.servesBreakfast
places.servesBrunch
places.servesCocktails
places.servesCoffee
places.servesDessert
places.servesDinner
places.servesLunch
places.servesVegetarianFood
places.servesWine
places.takeout
* การค้นหาข้อความและการค้นหาในบริเวณใกล้เคียงเท่านั้นดูรายการฟิลด์และ SKU ที่เกี่ยวข้องทั้งหมดได้ที่ฟิลด์ข้อมูลสถานที่ (ใหม่)
-
textQuery
สตริงข้อความที่จะค้นหา เช่น "ร้านอาหาร" "123 ถนนเมน" หรือ "สถานที่ที่ดีที่สุดในการเยี่ยมชมในซานฟรานซิสโก" API จะแสดงผลลัพธ์ที่ตรงกันซึ่งเป็นไปได้โดยอิงตามสตริงนี้ และจัดลำดับผลลัพธ์ตามความเกี่ยวข้องที่รับรู้
การค้นหาข้อความ (ใหม่) ไม่เหมาะสําหรับคําค้นหาที่คลุมเครือ ซึ่งรวมถึงรายการต่อไปนี้
ประเภทคำค้นหา ตัวอย่าง มีแนวคิดหรือข้อจำกัดมากเกินไป เช่น ชื่อสถานที่ ถนน หรือเมืองหลายแห่งในคำค้นหาเดียว "Market Street San Francisco San Jose Airport" องค์ประกอบที่อยู่ไปรษณีย์ที่ไม่ได้แสดงใน Google Maps "C/O John Smith 123 Main Street"
"P.O. Box 13 San Francisco"ชื่อธุรกิจ เครือธุรกิจ หรือหมวดหมู่ที่รวมกับสถานที่ตั้งซึ่งไม่มีธุรกิจเหล่านี้อยู่ "เทสโก้ใกล้แดลลัส รัฐเทกซัส" คำค้นหาที่คลุมเครือซึ่งตีความได้หลายแบบ "จุดส่งคืนที่ชาร์จ" ชื่อเดิมที่ไม่ได้ใช้แล้ว "Middlesex United Kingdom" องค์ประกอบหรือเจตนาที่ไม่ได้อิงตามพื้นที่ "ท่าเรือเวนทูรามีเรือกี่ลำ" ชื่อที่ไม่เป็นทางการหรือชื่อที่ตั้งขึ้นเอง "The Jenga"
"The Helter Skelter"พิกัดละติจูดและลองจิจูด "37.422131,-122.084801"
พารามิเตอร์ที่ไม่บังคับ
-
includeFutureOpeningBusinesses
หาก
true, แสดงธุรกิจ ที่คาดว่าจะเปิดในอนาคต ค่าเริ่มต้นคือfalse
หากต้องการดึงข้อมูลสถานะธุรกิจ ให้ใส่places.businessStatusในมาสก์ฟิลด์คำขอ หากต้องการเรียกข้อมูลวันที่เปิดทำการที่คาดไว้ของธุรกิจ ให้ใส่places.openingDateในมาสก์ช่องคำขอ -
includedType
เอนเอียงผลลัพธ์ไปยังสถานที่ที่ตรงกับประเภทที่ระบุซึ่งกำหนดโดย ตาราง ก ระบุได้เพียงประเภทเดียว เช่น
"includedType":"bar""includedType":"pharmacy"
การค้นหาข้อความ (ใหม่) จะใช้การกรองประเภทสําหรับคําค้นหาบางคํา ทั้งนี้ขึ้นอยู่กับความเกี่ยวข้อง ตัวอย่างเช่น ระบบอาจไม่ใช้การกรองประเภทกับคำค้นหาที่อยู่เฉพาะเจาะจง ("123 ถนนสุขุมวิท") แต่ระบบจะใช้การกรองประเภทกับคำค้นหาตามหมวดหมู่ ("ร้านค้าใกล้เคียง" หรือ "ห้างสรรพสินค้า") เกือบทุกครั้ง
หากต้องการใช้การกรองประเภทกับคำค้นหาทั้งหมด ให้ตั้งค่า
strictTypeFilteringเป็นtrue -
includePureServiceAreaBusinesses
หากตั้งค่าเป็น
trueการตอบกลับจะรวมธุรกิจที่เข้าพบหรือนำส่งสินค้าให้ลูกค้าโดยตรง แต่ไม่มีที่ตั้งธุรกิจจริง หากตั้งค่าเป็นfalseAPI จะแสดงเฉพาะธุรกิจที่มีสถานที่ตั้งจริงเท่านั้น languageCode
ภาษาที่จะแสดงผลลัพธ์
- ดูรายการภาษาที่รองรับ Google มักจะอัปเดตภาษาที่รองรับอยู่เสมอ ดังนั้นรายการนี้อาจไม่ ครอบคลุมทั้งหมด
-
หากไม่ได้ระบุ
languageCodeไว้ API จะใช้ค่าเริ่มต้นเป็นenหากคุณระบุรหัสภาษาที่ไม่ถูกต้อง API จะแสดงข้อผิดพลาดINVALID_ARGUMENT - API จะพยายามอย่างเต็มที่เพื่อให้ที่อยู่ที่อ่านง่ายสำหรับทั้งผู้ใช้และคนในพื้นที่ เพื่อให้บรรลุเป้าหมายดังกล่าว ระบบจะแสดงที่อยู่ในภาษาท้องถิ่น โดยแปลงเป็นสคริปต์ที่ผู้ใช้อ่านได้หากจำเป็น ตามภาษาที่ต้องการ ส่วนที่อยู่อื่นๆ จะแสดงในภาษาที่ต้องการ คอมโพเนนต์ของที่อยู่ ทั้งหมดจะแสดงในภาษาเดียวกัน ซึ่งเลือกจากคอมโพเนนต์แรก
- หากชื่อไม่มีในภาษาที่ต้องการ API จะใช้ชื่อที่ใกล้เคียงที่สุด
- ภาษาที่ต้องการมีผลเล็กน้อยต่อชุดผลลัพธ์ที่ API เลือกที่จะแสดง และลำดับที่แสดง โปรแกรมเข้ารหัสพิกัดภูมิศาสตร์ จะตีความตัวย่อแตกต่างกันไปตามภาษา เช่น ตัวย่อของประเภทถนน หรือคำพ้องความหมายที่อาจ ใช้ได้ในภาษาหนึ่งแต่ใช้ไม่ได้ในอีกภาษาหนึ่ง
locationBias
ระบุพื้นที่ที่จะค้นหา ตำแหน่งนี้จะเป็นตำแหน่งที่ให้น้ำหนักพิเศษ ซึ่งหมายความว่าระบบจะแสดงผลลัพธ์รอบๆ ตำแหน่งที่ระบุ รวมถึงผลลัพธ์ที่อยู่นอกพื้นที่ที่ระบุ
คุณสามารถระบุ
locationRestrictionหรือlocationBiasได้ แต่จะระบุทั้ง 2 อย่างไม่ได้ ให้คิดว่าlocationRestrictionเป็นการระบุภูมิภาคที่ผลลัพธ์ต้องอยู่ภายใน และlocationBiasเป็นการระบุภูมิภาคที่ผลลัพธ์น่าจะอยู่ภายในหรือใกล้เคียง แต่ก็อาจอยู่นอกพื้นที่ได้ระบุภูมิภาคเป็นวิวพอร์ตสี่เหลี่ยมผืนผ้าหรือเป็นวงกลม
วงกลมจะกำหนดโดยจุดศูนย์กลางและรัศมีเป็นเมตร รัศมี ต้องอยู่ระหว่าง 0.0 ถึง 50000.0 (รวม) รัศมีเริ่มต้นคือ 0.0 เช่น
"locationBias": { "circle": { "center": { "latitude": 37.7937, "longitude": -122.3965 }, "radius": 500.0 } }
สี่เหลี่ยมผืนผ้าคือวิวพอร์ตในรูปแบบละติจูด-ลองจิจูด ซึ่งกำหนดด้วยจุดสองจุดที่อยู่มุมตรงข้ามกัน โดยจุดหนึ่งเป็นค่าต่ำสุดและอีกจุดเป็นค่าสูงสุด จุดต่ำสุดจะแสดงมุมตะวันตกเฉียงใต้ และจุดสูงสุดจะแสดงมุมตะวันออกเฉียงเหนือของสี่เหลี่ยมผืนผ้า
วิวพอร์ตถือเป็นพื้นที่ปิด ซึ่งหมายรวมถึงขอบเขตของตัววิวพอร์ตเองด้วย ขอบเขตละติจูด ต้องอยู่ระหว่าง -90 ถึง 90 องศา และขอบเขตลองจิจูด ต้องอยู่ระหว่าง -180 ถึง 180 องศา
- หาก
low=highวิวพอร์ตจะประกอบด้วยจุดเดียว - หาก
low.longitude>high.longitudeหมายความว่าช่วงลองจิจูดกลับด้าน (วิวพอร์ตข้ามเส้นลองจิจูด 180 องศา) - หาก
low.longitude= -180 องศา และhigh.longitude= 180 องศา วิวพอร์ตจะครอบคลุมลองจิจูดทั้งหมด - หาก
low.longitude= 180 องศา และhigh.longitude= -180 องศา ช่วงลองจิจูดจะว่างเปล่า - หาก
low.latitude>high.latitudeช่วงละติจูดจะว่างเปล่า
คุณต้องระบุทั้งค่าต่ำสุดและค่าสูงสุด และช่องที่แสดงต้องไม่ว่าง เนื่องจากวิวพอร์ตที่ว่างเปล่าจะทำให้เกิดข้อผิดพลาด
ตัวอย่างเช่น วิวพอร์ตนี้ครอบคลุมนิวยอร์กซิตี้ทั้งหมด
"locationBias": { "rectangle": { "low": { "latitude": 40.477398, "longitude": -74.259087 }, "high": { "latitude": 40.91618, "longitude": -73.70018 } } }
- หาก
locationRestriction
ระบุพื้นที่ที่จะค้นหาคำค้นหาตามหมวดหมู่เท่านั้น ซึ่งอาจแสดงสถานที่หลายแห่ง (เช่น "ร้านอาหารในนิวยอร์ก" หรือ "ห้างสรรพสินค้า") ระบบจะไม่แสดงผลลัพธ์ที่อยู่นอก พื้นที่ที่ระบุ
ระบุภูมิภาคเป็นวิวพอร์ตสี่เหลี่ยมผืนผ้า ดูตัวอย่างการกำหนดวิวพอร์ตได้ที่คำอธิบายของ
locationBiasคุณระบุ
locationRestrictionหรือlocationBiasได้ แต่จะระบุทั้ง 2 อย่างไม่ได้ ให้คิดว่าlocationRestrictionเป็นการระบุภูมิภาคที่ผลลัพธ์ต้องอยู่ภายใน และlocationBiasเป็นการระบุภูมิภาคที่ผลลัพธ์น่าจะอยู่ภายในหรือใกล้เคียง แต่ก็อาจอยู่นอกพื้นที่ได้-
maxResultCount (เลิกใช้งานแล้ว)
ระบุจำนวนผลลัพธ์ (ระหว่าง 1 ถึง 20) ที่จะแสดงต่อหน้า เช่น การตั้งค่า
maxResultCountเป็น 5 จะแสดงผลการค้นหาได้สูงสุด 5 รายการในหน้าแรก หากมีผลลัพธ์เพิ่มเติมที่แสดงได้จากคำค้นหา การตอบกลับจะมีnextPageTokenที่คุณสามารถส่งไปยังคำขอที่ตามมาเพื่อเข้าถึงหน้าถัดไป evOptions
ระบุพารามิเตอร์สำหรับการระบุหัวชาร์จรถยนต์ไฟฟ้า (EV) ที่พร้อมให้บริการและอัตราการชาร์จ
connectorTypes
กรองตามประเภทหัวชาร์จ EV ที่มีให้บริการในสถานที่ ระบบจะกรองสถานที่ที่ไม่รองรับหัวชาร์จประเภทใดเลยออก ประเภทหัวต่อที่ชาร์จ EV ที่รองรับ ได้แก่ ที่ชาร์จแบบรวม (AC และ DC) ที่ชาร์จ Tesla ที่ชาร์จที่สอดคล้องกับ GB/T (สำหรับการชาร์จเร็ว EV ใน จีน) และที่ชาร์จแบบเต้ารับติดผนัง ดูข้อมูลเพิ่มเติมได้ที่เอกสารประกอบ อ้างอิง
- หากต้องการกรองผลลัพธ์สำหรับเครื่องมือเชื่อมต่อที่รองรับที่เฉพาะเจาะจง ให้ตั้งค่า
connectorTypesเป็นค่านั้น เช่น หากต้องการค้นหาหัวชาร์จ J1772 ประเภท 1 ให้ตั้งค่าconnectorTypesเป็นEV_CONNECTOR_TYPE_J1772 - หากต้องการกรองผลลัพธ์สำหรับเครื่องมือเชื่อมต่อที่ไม่รองรับ ให้ตั้งค่า
connectorTypesเป็นEV_CONNECTOR_TYPE_OTHER - หากต้องการกรองผลลัพธ์สำหรับขั้วต่อประเภทใดก็ตามที่เป็นเต้ารับติดผนัง ให้ตั้งค่า
connectorTypesเป็นEV_CONNECTOR_TYPE_UNSPECIFIED_WALL_OUTLET - หากต้องการกรองผลลัพธ์สำหรับตัวเชื่อมต่อประเภทใดก็ตาม ให้ตั้งค่า
connectorTypesเป็นEV_CONNECTOR_TYPE_UNSPECIFIEDหรือไม่ต้องตั้งค่าสำหรับconnectorTypes
- หากต้องการกรองผลลัพธ์สำหรับเครื่องมือเชื่อมต่อที่รองรับที่เฉพาะเจาะจง ให้ตั้งค่า
minimumChargingRateKw
กรองสถานที่ตามอัตราการชาร์จ EV ขั้นต่ำเป็นกิโลวัตต์ (kW) ระบบจะกรองสถานที่ที่คิดอัตราค่าบริการต่ำกว่าอัตราค่าบริการขั้นต่ำออก เช่น หากต้องการค้นหาที่ชาร์จ EV ที่มีอัตราการชาร์จอย่างน้อย 10 kW คุณสามารถตั้งค่าพารามิเตอร์นี้เป็น "10" ได้
minRating
จำกัดผลลัพธ์เฉพาะผลลัพธ์ที่มีการให้คะแนนของผู้ใช้เฉลี่ยมากกว่าหรือเท่ากับขีดจำกัดนี้ ค่าต้องอยู่ระหว่าง 0.0 ถึง 5.0 (รวม) โดยเพิ่มขึ้นทีละ 0.5 เช่น 0, 0.5, 1.0, ... , 5.0 ระบบจะปัดเศษค่าขึ้นเป็น 0.5 ที่ใกล้ที่สุด เช่น ค่า 0.6 จะตัดผลลัพธ์ทั้งหมดที่มีคะแนนน้อยกว่า 1.0 ออก
openNow
หากเป็น
trueให้แสดงเฉพาะสถานที่ที่เปิดให้บริการ ณ เวลาที่ส่งคำค้นหา หากfalseให้แสดงธุรกิจทั้งหมด ไม่ว่าจะมีสถานะเปิดหรือไม่ก็ตาม สถานที่ที่ไม่ได้ระบุเวลาทำการในฐานข้อมูล Google Places จะ แสดงขึ้นหากคุณตั้งค่าพารามิเตอร์นี้เป็นfalsepageSize
ระบุจำนวนผลลัพธ์ (ระหว่าง 1 ถึง 20) ที่จะแสดงต่อหน้า เช่น การตั้งค่า
pageSizeเป็น 5 จะแสดงผลการค้นหาได้สูงสุด 5 รายการในหน้าแรก หากมีผลลัพธ์เพิ่มเติมที่สามารถแสดงได้ จากคำค้นหา การตอบกลับจะมีnextPageTokenที่คุณ ส่งไปยังคำขอถัดไปเพื่อเข้าถึงหน้าถัดไปได้pageToken
ระบุ
nextPageTokenจากเนื้อหาการตอบกลับของ หน้าก่อนหน้า-
priceLevels
จำกัดการค้นหาเฉพาะสถานที่ที่มีการทำเครื่องหมายในระดับราคาที่กำหนด ค่าเริ่มต้นคือเลือกระดับราคาทั้งหมด
สถานที่ประเภทต่อไปนี้อาจมีระดับราคา
ระบบจะไม่รวมสถานที่ประเภทที่ไม่รองรับไว้ในการตอบกลับหากมีการระบุ
priceLevelsระบุอาร์เรย์ของค่าอย่างน้อย 1 ค่าที่กำหนดโดย
PriceLevelเช่น
"priceLevels":["PRICE_LEVEL_INEXPENSIVE", "PRICE_LEVEL_MODERATE"]
rankPreference
ระบุวิธีจัดอันดับผลลัพธ์ในการตอบกลับตามประเภทของคำค้นหา ดังนี้
- สำหรับคำค้นหาแบบหมวดหมู่ เช่น "ร้านอาหารในนิวยอร์ก"
RELEVANCE(จัดอันดับผลลัพธ์ตามความเกี่ยวข้องกับการค้นหา) จะเป็นค่าเริ่มต้น คุณสามารถตั้งค่าrankPreferenceเป็นRELEVANCEหรือDISTANCE(จัดอันดับผลการค้นหาตามระยะทาง) - สำหรับคำค้นหาที่ไม่ใช่หมวดหมู่ เช่น "เมาน์เทนวิว แคลิฟอร์เนีย" เราขอแนะนำ
ให้คุณปล่อย
rankPreferenceไว้โดยไม่ต้องตั้งค่า
- สำหรับคำค้นหาแบบหมวดหมู่ เช่น "ร้านอาหารในนิวยอร์ก"
regionCode
รหัสภูมิภาคที่ใช้จัดรูปแบบการตอบกลับ โดยระบุเป็นค่า รหัส CLDR 2 หลัก พารามิเตอร์นี้ยังส่งผลต่อความลำเอียงในผลการค้นหาด้วย ไม่มีค่าเริ่มต้น
หากชื่อประเทศของช่อง
formattedAddressในการตอบกลับตรงกับregionCodeระบบจะไม่รวมรหัสประเทศจากformattedAddressพารามิเตอร์นี้จะไม่มีผลกับadrFormatAddressซึ่งจะรวมชื่อประเทศเสมอเมื่อมี หรือกับshortFormattedAddressซึ่งจะไม่รวมชื่อประเทศ เลยรหัส CLDR ส่วนใหญ่จะเหมือนกับรหัส ISO 3166-1 โดยมีข้อยกเว้นที่สำคัญบางประการ ตัวอย่างเช่น ccTLD ของสหราชอาณาจักรคือ "uk" (.co.uk) ขณะที่รหัส ISO 3166-1 คือ "gb" (ในทางเทคนิคสำหรับ นิติบุคคล "สหราชอาณาจักรบริเตนใหญ่และไอร์แลนด์เหนือ") พารามิเตอร์นี้อาจส่งผลต่อผลลัพธ์ตามกฎหมายที่เกี่ยวข้อง
strictTypeFiltering
ใช้กับพารามิเตอร์
includedTypeเมื่อตั้งค่าเป็นtrueระบบจะแสดงเฉพาะสถานที่ที่ตรงกับประเภทที่ระบุโดยincludedTypeเมื่อเป็นเท็จ (ค่าเริ่มต้น) การตอบกลับอาจมีสถานที่ที่ไม่ตรงกับ ประเภทที่ระบุ
ตัวอย่างการค้นหาข้อความ (ใหม่)
ค้นหาสถานที่ด้วยสตริงการค้นหา
ตัวอย่างต่อไปนี้แสดงคำขอการค้นหาข้อความ (ใหม่) สำหรับ "อาหารมังสวิรัติรสจัดในซิดนีย์ ออสเตรเลีย"
curl -X POST -d '{
"textQuery" : "Spicy Vegetarian Food in Sydney, Australia"
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \
-H 'X-Goog-FieldMask: places.displayName,places.formattedAddress' \
'https://places.googleapis.com/v1/places:searchText'
โปรดทราบว่าส่วนหัว X-Goog-FieldMask ระบุว่าการตอบกลับมีฟิลด์ข้อมูลต่อไปนี้ places.displayName,places.formattedAddress
จากนั้นคำตอบจะอยู่ในรูปแบบต่อไปนี้
{ "places": [ { "formattedAddress": "367 Pitt St, Sydney NSW 2000, Australia", "displayName": { "text": "Mother Chu's Vegetarian Kitchen", "languageCode": "en" } }, { "formattedAddress": "175 First Ave, Five Dock NSW 2046, Australia", "displayName": { "text": "Veggo Sizzle - Vegan & Vegetarian Restaurant, Five Dock, Sydney", "languageCode": "en" } }, { "formattedAddress": "29 King St, Sydney NSW 2000, Australia", "displayName": { "text": "Peace Harmony", "languageCode": "en" } }, ... ] }
เพิ่มประเภทข้อมูลลงในมาสก์ฟิลด์เพื่อแสดงข้อมูลเพิ่มเติม
เช่น เพิ่ม places.types,places.websiteUri เพื่อรวม
ประเภทร้านอาหารและที่อยู่เว็บใน
คำตอบ
curl -X POST -d '{
"textQuery" : "Spicy Vegetarian Food in Sydney, Australia"
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \
-H 'X-Goog-FieldMask: places.displayName,places.formattedAddress,places.types,places.websiteUri' \
'https://places.googleapis.com/v1/places:searchText'ตอนนี้การตอบกลับจะอยู่ในรูปแบบต่อไปนี้
{ "places": [ { "types": [ "vegetarian_restaurant", "vegan_restaurant", "chinese_restaurant", "restaurant", "food", "point_of_interest", "establishment" ], "formattedAddress": "367 Pitt St, Sydney NSW 2000, Australia", "websiteUri": "http://www.motherchusvegetarian.com.au/", "displayName": { "text": "Mother Chu's Vegetarian Kitchen", "languageCode": "en" } }, { "types": [ "vegan_restaurant", "thai_restaurant", "vegetarian_restaurant", "indian_restaurant", "italian_restaurant", "american_restaurant", "restaurant", "food", "point_of_interest", "establishment" ], "formattedAddress": "175 First Ave, Five Dock NSW 2046, Australia", "websiteUri": "http://www.veggosizzle.com.au/", "displayName": { "text": "Veggo Sizzle - Vegan & Vegetarian Restaurant, Five Dock, Sydney", "languageCode": "en" } }, ... ] }
กรองสถานที่ตามระดับราคา
ใช้ตัวเลือก priceLevel เพื่อกรองผลการค้นหาเป็นร้านอาหารที่กำหนดว่าราคาไม่แพงหรือราคาปานกลาง
curl -X POST -d '{
"textQuery" : "Spicy Vegetarian Food in Sydney, Australia",
"priceLevels":["PRICE_LEVEL_INEXPENSIVE", "PRICE_LEVEL_MODERATE"]
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \
-H 'X-Goog-FieldMask: places.displayName,places.formattedAddress,places.priceLevel' \
'https://places.googleapis.com/v1/places:searchText'ตัวอย่างนี้ยังใช้ส่วนหัว X-Goog-FieldMask เพื่อเพิ่มฟิลด์ข้อมูล places.priceLevel ลงใน response ด้วย เพื่อให้อยู่ในรูปแบบต่อไปนี้
{ "places": [ { "formattedAddress": "367 Pitt St, Sydney NSW 2000, Australia", "priceLevel": "PRICE_LEVEL_MODERATE", "displayName": { "text": "Mother Chu's Vegetarian Kitchen", "languageCode": "en" } }, { "formattedAddress": "115 King St, Newtown NSW 2042, Australia", "priceLevel": "PRICE_LEVEL_MODERATE", "displayName": { "text": "Green Mushroom", "languageCode": "en" } }, ... ] }
เพิ่มตัวเลือกอื่นๆ เพื่อปรับแต่งการค้นหา เช่น includedType, minRating, rankPreference, openNow และพารามิเตอร์อื่นๆ ที่อธิบายไว้ในพารามิเตอร์ที่ไม่บังคับ
จำกัดการค้นหาไว้ในพื้นที่ที่ระบุ
ใช้ locationRestriction หรือ locationBias
แต่อย่าใช้ทั้ง 2 อย่าง เพื่อจำกัดการค้นหาให้อยู่ในพื้นที่ ให้คิดว่า locationRestriction เป็นการระบุภูมิภาคที่ผลลัพธ์ต้องอยู่ภายใน และ locationBias เป็นการระบุภูมิภาคที่ผลลัพธ์ต้องอยู่ใกล้แต่สามารถอยู่นอกพื้นที่ได้
จำกัดพื้นที่โดยใช้ locationRestriction
ใช้พารามิเตอร์ locationRestriction เพื่อจำกัดผลการค้นหาไว้ที่ภูมิภาคที่ระบุ ในเนื้อหาคำขอ ให้ระบุค่าละติจูดและลองจิจูด low และ high ที่กำหนดขอบเขตภูมิภาค
ตัวอย่างต่อไปนี้แสดงคำขอการค้นหาข้อความ (ใหม่) สำหรับ "อาหาร มังสวิรัติ" ในนิวยอร์กซิตี้ คำขอนี้จะแสดงผลลัพธ์ 10 รายการแรกสำหรับสถานที่ที่เปิดอยู่เท่านั้น
curl -X POST -d '{
"textQuery" : "vegetarian food",
"pageSize" : "10",
"locationRestriction": {
"rectangle": {
"low": {
"latitude": 40.477398,
"longitude": -74.259087
},
"high": {
"latitude": 40.91618,
"longitude": -73.70018
}
}
}
}' \
-H 'Content-Type: application/json' \
-H 'X-Goog-Api-Key: API_KEY' \
-H 'X-Goog-FieldMask: places.id,places.formattedAddress' \
'https://places.googleapis.com/v1/places:searchText'
เอนเอียงไปยังพื้นที่โดยใช้ locationBias
ตัวอย่างต่อไปนี้แสดงคำขอการค้นหาข้อความ (ใหม่) สำหรับ "อาหารมังสวิรัติ" ที่มีอคติไปยังสถานที่ตั้งภายใน 500 เมตรจากจุดหนึ่งใน ดาวน์ทาวน์ซานฟรานซิสโก คำขอนี้จะแสดงผลลัพธ์ 10 รายการแรกสำหรับสถานที่ที่เปิดอยู่เท่านั้น
curl -X POST -d '{
"textQuery" : "vegetarian food",
"openNow": true,
"pageSize": 10,
"locationBias": {
"circle": {
"center": {"latitude": 37.7937, "longitude": -122.3965},
"radius": 500.0
}
},
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \
-H 'X-Goog-FieldMask: places.displayName,places.formattedAddress' \
'https://places.googleapis.com/v1/places:searchText'
ค้นหาที่ชาร์จ EV ที่มีอัตราการชาร์จขั้นต่ำ
ใช้ minimumChargingRateKw และ connectorTypes เพื่อ
ค้นหาสถานที่ที่มีเครื่องชาร์จที่พร้อมให้บริการซึ่งใช้กับ EV ของคุณได้
ตัวอย่างต่อไปนี้แสดงคำขอหัวชาร์จ EV ประเภท Tesla และ J1772 ประเภท 1 ที่มีอัตราการชาร์จขั้นต่ำ 10 kW ใน Mountain View, CA ระบบจะแสดงผลลัพธ์เพียง 4 รายการ
curl -X POST -d '{
"textQuery": "EV Charging Station Mountain View",
"pageSize": 4,
"evOptions": {
"minimumChargingRateKw": 10,
"connectorTypes": ["EV_CONNECTOR_TYPE_J1772","EV_CONNECTOR_TYPE_TESLA"]
}
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \
-H "X-Goog-FieldMask: places.displayName,places.evChargeOptions" \
'https://places.googleapis.com/v1/places:searchText'
คำขอจะแสดงการตอบกลับต่อไปนี้
{ "places": [ { "displayName": { "text": "EVgo Charging Station", "languageCode": "en" }, "evChargeOptions": { "connectorCount": 16, "connectorAggregation": [ { "type": "EV_CONNECTOR_TYPE_CHADEMO", "maxChargeRateKw": 100, "count": 8, "availableCount": 5, "outOfServiceCount": 0, "availabilityLastUpdateTime": "2024-01-10T19:10:00Z" }, { "type": "EV_CONNECTOR_TYPE_CCS_COMBO_1", "maxChargeRateKw": 100, "count": 2, "availableCount": 2, "outOfServiceCount": 0, "availabilityLastUpdateTime": "2024-01-10T19:10:00Z" }, { "type": "EV_CONNECTOR_TYPE_CCS_COMBO_1", "maxChargeRateKw": 350, "count": 6, "availableCount": 3, "outOfServiceCount": 0, "availabilityLastUpdateTime": "2024-01-10T19:10:00Z" } ] } }, { "displayName": { "text": "EVgo Charging Station", "languageCode": "en" }, "evChargeOptions": { "connectorCount": 6, "connectorAggregation": [ { "type": "EV_CONNECTOR_TYPE_CCS_COMBO_1", "maxChargeRateKw": 100, "count": 4, "availableCount": 3, "outOfServiceCount": 0, "availabilityLastUpdateTime": "2024-01-10T19:10:00Z" }, { "type": "EV_CONNECTOR_TYPE_CCS_COMBO_1", "maxChargeRateKw": 350, "count": 2, "availableCount": 0, "outOfServiceCount": 2, "availabilityLastUpdateTime": "2024-01-10T19:10:00Z" } ] } }, { "displayName": { "text": "EVgo Charging Station", "languageCode": "en" }, "evChargeOptions": { "connectorCount": 5, "connectorAggregation": [ { "type": "EV_CONNECTOR_TYPE_J1772", "maxChargeRateKw": 3.5999999046325684, "count": 1, "availableCount": 0, "outOfServiceCount": 1, "availabilityLastUpdateTime": "2024-01-10T19:10:00Z" }, { "type": "EV_CONNECTOR_TYPE_CHADEMO", "maxChargeRateKw": 50, "count": 2, "availableCount": 0, "outOfServiceCount": 0, "availabilityLastUpdateTime": "2024-01-10T19:10:00Z" }, { "type": "EV_CONNECTOR_TYPE_CCS_COMBO_1", "maxChargeRateKw": 50, "count": 2, "availableCount": 0, "outOfServiceCount": 0, "availabilityLastUpdateTime": "2024-01-10T19:10:00Z" } ] } }, { "displayName": { "text": "Electric Vehicle Charging Station", "languageCode": "en" }, "evChargeOptions": { "connectorCount": 10, "connectorAggregation": [ { "type": "EV_CONNECTOR_TYPE_OTHER", "maxChargeRateKw": 210, "count": 10 } ] } } ] }
ค้นหาธุรกิจที่ให้บริการตามสถานที่
ใช้พารามิเตอร์ includePureServiceAreaBusinesses เพื่อค้นหาธุรกิจที่ไม่มีที่อยู่สำหรับรับบริการจริง (เช่น บริการทำความสะอาดแบบเคลื่อนที่หรือรถขายอาหาร)
ตัวอย่างต่อไปนี้แสดงคำขอสำหรับช่างประปาในซานฟรานซิสโก
curl -X POST -d '{
"textQuery" : "plumber San Francisco",
"includePureServiceAreaBusinesses": true
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \
-H 'X-Goog-FieldMask: places.displayName,places.formattedAddress' \
'https://places.googleapis.com/v1/places:searchText'
ในการตอบกลับ ธุรกิจที่ไม่มีที่อยู่บริการจริงจะไม่รวมฟิลด์ formattedAddress
{ "places": [ { "formattedAddress": "3450 Sacramento St #204, San Francisco, CA 94118, USA", "displayName": { "text": "Advanced Plumbing & Drain", "languageCode": "en" } }, { "formattedAddress": "1455 Bancroft Ave, San Francisco, CA 94124, USA", "displayName": { "text": "Magic Plumbing Heating & Cooling", "languageCode": "en" } }, /.../ { "displayName": { "text": "Starboy Plumbing Inc.", "languageCode": "en" } }, { "formattedAddress": "78 Dorman Ave, San Francisco, CA 94124, USA", "displayName": { "text": "Cabrillo Plumbing, Heating & Air", "languageCode": "en" } }, { "formattedAddress": "540 Barneveld Ave # D, San Francisco, CA 94124, USA", "displayName": { "text": "Mr. Rooter Plumbing of San Francisco", "languageCode": "en" } }, /.../ { "displayName": { "text": "Pipeline Plumbing", "languageCode": "en" } }, { "formattedAddress": "350 Bay St #100-178, San Francisco, CA 94133, USA", "displayName": { "text": "One Source Plumbing and Rooter", "languageCode": "en" } }, /.../ ] }
ระบุจำนวนผลลัพธ์ที่จะแสดงต่อหน้า
ใช้พารามิเตอร์ pageSize เพื่อระบุจำนวนผลลัพธ์ที่จะแสดงต่อหน้า พารามิเตอร์ nextPageToken ในเนื้อหาการตอบกลับจะให้โทเค็นที่ใช้ในการเรียกครั้งต่อๆ ไปเพื่อเข้าถึงหน้าผลลัพธ์ถัดไปได้
ตัวอย่างต่อไปนี้แสดงคำขอ "พิซซ่าในนิวยอร์ก" ที่จำกัดไว้ที่ 5 ผลการค้นหาต่อหน้า
curl -X POST -d '{
"textQuery": "pizza in New York",
"pageSize": 5
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \
-H "X-Goog-FieldMask: places.id,nextPageToken" \
'https://places.googleapis.com/v1/places:searchText'
{ "places": [ { "id": "ChIJifIePKtZwokRVZ-UdRGkZzs" }, { "id": "ChIJPxPd_P1YwokRfzLhSiACEoU" }, { "id": "ChIJrXXKn5NZwokR78g0ipCnY60" }, { "id": "ChIJ6ySICVZYwokR9rIK8HjXhzE" }, { "id": "ChIJ6xvs94VZwokRnT1D2lX2OTw" } ], "nextPageToken": "AeCrKXsZWzNVbPzO-MRWPu52jWO_Xx8aKwOQ69_Je3DxRpfdjClq8Ekwh3UcF2h2Jn75kL6PtWLGV4ecQri-GEUKN_OFpJkdVc-JL4Q" }
หากต้องการเข้าถึงผลลัพธ์หน้าถัดไป ให้ใช้ pageToken เพื่อส่ง nextPageToken ในเนื้อหาคำขอ ดังนี้
curl -X POST -d '{
"textQuery": "pizza in New York",
"pageSize": 5,
"pageToken": "AeCrKXsZWzNVbPzO-MRWPu52jWO_Xx8aKwOQ69_Je3DxRpfdjClq8Ekwh3UcF2h2Jn75kL6PtWLGV4ecQri-GEUKN_OFpJkdVc-JL4Q"
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \
-H "X-Goog-FieldMask: places.id,nextPageToken" \
'https://places.googleapis.com/v1/places:searchText'
{ "places": [ { "id": "ChIJL-LN1N1ZwokR8K2jACu6Ydw" }, { "id": "ChIJjaD94kFZwokR-20CXqlpy_4" }, { "id": "ChIJ6ffdpJNZwokRmcafdROM5q0" }, { "id": "ChIJ8Q2WSpJZwokRQz-bYYgEskM" }, { "id": "ChIJ8164qwFZwokRhplkmhvq1uE" } ], "nextPageToken": "AeCrKXvPd6uUy-oj96W2OaqEe2pUD8QTxOM8-sKfUcFsC9t2Wey5qivrKGoGSxcZnyc7RPmaFfAktslrKbUh31ZDTkL0upRmaxA7c_c" }
รับคำอธิบายที่อยู่
ข้อบ่งชี้ที่อยู่ให้ข้อมูลเชิงสัมพันธ์เกี่ยวกับตำแหน่งของสถานที่ รวมถึงจุดสังเกตใกล้เคียงและพื้นที่ที่อยู่
ตัวอย่างต่อไปนี้แสดงคำขอการค้นหาข้อความ (ใหม่) สำหรับสถานที่ใกล้กับห้างสรรพสินค้าในซานโฮเซ ในตัวอย่างนี้ คุณจะใส่ addressDescriptors ในฟิลด์
mask ดังนี้
curl -X POST -d '{
"textQuery": "clothes",
"maxResultCount": 5,
"locationBias": {
"circle": {
"center": {
"latitude": 37.321328,
"longitude": -121.946275
}
}
},
"rankPreference":"RANK_PREFERENCE_UNSPECIFIED"
}' \
-H 'Content-Type: application/json' \
-H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: places.displayName,places.addressDescriptor" \
https://places.googleapis.com/v1/places:searchText
คำตอบประกอบด้วยสถานที่ที่ระบุในคำขอ รายการสถานที่สำคัญที่อยู่ใกล้เคียง และระยะห่างจากสถานที่นั้น รวมถึงรายการพื้นที่และความสัมพันธ์ ที่ครอบคลุมสถานที่นั้น
{ "places": [ { "displayName": { "text": "Urban Outfitters", "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": 133.72855 }, { "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": 250.99161 }, { "name": "places/ChIJ8WvuSB7Lj4ARFyHppkxDRQ4", "placeId": "ChIJ8WvuSB7Lj4ARFyHppkxDRQ4", "displayName": { "text": "Macy's", "languageCode": "en" }, "types": [ "clothing_store", "department_store", "establishment", "point_of_interest", "store" ], "straightLineDistanceMeters": 116.24196 }, { "name": "places/ChIJ9d3plB_Lj4ARzyaU5bn80WY", "placeId": "ChIJ9d3plB_Lj4ARzyaU5bn80WY", "displayName": { "text": "Bank of America Financial Center", "languageCode": "en" }, "types": [ "bank", "establishment", "finance", "point_of_interest" ], "straightLineDistanceMeters": 121.61515 }, { "name": "places/ChIJaXCjxvXLj4ARCPmQpvJ52Lw", "placeId": "ChIJaXCjxvXLj4ARCPmQpvJ52Lw", "displayName": { "text": "Bloomingdale's", "languageCode": "en" }, "types": [ "clothing_store", "department_store", "establishment", "furniture_store", "home_goods_store", "point_of_interest", "shoe_store", "store" ], "straightLineDistanceMeters": 81.32396 } ], "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" } ] } }, /.../ ] }
ค้นหาธุรกิจที่จะเปิดในอนาคต
ตัวอย่างต่อไปนี้แสดงคำขอการค้นหาข้อความ (ใหม่) สำหรับธุรกิจที่กำลังจะเปิดในอนาคตในนิวมีโดวส์ รัฐไอดาโฮ
curl -X POST \
-H "Content-Type: application/json" \
-H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: places.id,places.displayName,places.businessStatus,places.openingDate" \
-d '{
"textQuery": "Roberts Greenhouse and Tree Farm",
"includeFutureOpeningBusinesses": true,
"maxResultCount": 20,
"locationBias": {
"circle": {
"center": {"latitude": 44.9755100, "longitude": -116.2842180},
"radius": 20
}
}
}' \
"https://places.googleapis.com/v1/places:searchText"
คำตอบจะรวมถึงธุรกิจที่จะเปิดในอนาคต พร้อมด้วย สถานะธุรกิจและวันที่เปิดที่คาดไว้ ดังนี้
{ "places": [ { "id": "ChIJp1-VoKWJplQRMz8g-7Wa3Do", "businessStatus": "FUTURE_OPENING", "displayName": { "text": "Roberts Greenhouse and Tree Farm", "languageCode": "en" }, "openingDate": { "year": 2026, "month": 4, "day": 15 } } ] }
ดูข้อมูลสถานีขนส่ง
คุณใช้การค้นหาข้อความ (ใหม่) เพื่อค้นหาสถานีขนส่งได้ เนื้อหาการตอบกลับ มีข้อมูลเกี่ยวกับสถานี ซึ่งรวมถึงชื่อสถานี บริษัทขนส่งในเครือ และสายรถประจำทางที่ให้บริการในสถานี นอกจากนี้ คำตอบยังมีไอคอนและสีของยานพาหนะที่คุณใช้แสดง ข้อมูลสถานีขนส่งได้ด้วย
ตัวอย่างต่อไปนี้แสดงคำขอสำหรับ "สถานีแกรนด์เซ็นทรัล"
curl -X POST \
-H "Content-Type: application/json" \
-H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: places.id,places.displayName,places.transitStation" \
-d '{
"textQuery": "Grand Central Station"
}' \
"https://places.googleapis.com/v1/places:searchText"
เนื้อหาของการตอบกลับมีข้อมูลเกี่ยวกับสถานีแต่ละแห่งภายในรัศมี สายที่สถานีให้บริการ การแจ้งเตือนที่บริษัทขนส่งออก ณ ป้ายนั้น และข้อมูลการออกเดินทาง
{ "places": [ { "id": "ChIJhRwB-yFawokRi0AhGH87UTc", "displayName": { "text": "Grand Central", "languageCode": "en" }, "transitStation": { "displayName": { "text": "Grand Central", "languageCode": "en" }, "agencies": [ { "displayName": { "text": "Metro-North Railroad", "languageCode": "en" }, "url": "http://www.mta.info/mnr", "lines": [ { "id": "ChIJOXpD29y2wokRryDO0CocwK0", "vehicleType": "HEAVY_RAIL", "displayName": { "text": "Harlem", "languageCode": "en" }, "textColor": "#FFFFFF", "backgroundColor": "#0061AA", "vehicleIcon": { "url": "https://maps.gstatic.com/mapfiles/transit/iw2/svg/rail2.svg" }, "alerts": [ { "effect": "OTHER", "texts": [ { "headline": { "text": "Information", "languageCode": "en" }, "summary": { "text": "Temporary platforms are in place at Botanical Garden, Williams Bridge, and Woodlawn for northbound travel. Build in extra travel time to reach the platform.", "languageCode": "en" }, "fullDescription": { "text": "What's Happening? We are renovating some Harlem Line stations in the Bronx. Learn more about the project here.", "languageCode": "en" } } ], "detailsUrls": [ { "url": "https://new.mta.info/" } ], "cause": "OTHER_CAUSE", "startTime": "2026-04-16T04:00:00Z", "endTime": "2026-12-01T04:45:00Z", "attribution": { "link": { "text": "new.mta.info", "url": "https://new.mta.info/" } }, "createTime": "2026-05-15T22:39:30Z", "severityLevel": "INFO" } ] }, ... ] }, ... ] "stops": [ { "id": "ChIJOfdrigFZwokRJPllLwfPrJY", "location": { "latitude": 40.752823, "longitude": -73.977195999999992 }, "wheelchairAccessibleEntrance": true } ], "departureBoards": [ { "displayType": "TIME_CENTRIC", "rows": [ { "departures": [ { "timedDeparture": { "scheduledTime": "2026-05-15T22:42:00Z", "timingType": "SCHEDULED", "predictedTime": "2026-05-15T22:42:00Z", "updateTime": "2026-05-15T22:38:50Z" }, "originallyScheduledStopId": "ChIJOfdrigFZwokRJPllLwfPrJY", "lineId": "ChIJAfBuQhwg6IkRYnFpClHxFrM" } ] }, ... ] } ] } }, { "id": "ChIJ_4EAi-pZwokRWe5T1JmmWmc", "displayName": { "text": "Grand Central Station", "languageCode": "en" } } ] }
ดูทางเข้าและจุดนำทาง
คุณขอทางเข้าและจุดนำทางสำหรับจุดหมายได้ ทางเข้าจะกำหนดจุดเข้าและออกของสถานที่ (เช่น ประตูต่างๆ ที่สนามบินหรือห้างสรรพสินค้า) จุดนำทางจะกำหนดตำแหน่งริมถนนที่การนำทางควรสิ้นสุด ซึ่งมีประโยชน์ในการนำผู้ใช้ไปยังฝั่งที่ถูกต้องของถนนหรือจุดส่งที่เฉพาะเจาะจง
จุดนำทางจะแสดงผล navigationPointToken คุณสามารถส่งโทเค็นนี้ไปยัง Navigation SDK (พร้อมใช้งานสำหรับ Android หรือ iOS) หรือ Routes API เพื่อนำทางคนขับไปยังสถานที่ตั้งนั้นๆ ดูข้อมูลเพิ่มเติมได้ที่โทเค็นจุดนำทาง
ตัวอย่างต่อไปนี้แสดงคำขอการค้นหาข้อความ (ใหม่) สำหรับ "สนามบินนานาชาติซานฟรานซิสโก" ซึ่งรวม entrances และ navigationPoints ไว้ในมาสก์ฟิลด์
curl -X POST \
-H "Content-Type: application/json" \
-H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: places.id,places.displayName,places.entrances,places.navigationPoints" \
-d '{
"textQuery": "San Francisco International Airport",
"pageSize": 1
}' \
"https://places.googleapis.com/v1/places:searchText"
คำตอบประกอบด้วยทางเข้าและจุดนำทางสำหรับสถานที่
{ "places": [ { "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