วิธีการเรียกเก็บเงินสำหรับ Places API
Places API (ใหม่) และ Places API ใช้รูปแบบการกำหนดราคาแบบจ่ายเมื่อใช้ ระบบจะเรียกเก็บเงินสำหรับ API และ SDK ของ Google Maps Platform ตาม SKU ระบบจะติดตามการใช้งานสำหรับ SKU แต่ละรายการ และ API หรือ SDK หนึ่งๆ อาจมีSKU ของผลิตภัณฑ์มากกว่า 1 รายการ ค่าใช้จ่ายคำนวณโดย
ใช้การกำหนดราคาของเรา และโปรแกรมคำนวณการใช้งานเพื่อประมาณค่าใช้จ่ายในการใช้งานต่อ API หรือ SDK สำหรับ SKU ของ Google Maps Platform ที่มีสิทธิ์ คุณจะได้รับเครดิต Google Maps Platform มูลค่า $200 USD ในแต่ละเดือนสำหรับบัญชีการเรียกเก็บเงินแต่ละบัญชี ระบบจะให้เครดิตนี้โดยอัตโนมัติ ที่ใช้กับ SKU ที่มีคุณสมบัติตามเกณฑ์
ราคาสำหรับ Places API (ใหม่)
เกี่ยวกับฟิลด์มาสก์
สำหรับรายละเอียดสถานที่ (ใหม่) การค้นหาในพื้นที่ใกล้เคียง (ใหม่) และการค้นหาข้อความ (ใหม่) ให้ใช้ส่วนหัว FieldMask
ในคำขอ API เพื่อระบุรายการช่องที่จะแสดงในคำตอบ คุณ
จากนั้นจะเรียกเก็บเงินใน SKU สูงสุดที่เกี่ยวข้องกับคำขอของคุณ ซึ่งหมายความว่าหากคุณเลือกช่องทั้งใน SKU (พื้นฐาน) และ SKU (ขั้นสูง) ระบบจะเรียกเก็บเงินจากคุณตาม SKU (ขั้นสูง)
การใช้การมาสก์สนามเป็นแนวปฏิบัติที่ดีในการออกแบบเพื่อให้แน่ใจว่าคุณไม่ต้องขอ ข้อมูลที่ไม่จำเป็น ซึ่งช่วยหลีกเลี่ยงเวลาในการประมวลผลและการเรียกเก็บเงินที่ไม่จำเป็น
เกี่ยวกับเซสชันการเติมข้อความอัตโนมัติ (ใหม่)
เซสชันการเติมข้อความอัตโนมัติ (ใหม่) จะมีคำขอเติมข้อความอัตโนมัติ (ใหม่) อย่างน้อย 1 รายการ และ คำขอรายละเอียดสถานที่ (ใหม่) หรือคำขอตรวจสอบที่อยู่ ระบบจะส่งโทเค็นเซสชันเดียวกันไปยัง คำขอเติมข้อความอัตโนมัติ (ใหม่) และคำขอรายละเอียดสถานที่ที่ตามมา (ใหม่) หรือการตรวจสอบที่อยู่ อีกครั้ง
เซสชันเริ่มต้นด้วยคําขอเติมข้อความอัตโนมัติ (ใหม่) รายการแรก คำขอรายละเอียดสถานที่ (ใหม่) หรือ จะมีการส่งคำขอตรวจสอบที่อยู่เมื่อผู้ใช้เลือกการเติมข้อความอัตโนมัติ (ใหม่) แนะนำ หากเซสชันถูกหยุดกลางคัน หมายความว่าไม่มีคำขอรายละเอียดสถานที่ (ใหม่) หรือ มีการส่งคำขอตรวจสอบที่อยู่ และระบบจะเรียกเก็บเงินคำขอเติมข้อความอัตโนมัติ (ใหม่) เสมือนว่าไม่มีโทเค็นของเซสชัน ที่ระบุ
หลังจากผู้ใช้เลือกสถานที่ (หมายถึงคำขอรายละเอียดสถานที่ (ใหม่) หรือการตรวจสอบที่อยู่แล้ว ) คุณจะต้องเริ่มเซสชันใหม่โดยใช้โทเค็นเซสชันใหม่
โทเค็นเซสชันใช้ได้กับ 1 เซสชันเท่านั้นและใช้กับเซสชันได้มากกว่า 1 เซสชันไม่ได้ หากคุณใช้โทเค็นเซสชันซ้ำ ระบบจะถือว่าเซสชันไม่ถูกต้องและจะเรียกเก็บเงินสำหรับคำขอราวกับว่าไม่มีการระบุโทเค็นเซสชัน
SKU: คำขอเติมข้อความอัตโนมัติ
SKU ของคำขอเติมข้อความอัตโนมัติจะคิดค่าบริการสำหรับคำขอแต่ละรายการที่ส่งไปยัง API เติมข้อความอัตโนมัติ (ใหม่) ที่ไม่มีโทเค็นเซสชัน
นอกจากนี้จะมีการเรียกเก็บเงินหากคุณใช้โทเค็นเซสชันและ
- สิ้นสุดเซสชันโดยคำขอเดียวไปยังรายละเอียดสถานที่ (ใหม่) ที่
ขอฟิลด์ใดๆ ที่กำหนดโดย SKU: รายละเอียดสถานที่ (สถานที่เท่านั้น)
- ระบบจะเรียกเก็บเงินสำหรับคำขอ Autocomplete (ใหม่) แต่ละรายการไม่เกิน 12 รายการโดยใช้ SKU: คำขอ Autocomplete
- คำขอเติมข้อความอัตโนมัติ (ใหม่) ที่ตามมาแต่ละรายการจะถูกเรียกเก็บเงินโดยใช้ SKU: การใช้เซสชันการเติมข้อความอัตโนมัติ
- ยกเลิกเซสชันหรือจบเซสชันโดยโทรหา SKU: รายละเอียดสถานที่ (รหัสเท่านั้น) จากนั้นระบบจะเรียกเก็บเงินสำหรับคำขอเติมข้อความอัตโนมัติ (ใหม่) ทั้งหมด โดยใช้ SKU: คำขอเติมข้อความอัตโนมัติ
ระดับการใช้งานรายเดือน (ราคาต่อสาย) |
||
---|---|---|
0.00283 USD ต่อ แต่ละรายการ (2.83 USD ต่อ 1,000 รายการ) |
0.00227 USD ต่อ แต่ละรายการ (2.27 USD ต่อ 1,000 รายการ) |
ติดต่อฝ่ายขายเพื่อสอบถามราคาสำหรับการใช้งานจำนวนมาก |
SKU: การใช้เซสชันการเติมข้อความอัตโนมัติ
SKU สำหรับเติมข้อความอัตโนมัติในการใช้งานเซสชันจะถูกเรียกเก็บเงินสำหรับคำขอแต่ละรายการที่ส่งไปยัง API เติมข้อความอัตโนมัติ (ใหม่) ที่มีโทเค็นเซสชัน
ระบบจะเรียกเก็บเงิน SKU นี้ในสถานการณ์ต่อไปนี้
เซสชันการเติมข้อความอัตโนมัติสิ้นสุดลงด้วยการเรียกใช้ SKU: รายละเอียดสถานที่ (ตำแหน่งเท่านั้น)
- คำขอเติมข้อความอัตโนมัติ (ใหม่) แต่ละรายการ มีการเรียกเก็บเงินสูงสุด 12 คำขอโดยใช้ SKU: คำขอเติมข้อความอัตโนมัติ
- ระบบจะเรียกเก็บเงินสำหรับคำขอการเติมข้อความอัตโนมัติ (ใหม่) แต่ละรายการที่ใช้ภายหลังโดยใช้ SKU: การใช้งานเซสชันการเติมข้อความอัตโนมัติ
เซสชันการเติมข้อความอัตโนมัติสิ้นสุดโดยมีการเรียกไปที่ SKU: รายละเอียดสถานที่ (พื้นฐาน ขั้นสูง หรือที่ต้องการ)
การเรียกใช้รายละเอียดสถานที่ที่ขอช่องใดก็ได้จาก SKU: รายละเอียดสถานที่ (พื้นฐาน ขั้นสูง หรือแนะนำ) จะเรียกเก็บเงินใน SKU: รายละเอียดสถานที่ (แนะนำ)
เซสชันการเติมข้อความอัตโนมัติสิ้นสุดโดยมีการเรียกไปยัง SKU: การตรวจสอบที่อยู่ แนะนำ
สำหรับข้อมูลเพิ่มเติม โปรดดู เติมข้อความอัตโนมัติ (ใหม่) และราคาเซสชัน
ระดับการใช้งานรายเดือน (ราคาต่อสาย) |
||
---|---|---|
0.00 USD ต่อแต่ละรายการ (0.00 USD ต่อ 1,000) |
0.00 USD ต่อแต่ละรายการ (0.00 USD ต่อ 1,000) |
0.00 USD ต่อ รายการ (0.00 USD ต่อ 1,000 รายการ) |
SKU: รายละเอียดสถานที่ (รหัสเท่านั้น)
การใช้มาสก์ของช่องหรือรายการฟิลด์ในคำขอรายละเอียดสถานที่ (ใหม่) คุณสามารถจำกัด ตอบกลับเฉพาะฟิลด์ที่ระบุ SKU นี้จะทริกเกอร์เมื่อคุณขอเฉพาะช่องต่อไปนี้
เว็บเซอร์วิส:
attributions
,
id
,
name
*,
photos
* ช่อง name
มีชื่อทรัพยากรสถานที่ในรูปแบบ places/PLACE_ID
ใช้ displayName
เพื่อเข้าถึงชื่อข้อความของสถ านที่
ระดับการใช้งานรายเดือน (ราคาต่อสาย) |
||
---|---|---|
0.0 USD ต่อ รายการ (0.00 USD ต่อ 1,000 รายการ) |
0.0 USD ต่อ รายการ (0.00 USD ต่อ 1,000 รายการ) |
0.0 USD ต่อแต่ละ (0.00 USD ต่อ 1,000) |
SKU: รายละเอียดสถานที่ (สถานที่ตั้งเท่านั้น)
การใช้มาสก์ของช่องหรือรายการฟิลด์ในคำขอรายละเอียดสถานที่ (ใหม่) คุณสามารถจำกัด ตอบกลับเฉพาะฟิลด์ที่ระบุ ช่วงเวลานี้ SKU จะทริกเกอร์เมื่อคุณขอช่องต่อไปนี้เท่านั้น
เว็บเซอร์วิส:
addressComponents
,
adrFormatAddress
,
formattedAddress
,
location
,
plusCode
,
shortFormattedAddress
,
types
,
viewport
ช่วงระดับเสียงรายเดือน (ราคาสำหรับการโทรหนึ่งครั้ง) |
||
---|---|---|
0.005 USD ต่อ แต่ละรายการ (5.00 USD ต่อ 1,000 รายการ) |
0.004 USD ต่อ แต่ละรายการ (4.00 USD ต่อ 1,000 รายการ) |
ติดต่อฝ่ายขายเพื่อขอข้อมูลราคาปริมาณ |
SKU: รายละเอียดสถานที่ (พื้นฐาน)
การใช้มาสก์ของช่องหรือรายการฟิลด์ในคำขอรายละเอียดสถานที่ (ใหม่) คุณสามารถจำกัด ตอบกลับเฉพาะฟิลด์ที่ระบุ ช่วงเวลานี้ SKU จะทริกเกอร์เมื่อคุณขอช่องต่อไปนี้เท่านั้น
เว็บเซอร์วิส:
accessibilityOptions
,
businessStatus
,
displayName
,
googleMapsUri
,
iconBackgroundColor
,
iconMaskBaseUri
,
primaryType
,
primaryTypeDisplayName
,
subDestinations
,
utcOffsetMinutes
ถ้าเซสชันการเติมข้อความอัตโนมัติสิ้นสุดลงด้วยการเรียกรายละเอียดสถานที่ จะส่งคำขอช่องใดก็ได้จาก SKU: รายละเอียดสถานที่ (พื้นฐาน ขั้นสูง หรือที่ต้องการ) การโทรจะเรียกเก็บเงินที่ SKU: รายละเอียดสถานที่ (แนะนำ) ดูข้อมูลเพิ่มเติมได้ที่ SKU: การใช้งานเซสชันการเติมข้อความอัตโนมัติ
ระดับการใช้งานรายเดือน (ราคาต่อสาย) |
||
---|---|---|
0.0170 USD ต่อแต่ละรายการ (17.00 USD ต่อ 1,000) |
0.0136 USD ต่อแต่ละรายการ (13.60 USD ต่อ 1,000) |
ติดต่อฝ่ายขายเพื่อขอข้อมูลราคาปริมาณ |
SKU: รายละเอียดสถานที่ (ขั้นสูง)
การใช้มาสก์ฟิลด์หรือรายการฟิลด์ในคำขอรายละเอียดสถานที่ (ใหม่) จะช่วยให้คุณจำกัดการตอบกลับให้แสดงเฉพาะฟิลด์ที่ระบุได้ ช่วงเวลานี้ SKU จะทริกเกอร์เมื่อคุณขอช่องต่อไปนี้เท่านั้น
เว็บเซอร์วิส:
currentOpeningHours
,
currentSecondaryOpeningHours
,
internationalPhoneNumber
,
nationalPhoneNumber
,
priceLevel
,
rating
,
regularOpeningHours
,
regularSecondaryOpeningHours
,
userRatingCount
,
websiteUri
หากเซสชันการเติมข้อความอัตโนมัติสิ้นสุดลงด้วยการเรียกใช้รายละเอียดสถานที่ที่ขอช่องใดก็ได้จาก SKU: รายละเอียดสถานที่ (พื้นฐาน ขั้นสูง หรือแนะนำ) ระบบจะเรียกเก็บเงินการเรียกใช้ดังกล่าวใน SKU: รายละเอียดสถานที่ (แนะนำ) สำหรับข้อมูลเพิ่มเติม โปรดดู SKU: การใช้เซสชันการเติมข้อความอัตโนมัติ
ช่วงระดับเสียงรายเดือน (ราคาสำหรับการโทรหนึ่งครั้ง) |
||
---|---|---|
0.020 USD ต่อแต่ละรายการ (20.00 USD ต่อ 1,000) |
0.016 USD ต่อ แต่ละรายการ (16.00 USD ต่อ 1,000 รายการ) |
ติดต่อฝ่ายขายเพื่อสอบถามราคาสำหรับการใช้งานจำนวนมาก |
SKU: รายละเอียดสถานที่ (แนะนำ)
การใช้มาสก์ของช่องหรือรายการฟิลด์ในคำขอรายละเอียดสถานที่ (ใหม่) คุณสามารถจำกัด ตอบกลับเฉพาะฟิลด์ที่ระบุ ช่วงเวลานี้ SKU จะทริกเกอร์เมื่อคุณขอช่องต่อไปนี้เท่านั้น
บริการผ่านเว็บ:
allowsDogs
curbsidePickup
delivery
dineIn
editorialSummary
evChargeOptions
,
fuelOptions
,
goodForChildren
,
goodForGroups
,
goodForWatchingSports
,
liveMusic
,
menuForChildren
,
parkingOptions
,
paymentOptions
,
outdoorSeating
,
reservable
,
restroom
,
reviews
,
routingSummaries
,*
servesBeer
,
servesBreakfast
,
servesBrunch
,
servesCocktails
,
servesCoffee
,
servesDessert
,
servesDinner
,
servesLunch
,
servesVegetarianFood
,
servesWine
,
takeout
* การค้นหาข้อความและการค้นหาใกล้เคียงเท่านั้น
หากเซสชันการเติมข้อความอัตโนมัติสิ้นสุดลงด้วยการเรียกใช้รายละเอียดสถานที่ที่ขอช่องใดก็ได้จาก SKU: รายละเอียดสถานที่ (พื้นฐาน ขั้นสูง หรือแนะนำ) ระบบจะเรียกเก็บเงินการเรียกใช้ดังกล่าวใน SKU: รายละเอียดสถานที่ (แนะนำ) ดูข้อมูลเพิ่มเติมได้ที่ SKU: การใช้งานเซสชันการเติมข้อความอัตโนมัติ
ระดับการใช้งานรายเดือน (ราคาต่อสาย) |
||
---|---|---|
0.025 USD ต่อแต่ละรายการ (25.00 USD ต่อ 1,000) |
0.020 USD ต่อแต่ละรายการ (20.00 USD ต่อ 1,000) |
ติดต่อฝ่ายขายเพื่อสอบถามราคาสำหรับการใช้งานจำนวนมาก |
SKU: การค้นหาใกล้เคียง (พื้นฐาน)
การใช้มาสก์ช่องหรือรายการช่องในคำขอการค้นหาในพื้นที่ใกล้เคียง (ใหม่) จะช่วยให้คุณจำกัดการตอบกลับให้มีเฉพาะช่องที่ระบุเท่านั้น SKU นี้จะทริกเกอร์เมื่อคุณขอเฉพาะช่องต่อไปนี้
เว็บเซอร์วิส:
places.accessibilityOptions
,
places.addressComponents
,
places.adrFormatAddress
,
places.attributions
,
places.businessStatus
,
places.displayName
,
places.formattedAddress
,
places.googleMapsUri
,
places.iconBackgroundColor
,
places.iconMaskBaseUri
,
places.id
,
places.location
,
places.name
*,
places.photos
,
places.plusCode
,
places.primaryType
,
places.primaryTypeDisplayName
,
places.shortFormattedAddress
,
places.subDestinations
,
places.types
,
places.utcOffsetMinutes
,
places.viewport
* ช่อง places.name
มีชื่อทรัพยากรสถานที่ในรูปแบบ places/PLACE_ID
ใช้ places.displayName
เพื่อเข้าถึงชื่อข้อความของสถ านที่
ระดับการใช้งานรายเดือน (ราคาต่อสาย) |
||
---|---|---|
0.032 USD ต่อ แต่ละรายการ (32.00 USD ต่อ 1,000 รายการ) |
0.0256 USD ต่อ แต่ละรายการ (25.60 USD ต่อ 1,000 รายการ) |
ติดต่อฝ่ายขายเพื่อขอข้อมูลราคาปริมาณ |
SKU: การค้นหาใกล้เคียง (ขั้นสูง)
การใช้มาสก์ช่องหรือรายการช่องในคำขอการค้นหาในพื้นที่ใกล้เคียง (ใหม่) จะช่วยให้คุณจำกัดการตอบกลับให้มีเฉพาะช่องที่ระบุเท่านั้น ช่วงเวลานี้ SKU จะทริกเกอร์เมื่อคุณขอช่องต่อไปนี้เท่านั้น
บริการผ่านเว็บ:
places.currentOpeningHours
places.currentSecondaryOpeningHours
places.internationalPhoneNumber
places.nationalPhoneNumber
places.priceLevel
places.rating
,
places.regularOpeningHours
,
places.regularSecondaryOpeningHours
,
places.userRatingCount
,
places.websiteUri
ระดับการใช้งานรายเดือน (ราคาต่อสาย) |
||
---|---|---|
0.035 USD ต่อ แต่ละรายการ (35.00 USD ต่อ 1,000 รายการ) |
0.028 USD ต่อแต่ละรายการ (28.00 USD ต่อ 1,000) |
ติดต่อฝ่ายขายเพื่อสอบถามราคาสำหรับการใช้งานจำนวนมาก |
SKU: การค้นหาใกล้เคียง (แนะนำ)
การใช้มาสก์ช่องหรือรายการช่องในคำขอการค้นหาในพื้นที่ใกล้เคียง (ใหม่) จะช่วยให้คุณจำกัดการตอบกลับให้มีเฉพาะช่องที่ระบุเท่านั้น SKU นี้จะทริกเกอร์เมื่อคุณขอเฉพาะช่องต่อไปนี้
บริการผ่านเว็บ:
places.allowsDogs
places.curbsidePickup
places.delivery
places.dineIn
places.editorialSummary
places.evChargeOptions
,
places.fuelOptions
,
places.goodForChildren
,
places.goodForGroups
,
places.goodForWatchingSports
,
places.liveMusic
,
places.menuForChildren
,
places.parkingOptions
,
places.paymentOptions
,
places.outdoorSeating
,
places.reservable
,
places.restroom
,
places.reviews
,
places.routingSummaries
,*
places.servesBeer
,
places.servesBreakfast
,
places.servesBrunch
,
places.servesCocktails
,
places.servesCoffee
,
places.servesDessert
,
places.servesDinner
,
places.servesLunch
,
places.servesVegetarianFood
,
places.servesWine
,
places.takeout
* การค้นหาข้อความและการค้นหาใกล้เคียงเท่านั้น
ระดับการใช้งานรายเดือน (ราคาต่อสาย) |
||
---|---|---|
0.040 USD ต่อ แต่ละรายการ (40.00 USD ต่อ 1,000 รายการ) |
0.032 USD ต่อแต่ละรายการ (32.00 USD ต่อ 1,000) |
ติดต่อฝ่ายขายเพื่อขอข้อมูลราคาปริมาณ |
SKU: การค้นหาข้อความ (รหัสเท่านั้น)
การใช้มาสก์ฟิลด์หรือรายการฟิลด์ในคำขอการค้นหาข้อความ (ใหม่) จะช่วยให้คุณจำกัดการตอบกลับให้แสดงเฉพาะฟิลด์ที่ระบุได้ ช่วงเวลานี้ SKU จะทริกเกอร์เมื่อคุณขอช่องต่อไปนี้เท่านั้น
เว็บเซอร์วิส:
places.attributions
,
places.id
,
places.name
*,
nextPageToken
* ช่อง places.name
มีชื่อทรัพยากรสถานที่ในรูปแบบ places/PLACE_ID
ใช้ places.displayName
เพื่อเข้าถึงชื่อข้อความของสถ านที่
ช่วงระดับเสียงรายเดือน (ราคาสำหรับการโทรหนึ่งครั้ง) |
||
---|---|---|
0.0 USD ต่อ รายการ (0.00 USD ต่อ 1,000 รายการ) |
0.0 USD ต่อ รายการ (0.00 USD ต่อ 1,000 รายการ) |
0.0 USD ต่อแต่ละ (0.00 USD ต่อ 1,000) |
SKU: การค้นหาข้อความ (พื้นฐาน)
การใช้มาสก์ฟิลด์หรือรายการฟิลด์ในคำขอการค้นหาข้อความ (ใหม่) จะช่วยให้คุณจำกัดการตอบกลับให้แสดงเฉพาะฟิลด์ที่ระบุได้ SKU นี้จะทริกเกอร์เมื่อคุณขอเฉพาะช่องต่อไปนี้
บริการผ่านเว็บ:
places.accessibilityOptions
places.addressComponents
places.adrFormatAddress
places.businessStatus
places.displayName
places.formattedAddress
,
places.googleMapsUri
,
places.iconBackgroundColor
,
places.iconMaskBaseUri
,
places.location
,
places.photos
,
places.plusCode
,
places.primaryType
,
places.primaryTypeDisplayName
,
places.shortFormattedAddress
,
places.subDestinations
,
places.types
,
places.utcOffsetMinutes
,
places.viewport
ช่วงระดับเสียงรายเดือน (ราคาสำหรับการโทรหนึ่งครั้ง) |
||
---|---|---|
0.032 USD ต่อ แต่ละรายการ (32.00 USD ต่อ 1,000 รายการ) |
0.0256 USD ต่อ แต่ละรายการ (25.60 USD ต่อ 1,000 รายการ) |
ติดต่อฝ่ายขายเพื่อสอบถามราคาสำหรับการใช้งานจำนวนมาก |
SKU: การค้นหาข้อความ (ขั้นสูง)
เมื่อใช้มาสก์ของช่องหรือรายการช่องในคำขอค้นหาข้อความ (ใหม่) คุณจะจำกัด ตอบกลับเฉพาะฟิลด์ที่ระบุ SKU นี้จะทริกเกอร์เมื่อคุณขอเฉพาะช่องต่อไปนี้
บริการผ่านเว็บ:
places.currentOpeningHours
places.currentSecondaryOpeningHours
places.internationalPhoneNumber
places.nationalPhoneNumber
places.priceLevel
places.rating
,
places.regularOpeningHours
,
places.regularSecondaryOpeningHours
,
places.userRatingCount
,
places.websiteUri
ระดับการใช้งานรายเดือน (ราคาต่อสาย) |
||
---|---|---|
0.035 USD ต่อ แต่ละรายการ (35.00 USD ต่อ 1,000 รายการ) |
0.028 USD ต่อแต่ละรายการ (28.00 USD ต่อ 1,000) |
ติดต่อฝ่ายขายเพื่อสอบถามราคาสำหรับการใช้งานจำนวนมาก |
SKU: การค้นหาข้อความ (แนะนำ)
การใช้มาสก์ฟิลด์หรือรายการฟิลด์ในคำขอการค้นหาข้อความ (ใหม่) จะช่วยให้คุณจำกัดการตอบกลับให้แสดงเฉพาะฟิลด์ที่ระบุได้ ช่วงเวลานี้ SKU จะทริกเกอร์เมื่อคุณขอช่องต่อไปนี้เท่านั้น
บริการผ่านเว็บ:
places.allowsDogs
places.curbsidePickup
places.delivery
places.dineIn
places.editorialSummary
places.evChargeOptions
,
places.fuelOptions
,
places.goodForChildren
,
places.goodForGroups
,
places.goodForWatchingSports
,
places.liveMusic
,
places.menuForChildren
,
places.parkingOptions
,
places.paymentOptions
,
places.outdoorSeating
,
places.reservable
,
places.restroom
,
places.reviews
,
places.routingSummaries
,*
places.servesBeer
,
places.servesBreakfast
,
places.servesBrunch
,
places.servesCocktails
,
places.servesCoffee
,
places.servesDessert
,
places.servesDinner
,
places.servesLunch
,
places.servesVegetarianFood
,
places.servesWine
,
places.takeout
* การค้นหาข้อความและการค้นหาใกล้เคียงเท่านั้น
ระดับการใช้งานรายเดือน (ราคาต่อสาย) |
||
---|---|---|
0.040 USD ต่อ แต่ละรายการ (40.00 USD ต่อ 1,000 รายการ) |
0.032 USD ต่อ แต่ละรายการ (32.00 USD ต่อ 1,000 รายการ) |
ติดต่อฝ่ายขายเพื่อขอข้อมูลราคาปริมาณ |
SKU: รูปภาพสถานที่
ระบบจะเรียกเก็บเงินสำหรับ SKU Place Photo สำหรับคำขอไปยัง API แต่ละรายการ
ระดับการใช้งานรายเดือน (ราคาต่อสาย) |
||
---|---|---|
0.007 USD ต่อ แต่ละรายการ (7.00 USD ต่อ 1,000 รายการ) |
0.0056 USD ต่อ แต่ละรายการ (5.60 USD ต่อ 1,000 รายการ) |
ติดต่อฝ่ายขายเพื่อสอบถามราคาสำหรับการใช้งานจำนวนมาก |
ราคาสำหรับ Places API
เกี่ยวกับเซสชันที่เติมข้อความอัตโนมัติ
เซสชันการเติมข้อความอัตโนมัติจะมีคำขอการเติมข้อความอัตโนมัติบางรายการ (เพื่อดึงข้อมูลคำแนะนำเกี่ยวกับสถานที่ในขณะที่ผู้ใช้พิมพ์) และคำขอรายละเอียดสถานที่ไม่เกิน 1 รายการ (เพื่อดึงรายละเอียดเกี่ยวกับสถานที่ที่ผู้ใช้เลือก) ระบบจะส่งโทเค็นเซสชันเดียวกันไปยังฟีเจอร์เติมข้อความอัตโนมัติและคําขอรายละเอียดสถานที่ต่อๆ ไป เซสชันเริ่มต้นด้วย คำขอเติมข้อความอัตโนมัติแรก (ซึ่ง มักจะเกิดขึ้นเมื่อผู้ใช้เริ่มพิมพ์) จะมีการเรียกรายละเอียดสถานที่เมื่อผู้ใช้ ได้เลือกคำแนะนำในการเติมข้อความอัตโนมัติไว้รายการใดรายการหนึ่ง หากผู้ใช้ไม่เลือกคำแนะนำ ระบบจะไม่เรียกใช้รายละเอียดสถานที่
หลังจากผู้ใช้เลือกสถานที่แล้ว (เช่น มีการเรียกรายละเอียดสถานที่) คุณต้องเริ่ม โดยใช้โทเค็นเซสชันใหม่
คุณสามารถสร้างเซสชันการเติมข้อความอัตโนมัติจาก API ต่อไปนี้
- บริการเติมข้อความอัตโนมัติเกี่ยวกับสถานที่ API ของ Places หรือ บริการเติมข้อความอัตโนมัติใน Places ของ Maps JavaScript API คุณต้องออกแบบ แอปพลิเคชันที่จะให้โทเค็นเซสชัน (คุณอาจต้องเปลี่ยนโค้ดที่มีอยู่)
- วิดเจ็ตการเติมข้อความอัตโนมัติของ Maps JavaScript API ระบบจะเปิดใช้การเรียกเก็บเงินตามเซสชันโดยอัตโนมัติในวิดเจ็ตเหล่านั้น โดยที่คุณไม่ต้องเปลี่ยนแปลงโค้ดใดๆ
โทเค็นเซสชันเหมาะสำหรับเซสชันผู้ใช้ 1 รายและไม่ควรใช้กับผู้ใช้มากกว่า 1 ราย เซสชัน หากคุณใช้โทเค็นเซสชันซ้ำ ระบบจะถือว่าเซสชันไม่ถูกต้องและจะเรียกเก็บเงินสำหรับคำขอราวกับว่าไม่มีการระบุโทเค็นเซสชัน
การเรียกเก็บเงินจากคำขอเติมข้อความอัตโนมัติและคำขอรายละเอียดสถานที่ที่ใช้เซสชัน SKU ต่างๆ
เกี่ยวกับ SKU ข้อมูลสถานที่
SKU ข้อมูลสถานที่ 3 รายการ ได้แก่ ข้อมูลพื้นฐาน ข้อมูลรายชื่อติดต่อและข้อมูลบรรยากาศมีการเรียก SKU ข้อมูลอย่างน้อย 1 รายการสำหรับรายการต่อไปนี้
- Android: คำขอแต่ละรายการไปยัง
fetchPlace()
หรือfindCurrentPlace()
- iOS: การโทรมาที่
fetchPlaceFromPlaceID:
หรือfindPlaceLikelihoodsFromCurrentLocationWithPlaceFields:
แต่ละครั้ง - บริการผ่านเว็บ: คำขอ Places แต่ละรายการขึ้นอยู่กับช่องที่ระบุไว้ในคำขอ
SKU ข้อมูลจะมีการเรียกเก็บเงินเสมอนอกเหนือจาก SKU พื้นฐานสำหรับการทริกเกอร์คำขอ ให้พวกเขา ตัวอย่างเช่น คำขอรายละเอียดสถานที่ซึ่งรวมถึงฟิลด์ข้อมูลพื้นฐานจะเรียกเก็บเงินภายใต้ SKU สำหรับข้อมูลพื้นฐานและ SKU รายละเอียดสถานที่
สำหรับบริการบนเว็บ API ของ Places เหล่านี้จะเรียกใช้การสนับสนุนที่ระบุฟิลด์ข้อมูลที่จะแสดง:
สำหรับบริการบนเว็บ การเรียก Places API เหล่านี้ไม่รองรับการระบุข้อผิดพลาด ด้วย การเรียกเหล่านี้จะส่งคืนข้อมูล Places ทั้งหมดเสมอ โดยเรียกเก็บเงิน SKU ข้อมูล Places ทั้งสามใน เพิ่มเติมจากการเรียกเก็บเงินสำหรับคำขอ API แต่ละรายการ:
SKU: ข้อมูลพื้นฐาน
การใช้พารามิเตอร์ฟิลด์ในรายละเอียดสถานที่หรือคำขอค้นหาสถานที่ คุณสามารถจำกัด ตอบกลับเฉพาะฟิลด์ที่ระบุ ช่องในหมวดหมู่พื้นฐานจะรวมอยู่ในต้นทุนฐานของคำขอ Places และไม่มีค่าใช้จ่ายเพิ่มเติม SKU ข้อมูลพื้นฐานจะทริกเกอร์เมื่อมีการขอฟิลด์ใดฟิลด์หนึ่งต่อไปนี้
-
Android
Place.Field.ACCESSIBILITY_OPTIONS
Place.Field.ADDRESS_COMPONENTS
Place.Field.BUSINESS_STATUS
Place.Field.DISPLAY_NAME
Place.Field.FORMATTED_ADDRESS
Place.Field.ICON_BACKGROUND_COLOR
,Place.Field.ICON_MASK_URL
,Place.Field.ID
,Place.Field.LOCATION
,Place.Field.PHOTO_METADATAS
,Place.Field.PLUS_CODE
,Place.Field.TYPES
Place.Field.VIEWPORT
หรือPlace.Field.UTC_OFFSET
-
iOS:
GMSPlaceFieldFormattedAddress
,GMSPlaceFieldBusinessStatus
,GMSPlaceFieldID
,GMSPlaceFieldCoordinate
,GMSPlaceFieldName
,GMSPlaceFieldPhotos
,GMSPlaceFieldPlusCode
,GMSPlaceFieldTypes
หรือGMSPlaceFieldViewport
-
บริการผ่านเว็บ:
address_component
,adr_address
business_status
formatted_address
,geometry
,icon
name
,permanently_closed
,photo
place_id
,plus_code
,type
,url
,utc_offset
,vicinity
หรือwheelchair_accessible_entrance
ระดับการใช้งานรายเดือน (ราคาต่อสาย) |
||
---|---|---|
ค่าขอสถานที่ + 0.00 USD |
ค่าขอสถานที่ + 0.00 USD |
ค่าขอสถานที่ + 0.00 USD |
SKU: ข้อมูลติดต่อ
ใช้พารามิเตอร์ช่องในรายละเอียดสถานที่หรือส่งคำขอค้นหาสถานที่สำหรับบริการผ่านเว็บ หรือ
อาร์เรย์ของ Place.Field
สำหรับ Android หรือ iOS คุณสามารถ
จำกัดการตอบสนองไว้เฉพาะฟิลด์ที่ระบุ ช่องในหมวดหมู่รายชื่อติดต่อจะทำให้เกิดการเรียกเก็บเงินเพิ่มเติม ระบบจะเรียกใช้ SKU ข้อมูลติดต่อเมื่อมีการขอฟิลด์ใดฟิลด์หนึ่งต่อไปนี้
-
Android:
Place.Field.CURRENT_OPENING_HOURS
,Place.Field.INTERNATIONAL_PHONE_NUMBER
,Place.Field.OPENING_HOURS
,Place.Field.SECONDARY_OPENING_HOURS
หรือPlace.Field.WEBSITE_URI
-
iOS:
GMSPlaceFieldOpeningHours
GMSPlaceFieldPhoneNumber
หรือGMSPlaceFieldWebsite
-
บริการผ่านเว็บ:
formatted_phone_number
,international_phone_number
opening_hours
current_opening_hours
,secondary_opening_hours
หรือwebsite
ช่วงระดับเสียงรายเดือน (ราคาสำหรับการโทรหนึ่งครั้ง) |
||
---|---|---|
ค่าขอสถานที่ + 0.003 USD ต่อรายการ (+ 3.00 USD ต่อ 1,000 รายการ) |
ค่าใช้จ่ายคำขอเกี่ยวกับสถานที่ + 0.0024 USD ต่อแต่ละรายการ (+ 2.40 USD ต่อ 1,000) |
ติดต่อฝ่ายขายเพื่อสอบถามราคาสำหรับการใช้งานจำนวนมาก |
SKU: ข้อมูลบรรยากาศ
การใช้พารามิเตอร์ฟิลด์ในรายละเอียดสถานที่หรือคำขอค้นหาสถานที่ ทำให้คุณสามารถ จำกัดการตอบสนองไว้เฉพาะฟิลด์ที่ระบุ ทุ่งในบรรยากาศ ทำให้มีการเรียกเก็บเงินเพิ่ม ระบบจะทริกเกอร์ SKU ข้อมูลบรรยากาศเมื่อมีการขอฟิลด์ใดฟิลด์หนึ่งต่อไปนี้
- Android:
Place.Field.CURBSIDE_PICKUP
,Place.Field.DELIVERY
,Place.Field.EDITORIAL_SUMMARY
Place.Field.DINE_IN
,Place.Field.PRICE_LEVEL
,Place.Field.RATING
Place.Field.RESERVABLE
,Place.Field.SERVES_BEER
,Place.Field.SERVES_BREAKFAST
Place.Field.SERVES_BRUNCH
,Place.Field.SERVES_DINNER
Place.Field.SERVES_LUNCH
,Place.Field.SERVES_VEGETARIAN_FOOD
Place.Field.SERVES_WINE
,Place.Field.TAKEOUT
หรือPlace.Field.USER_RATING_COUNT
- iOS:
GMSPlaceFieldPriceLevel
,GMSPlaceFieldRating
,GMSPlaceFieldUserRatingsTotal
,GMSPlaceFieldTakeout
,GMSPlaceFieldDelivery
,GMSPlaceFieldDineIn
,GMSPlaceFieldCurbsidePickup
,GMSPlaceFieldReservable
,GMSPlaceFieldServesBreakfast
,GMSPlaceFieldServesLunch
,GMSPlaceFieldServesDinner
,GMSPlaceFieldServesBeer
,GMSPlaceFieldServesWine
,GMSPlaceFieldServesBrunch
หรือGMSPlaceFieldServesVegetarianFood
- JavaScript: ดูช่อง (รายละเอียดสถานที่)
- บริการผ่านเว็บ:
curbside_pickup
,delivery
,dine_in
editorial_summary
,price_level
,rating
,reservable
reviews
,serves_beer
,serves_breakfast
,serves_brunch
serves_dinner
,serves_lunch
,serves_vegetarian_food
,serves_wine
takeout
หรือuser_ratings_total
ช่วงระดับเสียงรายเดือน (ราคาสำหรับการโทรหนึ่งครั้ง) |
||
---|---|---|
ค่าใช้จ่ายคำขอเกี่ยวกับสถานที่ + 0.005 USD ต่อแต่ละรายการ (+ 5.00 USD ต่อ 1,000) |
ค่าคำขอสถานที่ + 0.004 USD ต่อรายการ (+ 4.00 USD ต่อ 1,000 รายการ) |
ติดต่อฝ่ายขายเพื่อสอบถามราคาสำหรับการใช้งานจำนวนมาก |
SKU: เติมข้อความอัตโนมัติ – ตามคำขอ
ระบบจะเรียกเก็บเงิน SKU เติมข้อความอัตโนมัติ – ตามคำขอ สำหรับการโทรเหล่านี้หรือ คำขอที่ไม่มีโทเค็นเซสชัน
- Android
findAutocompletePredictions()
- iOS
findAutocompletePredictionsFromQuery:
- JavaScript: บริการเติมข้อความอัตโนมัติเกี่ยวกับสถานที่ของ Maps JavaScript API
- บริการผ่านเว็บ: บริการ Autocomplete สถานที่ของ Places API
การเรียกที่เกิดจากเซสชันการเติมข้อความอัตโนมัติที่ไม่ถูกต้อง (เช่น เซสชันที่ใช้โทเค็นเซสชันซ้ำ) จะมีการเรียกเก็บเงินสำหรับการเติมข้อความอัตโนมัติตาม SKU ตามคำขอด้วย
คำขอเติมข้อความอัตโนมัติจาก Maps JavaScript API อาจมีการเรียกเก็บเงินสำหรับวิดเจ็ตเติมข้อความอัตโนมัติเกี่ยวกับสถานที่แบบเติมข้อความอัตโนมัติ ตาม SKU คำขอในกรณีที่มีการโทร จากเซสชันการเติมข้อความอัตโนมัติที่ไม่ถูกต้อง กรณีนี้อาจเกิดขึ้นเมื่อผู้ใช้พิมพ์ที่อยู่หลายรายการที่แตกต่างกัน หรือคัดลอก/วางที่อยู่ต่างๆ ลงในวิดเจ็ต และไม่ได้เลือกการคาดคะเนการเติมข้อความอัตโนมัติเสมอไป
ปริมาณรายเดือน (ราคาต่อคำขอ) |
||
---|---|---|
0.00283 USD ต่อ แต่ละรายการ (2.83 USD ต่อ 1,000 รายการ) |
0.00227 USD ต่อ แต่ละรายการ (2.27 USD ต่อ 1,000 รายการ) |
ติดต่อฝ่ายขายเพื่อสอบถามราคาสำหรับการใช้งานจำนวนมาก |
SKU: เติมข้อความอัตโนมัติโดยไม่มีรายละเอียดสถานที่ – ต่อเซสชัน
SKU ที่เติมข้อความอัตโนมัติโดยไม่มีรายละเอียดสถานที่ – ต่อเซสชันจะคิดค่าบริการเป็น เติมข้อความอัตโนมัติในเซสชัน ไม่รวมถึงคำขอรายละเอียดสถานที่ (ภายในไม่กี่นาทีเมื่อเริ่ม ของเซสชัน)
ช่วงระดับเสียงรายเดือน (ราคาต่อ SESSION) |
||
---|---|---|
0.017 USD ต่อแต่ละรายการ (17.00 USD ต่อ 1,000) |
0.0136 USD ต่อ แต่ละรายการ (13.60 USD ต่อ 1,000 รายการ) |
ติดต่อฝ่ายขายเพื่อขอข้อมูลราคาปริมาณ |
ตัวอย่าง
หากแอปพลิเคชันของคุณออกการโทร 2 สายนี้ในเซสชันเดียว
Android
- findAutocompletePredictions() (.setQuery(”par”), .setSessionToken(XYZ))
- findAutocompletePredictions() (.setQuery(”paris”), .setSessionToken(XYZ))
iOS
- placesClient?.findAutocompletePredictions(fromQuery: "par" ...
- placesClient?.findAutocompletePredictions(fromQuery: "ปารีส" ...
บริการบนเว็บ
- ส่งคําขอ Place Autocomplete (input=”par”, session_token: XYZ)
- ส่งคําขอ Place Autocomplete (input=”paris”, session_token: XYZ)
คุณจะเห็น SKU นี้แสดงอยู่ในใบเรียกเก็บเงิน (เมื่อดูใบเรียกเก็บเงินตาม SKU)
- เติมข้อความอัตโนมัติโดยไม่มีรายละเอียดสถานที่ – ต่อเซสชัน (ราคาเริ่มต้นที่ 0.017 USD ต่อเซสชัน)
SKU: การเติมข้อความอัตโนมัติ (รวมอยู่ในรายละเอียดสถานที่) – ต่อเซสชัน
ระบบจะเรียกเก็บเงินจาก SKU การเติมข้อความอัตโนมัติ (รวมอยู่ในรายละเอียดสถานที่) – ต่อเซสชันสำหรับเซสชันการเติมข้อความอัตโนมัติที่มีรายการต่อไปนี้
- Android: โทรหา
fetchPlace()
- iOS: โทรหา
fetchPlaceFromPlaceID:
- บริการผ่านเว็บ: คำขอรายละเอียดสถานที่
คำขอเติมข้อความอัตโนมัติให้บริการโดยไม่มีค่าใช้จ่าย และการโทรรายละเอียดสถานที่ในครั้งต่อๆ ไปจะมีการเรียกเก็บเงินตามปกติ การกำหนดราคาในรายละเอียดสถานที่
คำขอรายละเอียดสถานที่จะสร้าง SKU ข้อมูล (พื้นฐาน, รายชื่อติดต่อและ/หรือบรรยากาศ) – ทั้งนี้ขึ้นอยู่กับฟิลด์ที่ระบุไว้ในคำขอ
หากคุณไม่ได้ระบุช่องในคำขอรายละเอียดสถานที่ ระบบจะเรียกใช้ SKU ข้อมูลทั้งหมด (พื้นฐาน รายชื่อติดต่อ และบรรยากาศ)
คำขอรีเฟรชรหัสรายละเอียดสถานที่ (คำขอที่ระบุเฉพาะช่อง place_id
)
ในระหว่างเซสชันการเติมข้อความอัตโนมัติจะถูกเรียกเก็บเงินเป็น SKU: การเติมข้อความอัตโนมัติ
ที่ไม่มีรายละเอียดสถานที่ – ต่อเซสชัน
ช่วงระดับเสียงรายเดือน (ราคาต่อ SESSION) |
||
---|---|---|
0.00 THB | 0.00 THB | 0.00 USD |
ตัวอย่าง
หากแอปพลิเคชันของคุณออกการโทร 3 รายการต่อไปนี้ในเซสชันเดียว
Android
- findAutocompletePredictions() (.setQuery(”par”), .setSessionToken(XYZ))
- findAutocompletePredictions() (.setQuery(”paris”), .setSessionToken(XYZ))
- fetchPlace() (ที่มี
FetchPlaceRequest
รวมทั้งรหัสสถานที่และช่อง ADDRESS)
iOS
- placesClient?.findAutocompletePredictions(fromQuery: "par" ...
- placesClient?.findAutocompletePredictions(fromQuery: "ปารีส" ...
- fetchPlaceFromPlaceID:
(รวมถึงรหัสสถานที่และช่อง
GMSPlaceFieldFormattedAddress
)
บริการบนเว็บ
- คำขอเติมข้อความอัตโนมัติเกี่ยวกับสถานที่ (input=”par”, session_token: XYZ)
- คำขอเติมข้อความอัตโนมัติเกี่ยวกับสถานที่ (input=”paris”, session_token: XYZ)
- รายละเอียดสถานที่ (place_id, session_token: XYZ, fields:formatted_address)
ในใบเรียกเก็บเงิน คุณจะเห็น SKU เหล่านี้แสดงอยู่ (เมื่อดูใบเรียกเก็บเงินตาม SKU)
- เติมข้อความอัตโนมัติ (รวมกับรายละเอียดสถานที่) – ต่อเซสชัน (เรียกเก็บเงิน 0.00 USD)
- รายละเอียดสถานที่ (ราคาเริ่มต้นที่ 0.017 USD ต่อเซสชัน)
- Basic Data (เรียกเก็บเงินที่ 0.00 USD)
SKU: เติมข้อความค้นหาอัตโนมัติ – ต่อคำขอ
ระบบจะเรียกเก็บเงิน SKU การเติมข้อความอัตโนมัติสำหรับคำค้นหา – ต่อคำขอสำหรับคำขอแต่ละรายการเพื่อดำเนินการต่อไปนี้
- JavaScript:
บริการเติมข้อความอัตโนมัติใน Places ของ Maps JavaScript API (
getQueryPredictions()
) และการใช้ วิดเจ็ต SearchBox ของ Maps JavaScript API (คำขอการเติมข้อความอัตโนมัติสำหรับการค้นหาคือ เป็นประเภทผู้ใช้) - บริการผ่านเว็บ: บริการเติมข้อความอัตโนมัติสำหรับการค้นหาของ Places API
ช่วงระดับเสียงรายเดือน (ราคาต่อคำขอ) |
||
---|---|---|
0.00283 USD ต่อ แต่ละรายการ (2.83 USD ต่อ 1,000 รายการ) |
0.00227 USD ต่อแต่ละรายการ (2.27 USD ต่อ 1,000) |
ติดต่อฝ่ายขายเพื่อขอข้อมูลราคาปริมาณ |
ระบบไม่รองรับการกำหนดราคาตามเซสชันการเติมข้อความอัตโนมัติเมื่อใช้การเติมข้อความค้นหาอัตโนมัติ ลำดับต่อมา ระบบจะเรียกเก็บค่าโทรในรายละเอียดสถานที่โดยอิงตามราคาปกติ การกำหนดราคารายละเอียดสถานที่
SKU: รายละเอียดสถานที่
การโทรไปยังรายละเอียดสถานที่จะมีค่าบริการดังนี้
ระดับการใช้งานรายเดือน (ราคาต่อสาย) |
||
---|---|---|
0.017 USD ต่อแต่ละรายการ (17.00 USD ต่อ 1,000) |
0.0136 USD ต่อแต่ละรายการ (13.60 USD ต่อ 1,000) |
ติดต่อฝ่ายขายเพื่อขอข้อมูลราคาปริมาณ |
SKU รายละเอียดสถานที่สร้างขึ้นจาก API ต่อไปนี้
- Android: Places SDK สำหรับ Android
(
fetchPlace()
) - iOS: Places SDK สำหรับ iOS
(
fetchPlaceFromPlaceID:
) - JavaScript:
บริการรายละเอียดสถานที่ของ Maps JavaScript API (
getDetails
) - JavaScript:
วิดเจ็ตการเติมข้อความอัตโนมัติของสถานที่ของ Maps JavaScript API (
getPlace
) - JavaScript:
วิดเจ็ต Place SearchBox ของ Maps JavaScript API:
getPlaces()
หลังจากที่ผู้ใช้เลือกผลการค้นหาสถานที่ (ไอคอน: หมุด) *ไม่ใช่* ข้อความค้นหา (ไอคอน แว่นขยาย) ดังที่แสดงไว้ที่นี่ - บริการผ่านเว็บ: บริการรายละเอียดสถานที่ของ Places API
สำหรับเว็บ API และบริการ ระบบจะเรียกเก็บเงิน SKU รายละเอียดสถานที่ไม่ว่าโทเค็นของเซสชัน ระบุหรือไม่
นอกจากนี้ การโทรหรือคำขอรายละเอียดสถานที่จะสร้าง SKU ข้อมูลด้วย (พื้นฐาน, รายชื่อติดต่อและ/หรือบรรยากาศ) ขึ้นอยู่กับ ในฟิลด์ที่ระบุในการโทรหรือคำขอ หากไม่ได้ระบุฟิลด์ไม่ในคำขอหรือคำเรียกรายละเอียดสถานที่ ระบบจะเรียกใช้ SKU ข้อมูลทั้งหมด และระบบจะเรียกเก็บเงินจากคุณสำหรับคำขอหรือคำเรียกรายละเอียดสถานที่บวกค่าบริการของข้อมูลทั้งหมด
ตัวอย่าง
- โทรหรือขอรายการใดรายการหนึ่งต่อไปนี้
- อุปกรณ์เคลื่อนที่: โทรหา
fetchPlace()
ใน Android หรือfetchPlaceFromPlaceID:
บน iOS และระบุเฉพาะช่องADDRESS
- Web API หรือบริการ: ส่งคำขอรายละเอียดสถานที่และระบุเฉพาะช่องที่อยู่ ดังนี้
getPlaceDetails(fields: formatted_address)
- รายละเอียดสถานที่ (ราคาเริ่มต้นที่ 0.017 USD ต่อเซสชัน)
- Basic Data (เรียกเก็บเงินที่ 0.00 USD)
- อุปกรณ์เคลื่อนที่: โทรหา
- โทรหรือส่งคำขออย่างใดอย่างหนึ่งต่อไปนี้
- อุปกรณ์เคลื่อนที่: โทรหา
fetchPlace()
ใน Android หรือfetchPlaceFromPlaceID:
ใน iOS แล้วระบุเฉพาะช่องPHONE_NUMBER
- Web API หรือบริการ: ส่งคำขอรายละเอียดสถานที่และระบุช่องหมายเลขโทรศัพท์ ดังนี้
getPlaceDetails(fields: formatted_phone_number)
- รายละเอียดสถานที่ (ราคาเริ่มต้นที่ 0.017 USD ต่อเซสชัน)
- ข้อมูลติดต่อ (ราคาเริ่มต้นที่ 0.003 USD ต่อคำขอ)
- อุปกรณ์เคลื่อนที่: โทรหา
- โทรหรือส่งคำขออย่างใดอย่างหนึ่งต่อไปนี้
- อุปกรณ์เคลื่อนที่: โทรหา
fetchPlace()
ใน Android หรือfetchPlaceFromPlaceID:
บน iOS และระบุฟิลด์ทั้งหมด - Web API หรือบริการ: ส่งคำขอรายละเอียดสถานที่และระบุช่องทั้งหมด (คำขอประเภทนี้เป็นค่าเริ่มต้นหากคุณไม่ได้ระบุช่องใดเลย)
getPlaceDetails()
- รายละเอียดสถานที่ (ราคาเริ่มต้นที่ 0.017 USD ต่อเซสชัน)
- ข้อมูลพื้นฐาน (ระบบจะเรียกเก็บเงินที่ 0.00 USD)
- ข้อมูลติดต่อ (ราคาเริ่มต้นที่ 0.003 USD ต่อคำขอ)
- ข้อมูลบรรยากาศ (ราคาเริ่มต้นที่ 0.005 USD ต่อคำขอ)
- อุปกรณ์เคลื่อนที่: โทรหา
SKU: รายละเอียดสถานที่ – การรีเฟรชรหัส
ใช้คำขอรายละเอียดสถานที่เพื่อรีเฟรชรหัสสถานที่ที่ล้าสมัย คำขอประเภทเหล่านี้ไม่มีค่าใช้จ่าย
ระดับการใช้งานรายเดือน (ราคาต่อสาย) |
||
---|---|---|
0.00 THB | 0.00 THB | 0.00 USD |
ตัวอย่าง
สร้างคำขอรายละเอียดสถานที่โดยระบุเฉพาะช่องรหัสสถานที่ ดังนี้
getPlaceDetails(fields: place_id)
คุณจะเห็น SKU นี้แสดงอยู่ในใบเรียกเก็บเงิน (เมื่อดูใบเรียกเก็บเงินตาม SKU)
- รายละเอียดสถานที่ – รีเฟรชรหัส (เรียกเก็บเงิน 0.00 USD)
SKU: ค้นหาสถานที่
ระบบจะเรียกเก็บค่าบริการ Find Place เมื่อมีการส่งคำขอค้นหาสถานที่
ช่วงระดับเสียงรายเดือน (ราคาสำหรับการโทรหนึ่งครั้ง) |
||
---|---|---|
0.017 USD ต่อแต่ละรายการ (17.00 USD ต่อ 1,000) |
0.0136 USD ต่อ แต่ละรายการ (13.60 USD ต่อ 1,000 รายการ) |
ติดต่อฝ่ายขายเพื่อขอข้อมูลราคาปริมาณ |
คำขอค้นหาสถานที่จะสร้าง Data SKU (Basic, Contact และ/หรือ Atmosphere) ด้วย โดยขึ้นอยู่กับช่องที่ระบุในคำขอ คุณสามารถใช้พารามิเตอร์ฟิลด์ในคำขอค้นหาสถานที่เพื่อจำกัดการตอบกลับให้แสดงเฉพาะฟิลด์ที่ระบุได้ เช่นเดียวกับคำขอรายละเอียดสถานที่ ระบบจะเรียกเก็บเงินสำหรับคำขอค้นหาสถานที่และข้อมูล ที่ขอ โดยค่าเริ่มต้น หากมีการขอช่อง NO ระบบจะแสดงผลเฉพาะรหัสสถานที่ ดังนั้นจึงไม่มีค่าใช้จ่ายสำหรับข้อมูลเพิ่มเติม
ตัวอย่าง
- คุณส่งคำขอค้นหาสถานที่และระบุเฉพาะฟิลด์ที่อยู่:
FindPlace(fields: formatted_address)
ในใบเรียกเก็บเงิน คุณจะเห็น SKU เหล่านี้แสดงอยู่ (เมื่อดูใบเรียกเก็บเงินตาม SKU)- ค้นหาสถานที่ (ราคาเริ่มต้นที่ 0.017 USD ต่อการโทร)
- Basic Data (เรียกเก็บเงินที่ 0.00 USD)
- คุณส่งคำขอค้นหาสถานที่และระบุฟิลด์หมายเลขโทรศัพท์ ดังนี้
FindPlace(fields: formatted_phone_number)
ในใบเรียกเก็บเงิน คุณจะเห็น SKU เหล่านี้แสดงอยู่ (เมื่อ ดูใบเรียกเก็บเงินตาม SKU)- ค้นหาสถานที่ (ราคาเริ่มต้นที่ 0.017 USD ต่อการโทร)
- ข้อมูลติดต่อ (ราคาเริ่มต้นที่ 0.003 USD ต่อคำขอ)
- คุณส่งคำขอค้นหาสถานที่และระบุช่องจากที่เก็บข้อมูลประเภทข้อมูลทั้ง 3 ประเภทดังนี้
FindPlace(fields: formatted_address, opening_hours, price_level)
ในใบเรียกเก็บเงิน คุณจะเห็น SKU เหล่านี้แสดงอยู่ (เมื่อ ดูใบเรียกเก็บเงินตาม SKU)- ค้นหาสถานที่ (ราคาเริ่มต้นที่ 0.017 USD ต่อสาย)
- ข้อมูลพื้นฐาน (ระบบจะเรียกเก็บเงินที่ 0.00 USD)
- ข้อมูลติดต่อ (ราคาเริ่มต้นที่ 0.003 USD ต่อคำขอ)
- ข้อมูลบรรยากาศ (ราคาเริ่มต้นที่ 0.005 USD ต่อคำขอ)
SKU: ค้นหาสถานที่ – รหัสเท่านั้น
ค้นหาสถานที่ – รหัสเท่านั้นจะถูกเรียกเก็บเงินสำหรับคำขอค้นหาสถานที่เพียงที่ ระบุรหัสสถานที่ที่จะส่งคืน โดยค่าเริ่มต้น ถ้าไม่มีการระบุช่องในการค้นหาสถานที่ แสดงรหัสสถานที่เท่านั้น
ช่วงระดับเสียงรายเดือน (ราคาสำหรับการโทรหนึ่งครั้ง) |
||
---|---|---|
0.00 THB | 0.00 THB | 0.00 USD |
ตัวอย่าง
คุณส่งคำขอค้นหาสถานที่และระบุเฉพาะช่อง place_id
: FindPlace(fields: place_id)
ในใบเรียกเก็บเงิน คุณจะเห็น SKU นี้แสดงอยู่ (เมื่อ
การดูใบเรียกเก็บเงินตาม SKU)
- ค้นหาสถานที่ – รหัสเท่านั้น (เรียกเก็บเงินที่ 0.00 USD)
SKU: สถานที่ – การค้นหาใกล้เคียง
สถานที่ – การค้นหาในพื้นที่จะเรียกเก็บเงินสำหรับคำขอไปยังบริการการค้นหาสถานที่ใกล้เคียงของ Maps JavaScript API (nearbySearch()
) หรือไปยังบริการการค้นหาในพื้นที่ของ Places API
ระดับการใช้งานรายเดือน (ราคาต่อสาย) |
||
---|---|---|
0.032 USD ต่อ แต่ละรายการ (32.00 USD ต่อ 1,000 รายการ) |
0.0256 USD ต่อ แต่ละรายการ (25.60 USD ต่อ 1,000 รายการ) |
ติดต่อฝ่ายขายเพื่อสอบถามราคาสำหรับการใช้งานจำนวนมาก |
คำขอการค้นหาใกล้เคียงแสดงผลรายการสถานที่ แต่ไม่รองรับการระบุว่าช่องใด ส่งคืนแล้ว คำขอการค้นหาใกล้เคียงแสดงผล เซ็ตย่อย ของช่องข้อมูลที่รองรับ ระบบจะเรียกเก็บค่าบริการการค้นหาด้วย Nearby ในราคาเริ่มต้นที่ 0.032 USD ต่อแต่ละรายการ รวมถึง SKU ประเภทข้อมูลทั้งหมด (ข้อมูลพื้นฐาน ข้อมูลรายชื่อติดต่อ และข้อมูลบรรยากาศ)
ตัวอย่าง
คุณส่งคำขอการค้นหาด้วยบริเวณใกล้เคียง เช่น NearbySearch (San Francisco, 100 meters)
ในใบเรียกเก็บเงิน คุณจะเห็น SKU เหล่านี้แสดงอยู่ (เมื่อดูใบเรียกเก็บเงินตาม SKU)
- สถานที่ - การค้นหาใกล้เคียง (ราคาเริ่มต้นที่ 0.032 USD ต่อสาย)
- Basic Data (เรียกเก็บเงินที่ 0.00 USD)
- ข้อมูลติดต่อ (ราคาเริ่มต้นที่ 0.003 USD ต่อคำขอ)
- ข้อมูลบรรยากาศ (ราคาเริ่มต้นที่ 0.005 USD ต่อคำขอ)
SKU: สถานที่ – การค้นหาข้อความ
สถานที่ – การค้นหาข้อความจะคิดค่าบริการสำหรับคำขอไปยัง
บริการ Place Text Search ของ Maps JavaScript API
(textSearch()
) หรือไปยัง
บริการการค้นหาข้อความ API ของ Places
ช่วงระดับเสียงรายเดือน (ราคาสำหรับการโทรหนึ่งครั้ง) |
||
---|---|---|
0.032 USD ต่อ แต่ละรายการ (32.00 USD ต่อ 1,000 รายการ) |
0.0256 USD ต่อ แต่ละรายการ (25.60 USD ต่อ 1,000 รายการ) |
ติดต่อฝ่ายขายเพื่อสอบถามราคาสำหรับการใช้งานจำนวนมาก |
คำขอการค้นหาข้อความจะแสดงรายการสถานที่ แต่จะไม่รองรับการระบุช่องที่จะแสดงผล คำขอการค้นหาข้อความจะแสดงชุดย่อยของช่องข้อมูลที่รองรับ ระบบจะเรียกเก็บค่าบริการสำหรับคำขอค้นหาข้อความเริ่มต้นที่ 0.032 USD ต่อคำขอ รวมถึง SKU ประเภทข้อมูล (ข้อมูลพื้นฐาน, ข้อมูลรายชื่อติดต่อ, และข้อมูลบรรยากาศ)
นอกจากนี้ SKU ของการค้นหาข้อความ Place – ยังสร้างขึ้นโดย
วิดเจ็ต Place SearchBox ของ Maps JavaScript API: getPlaces()
หลังจากที่ผู้ใช้เลือกการค้นหาสถานที่ (ไอคอน: แว่นขยาย) ไม่ใช่
ผลลัพธ์ (ไอคอน: PIN) ดังที่แสดงไว้ที่นี่
ตัวอย่าง
คุณส่งคําขอการค้นหาข้อความ เช่น TextSearch(123 Main Street)
ในใบเรียกเก็บเงิน คุณจะเห็น SKU เหล่านี้แสดงอยู่ (เมื่อดูใบเรียกเก็บเงินตาม SKU)
- สถานที่ - การค้นหาข้อความ (ราคาเริ่มต้นที่ 0.032 USD ต่อสาย)
- ข้อมูลพื้นฐาน (ระบบจะเรียกเก็บเงินที่ 0.00 USD)
- ข้อมูลติดต่อ (ราคาเริ่มต้นที่ 0.003 USD ต่อคำขอ)
- ข้อมูลบรรยากาศ (ราคาเริ่มต้นที่ 0.005 USD ต่อคำขอ)
SKU: Place Photo
ระบบจะเรียกเก็บเงินสำหรับ SKU รูปภาพสถานที่ในกรณีต่อไปนี้
- Android: โทรหา
fetchPhoto()
- iOS: โทรหา
loadPlacePhoto:
- JavaScript: ไปยัง Places Library ซึ่งเป็นบริการ Place Photos ของ Maps JavaScript API เมื่อขอข้อมูลจาก URL ที่
PlacePhoto.getUrl()
แสดงผลเพื่อโหลดข้อมูลพิกเซลรูปภาพ - บริการผ่านเว็บ: คําขอไปยัง สถานที่ API ของ Places บริการ Photos
สำหรับบริการ JavaScript การเรียกใช้เมธอด PlacePhoto.getUrl()
จะไม่
ทำให้เกิดการเรียกเก็บเงินจนกว่าจะมีการใช้ URL ในการรับข้อมูลพิกเซลจริงๆ
ระดับการใช้งานรายเดือน (ราคาต่อสาย) |
||
---|---|---|
0.007 USD ต่อ แต่ละรายการ (7.00 USD ต่อ 1,000 รายการ) |
0.0056 USD ต่อแต่ละรายการ (5.60 USD ต่อ 1,000) |
ติดต่อฝ่ายขายเพื่อขอข้อมูลราคาปริมาณ |
ขีดจำกัดการใช้งานอื่นๆ
แม้ว่าจะไม่มีจำนวนคำขอสูงสุดต่อวัน แต่รายการต่อไปนี้ ขีดจำกัดการใช้งานจะยังคงมีผล:
Places API (ใหม่): จำกัดอัตราคำขออยู่ที่ 600 QPM (คำขอต่อนาที) ต่อเมธอด API ต่อโปรเจ็กต์ ความหมายของเมธอด API แต่ละเมธอด จะมีโควต้าแยกต่างหาก
Places API: การจำกัดอัตราคือ 6,000 QPM (คำขอต่อนาที) ซึ่งคำนวณเป็นผลรวมของคำขอจากฝั่งไคลเอ็นต์และฝั่งเซิร์ฟเวอร์ สำหรับแอปพลิเคชันทั้งหมดที่ใช้ข้อมูลเข้าสู่ระบบของโปรเจ็กต์เดียวกัน
ข้อจำกัดของข้อกำหนดในการใช้งาน
สำหรับข้อมูลเกี่ยวกับข้อกำหนดในการใช้งาน โปรดดู สำหรับ Places API และ ส่วนข้อจำกัดของใบอนุญาต ของข้อกำหนดในการให้บริการของ Google Maps Platform
จัดการต้นทุนการใช้งาน
เพื่อจัดการต้นทุนในการใช้ Places API หรือเพื่อตอบสนองความต้องการในการผลิต ตั้งค่าขีดจำกัดโควต้ารายวันสำหรับคำขอทั้งหมดที่ส่งไปยัง API ใดๆ ก็ตาม ระบบจะรีเซ็ตโควต้าประจำวันตอนเที่ยงคืนตามเวลาแปซิฟิก
หากต้องการดูหรือเปลี่ยนแปลงขีดจำกัดโควต้าสำหรับ Places API ให้ทำดังนี้
- เปิดหน้าโควต้า Google Maps Platform ใน Cloud Console
- คลิกเมนูแบบเลื่อนลง API และเลือก Places API
- หากต้องการดูขีดจํากัดโควต้า ให้เลื่อนลงไปที่การ์ดคําขอ
ตารางแสดงชื่อโควต้าและขีดจำกัด - หากต้องการเปลี่ยนขีดจำกัดโควต้า ให้คลิกไอคอนแก้ไขสำหรับขีดจำกัดนั้น
ในกล่องโต้ตอบที่ปรากฏขึ้น ให้ป้อนช่องขีดจำกัดโควต้า ขีดจำกัดโควต้ารายวันที่เรียกเก็บเงินได้ที่ต้องการ (สูงสุดถึงขีดจำกัดโควต้า หากมี ซึ่ง Google ระบุ) แล้วเลือกบันทึก
หากการใช้งาน API ของคุณถึงโควต้าสูงสุดที่เรียกเก็บเงินได้ในวันใดวันหนึ่ง แอปพลิเคชันของคุณจะไม่ เข้าถึง API ได้ในช่วงเวลาที่เหลือของวันนั้น