วิธีการเรียกเก็บเงินสำหรับ Places API
Places API (ใหม่) และ Places API ใช้รูปแบบการเรียกเก็บเงินแบบจ่ายเมื่อใช้ Google Maps Platform API และ SDK เรียกเก็บเงินตาม 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 รายการ รวมถึงคำขอรายละเอียดสถานที่ (ใหม่) หรือคำขอการยืนยันที่อยู่ ระบบจะส่งโทเค็นเซสชันเดียวกันไปยังคำขอ Autocomplete (ใหม่) และคำขอรายละเอียดสถานที่ (ใหม่) หรือคำขอตรวจสอบที่อยู่ในลำดับถัดไป
เซสชันเริ่มต้นด้วยคําขอเติมข้อความอัตโนมัติ (ใหม่) รายการแรก จากนั้นระบบจะส่งคําขอรายละเอียดสถานที่ (ใหม่) หรือคําขอตรวจสอบที่อยู่เมื่อผู้ใช้เลือกคําแนะนําแบบเติมข้อความอัตโนมัติ (ใหม่) รายการใดรายการหนึ่ง หากเซสชันถูกยกเลิก ซึ่งหมายความว่าไม่มีการส่งคำขอรายละเอียดสถานที่ (ใหม่) หรือคำขอตรวจสอบที่อยู่ ระบบจะเรียกเก็บเงินสำหรับคำขอเติมข้อความอัตโนมัติ (ใหม่) ราวกับว่าไม่มีการระบุโทเค็นเซสชัน
หลังจากผู้ใช้เลือกสถานที่ (หมายถึงมีคำขอรายละเอียดสถานที่ (ใหม่) หรือคำขอการยืนยันที่อยู่) คุณต้องเริ่มเซสชันใหม่โดยใช้โทเค็นเซสชันใหม่
โทเค็นเซสชันใช้ได้กับ 1 เซสชันเท่านั้นและใช้กับเซสชันได้มากกว่า 1 เซสชันไม่ได้ หากคุณใช้โทเค็นเซสชันซ้ำ ระบบจะถือว่าเซสชันไม่ถูกต้องและจะเรียกเก็บเงินสำหรับคำขอราวกับว่าไม่มีการระบุโทเค็นเซสชัน
SKU: คำขอเติมข้อความอัตโนมัติ
ระบบจะเรียกเก็บเงิน SKU คำขอการเติมข้อความอัตโนมัติสำหรับคำขอแต่ละรายการที่ส่งไปยัง Autocomplete (ใหม่) API ที่ไม่มีโทเค็นเซสชัน
นอกจากนี้จะมีการเรียกเก็บเงินหากคุณใช้โทเค็นเซสชันและ
- สิ้นสุดเซสชันด้วยคําขอเดียวไปยัง "รายละเอียดสถานที่ตั้ง" (ใหม่) ที่ขอช่องใดก็ได้ที่กําหนดโดย SKU: รายละเอียดสถานที่ตั้ง (ตําแหน่งเท่านั้น)
- ระบบจะเรียกเก็บเงินสำหรับคำขอ Autocomplete (ใหม่) แต่ละรายการไม่เกิน 12 รายการโดยใช้ SKU: คำขอ Autocomplete
- ระบบจะเรียกเก็บเงินสำหรับคำขอการเติมข้อความอัตโนมัติ (ใหม่) แต่ละรายการที่ใช้ภายหลังโดยใช้ SKU: การใช้งานเซสชันการเติมข้อความอัตโนมัติ
- ยกเลิกเซสชันหรือสิ้นสุดเซสชันโดยโทรไปที่ SKU: รายละเอียดสถานที่ (รหัสเท่านั้น) จากนั้นระบบจะเรียกเก็บเงินสำหรับคำขอ Autocomplete (ใหม่) ทั้งหมดโดยใช้ SKU: คำขอ Autocomplete
ระดับการใช้งานรายเดือน (ราคาต่อสาย) |
||
---|---|---|
0.00283 USD ต่อแต่ละรายการ (2.83 USD ต่อ 1,000) |
0.00227 USD ต่อแต่ละรายการ (2.27 USD ต่อ 1,000) |
ติดต่อฝ่ายขายเพื่อสอบถามราคาสำหรับการใช้งานจำนวนมาก |
SKU: การใช้งานเซสชันการเติมข้อความอัตโนมัติ
ระบบจะเรียกเก็บเงิน SKU การใช้งานเซสชันของฟีเจอร์เติมข้อความอัตโนมัติสำหรับคำขอแต่ละรายการที่ส่งไปยัง Autocomplete (ใหม่) API ซึ่งมีโทเค็นเซสชัน
ระบบจะเรียกเก็บเงิน SKU นี้ในสถานการณ์ต่อไปนี้
เซสชันการเติมข้อความอัตโนมัติสิ้นสุดลงด้วยการเรียกใช้ SKU: รายละเอียดสถานที่ (ตำแหน่งเท่านั้น)
- ระบบจะเรียกเก็บเงินสำหรับคำขอ Autocomplete (ใหม่) แต่ละรายการไม่เกิน 12 รายการโดยใช้ SKU: คำขอ Autocomplete
- คำขอเติมข้อความอัตโนมัติ (ใหม่) ที่ตามมาแต่ละรายการจะถูกเรียกเก็บเงินโดยใช้ SKU: การใช้งานเซสชันการเติมข้อความอัตโนมัติ
เซสชันการเติมข้อความอัตโนมัติสิ้นสุดลงด้วยการเรียกใช้ SKU: รายละเอียดสถานที่ (พื้นฐาน ขั้นสูง หรือที่ต้องการ)
การเรียกใช้รายละเอียดสถานที่ที่ขอช่องใดก็ได้จาก SKU: รายละเอียดสถานที่ (พื้นฐาน ขั้นสูง หรือแนะนำ) จะเรียกเก็บเงินใน SKU: รายละเอียดสถานที่ (แนะนำ)
เซสชันการเติมข้อความอัตโนมัติสิ้นสุดลงด้วยการเรียกใช้ SKU: Address Validation (การยืนยันที่อยู่) Preferred
ดูข้อมูลเพิ่มเติมได้ที่ฟีเจอร์เติมข้อความอัตโนมัติ (ใหม่) และราคาเซสชัน
ระดับการใช้งานรายเดือน (ราคาต่อสาย) |
||
---|---|---|
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
,
containingPlaces
,
displayName
,
googleMapsLinks
*,
googleMapsUri
,
iconBackgroundColor
,
iconMaskBaseUri
,
primaryType
,
primaryTypeDisplayName
,
pureServiceAreaBusiness
,
subDestinations
,
utcOffsetMinutes
* ช่อง googleMapsLinks
อยู่ในช่วงทดลองใช้ก่อน GA และไม่มีค่าใช้จ่าย ซึ่งหมายความว่าการเรียกเก็บเงินจะเป็น $0 สำหรับการใช้งานในช่วงทดลองใช้
หากเซสชันการเติมข้อความอัตโนมัติสิ้นสุดลงด้วยการเรียกใช้รายละเอียดสถานที่ที่ขอช่องใดก็ได้จาก SKU: รายละเอียดสถานที่ (พื้นฐาน ขั้นสูง หรือแนะนำ) ระบบจะเรียกเก็บเงินการเรียกใช้ดังกล่าวใน SKU: รายละเอียดสถานที่ (แนะนำ) ดูข้อมูลเพิ่มเติมได้ที่ SKU: การใช้งานเซสชันการเติมข้อความอัตโนมัติ
ระดับการใช้งานรายเดือน (ราคาต่อสาย) |
||
---|---|---|
0.0170 USD ต่อ 1 รายการ (17.00 USD ต่อ 1,000 รายการ) |
0.0136 USD ต่อ แต่ละรายการ (13.60 USD ต่อ 1,000 รายการ) |
ติดต่อฝ่ายขายเพื่อสอบถามราคาสำหรับการใช้งานจำนวนมาก |
SKU: รายละเอียดสถานที่ (ขั้นสูง)
การใช้มาสก์ฟิลด์หรือรายการฟิลด์ในคำขอรายละเอียดสถานที่ (ใหม่) จะช่วยให้คุณจำกัดการตอบกลับให้แสดงเฉพาะฟิลด์ที่ระบุได้ SKU นี้จะทริกเกอร์เมื่อคุณขอเฉพาะช่องต่อไปนี้
เว็บเซอร์วิส:
currentOpeningHours
,
currentSecondaryOpeningHours
,
internationalPhoneNumber
,
nationalPhoneNumber
,
priceLevel
,
priceRange
,
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.containingPlaces
,
places.displayName
,
places.formattedAddress
,
places.googleMapsLinks
*,
places.googleMapsLinks
*,
places.googleMapsUri
*,
places.googleMapsUri
, , places.adrFormatAddress
,
places.attributions
,
places.businessStatus
,
places.containingPlaces
, {17/places.displayName
,
places.formattedAddress
,
places.googleMapsLinks
*, places.googleMapsLinks
*, places.googleMapsUri
*, , places.googleMapsUri
, , , , places.adrFormatAddress
, , , , places.iconMaskBaseUri
, , places.id
, places.location
, {2/places.iconBackgroundColor
places.name
places.photos
places.plusCode
places.primaryType
places.primaryTypeDisplayName
places.pureServiceAreaBusiness
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.priceRange
,
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.containingPlaces
,
places.displayName
,
places.formattedAddress
,
places.googleMapsLinks
*,
places.googleMapsUri
,
places.iconBackgroundColor
,
places.iconMaskBaseUri
,
places.location
,
places.photos
,
places.plusCode
,
places.primaryType
,
places.primaryTypeDisplayName
,
places.pureServiceAreaBusiness
,
places.shortFormattedAddress
,
places.subDestinations
,
places.types
,
places.utcOffsetMinutes
,
places.viewport
* ช่อง places.googleMapsLinks
อยู่ในช่วงการทดลองใช้ก่อน GA และไม่มีค่าใช้จ่าย ซึ่งหมายความว่าการเรียกเก็บเงินจะเป็น $0 สำหรับการใช้งานในช่วงทดลองใช้
ระดับการใช้งานรายเดือน (ราคาต่อสาย) |
||
---|---|---|
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.priceRange
,
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: Place Photo
ระบบจะเรียกเก็บเงินสำหรับ 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 ของ Maps JavaScript API คุณต้องออกแบบแอปพลิเคชันเพื่อให้โทเค็นเซสชัน (คุณอาจต้องเปลี่ยนโค้ดที่มีอยู่)
- วิดเจ็ตการเติมข้อความอัตโนมัติของ Maps JavaScript API ระบบจะเปิดใช้การเรียกเก็บเงินตามเซสชันโดยอัตโนมัติในวิดเจ็ตเหล่านั้น โดยที่คุณไม่ต้องเปลี่ยนแปลงโค้ดใดๆ
โทเค็นเซสชันเหมาะสำหรับเซสชันผู้ใช้ 1 เซสชันและไม่ควรใช้กับเซสชันผู้ใช้มากกว่า 1 เซสชัน หากคุณนำโทเค็นเซสชันมาใช้ซ้ำ ระบบจะถือว่าเซสชันไม่ถูกต้องและจะเรียกเก็บเงินจากคำขอเสมือนว่าไม่ได้ให้โทเค็นเซสชันไว้
ระบบจะเรียกเก็บเงินคำขอการเติมข้อความอัตโนมัติและคำขอรายละเอียดสถานที่โดยใช้เซสชันใน SKU ที่ต่างกัน
เกี่ยวกับ SKU ของข้อมูลสถานที่
SKU ของข้อมูล Places 3 รายการ ได้แก่ ข้อมูลพื้นฐาน ข้อมูลติดต่อ และข้อมูลบรรยากาศSKU ข้อมูลอย่างน้อย 1 รายการจะทริกเกอร์ในกรณีต่อไปนี้
- Android: แต่ละคำขอไปยัง
fetchPlace()
หรือfindCurrentPlace()
- iOS: การโทรมาที่
fetchPlaceFromPlaceID:
หรือfindPlaceLikelihoodsFromCurrentLocationWithPlaceFields:
แต่ละครั้ง - เว็บเซอร์วิส: คำขอ Places แต่ละรายการจะขึ้นอยู่กับช่องที่ระบุในคำขอ
ระบบจะเรียกเก็บเงิน SKU ข้อมูลเพิ่มเติมจาก SKU พื้นฐานของคำขอที่เรียกให้แสดง SKU ข้อมูลเสมอ ตัวอย่างเช่น คำขอรายละเอียดสถานที่ซึ่งมีฟิลด์ข้อมูลพื้นฐานจะมีการเรียกเก็บเงินทั้งภายใต้ SKU ข้อมูลพื้นฐานและ SKU รายละเอียดสถานที่
สําหรับเว็บเซอร์วิส การเรียกใช้ Places API เหล่านี้รองรับการระบุช่องข้อมูลที่จะแสดงผล
สําหรับบริการเว็บ การเรียกใช้ Places API เหล่านี้ไม่รองรับการระบุช่องที่แสดงผล การเรียกเหล่านี้จะแสดงข้อมูล Places ทั้งหมดเสมอ โดยจะเรียกเก็บเงิน SKU ข้อมูล Places 3 รายการนี้นอกเหนือจากการเรียกเก็บเงินสำหรับคำขอ API แต่ละรายการ
SKU: ข้อมูลพื้นฐาน
การใช้พารามิเตอร์ช่องในรายละเอียดสถานที่หรือคำขอค้นหาสถานที่ คุณสามารถจำกัดการตอบกลับไว้เฉพาะช่องที่ระบุได้ ช่องในหมวดหมู่พื้นฐานจะรวมอยู่ในค่าใช้จ่ายพื้นฐานของคำขอสถานที่และไม่ทำให้เกิดการเรียกเก็บเงินเพิ่มเติม ระบบจะเรียกใช้ 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 ที่เติมข้อความอัตโนมัติโดยไม่มีรายละเอียดสถานที่ – ต่อเซสชันจะมีการเรียกเก็บเงินสำหรับเซสชันการเติมข้อความอัตโนมัติที่ไม่รวมถึงคำขอรายละเอียดสถานที่ (ภายใน 2-3 นาทีนับจากการเริ่มต้นเซสชัน)
ช่วงที่ทำให้เกิดปริมาณรายเดือน (ราคาต่อเซสชัน) |
||
---|---|---|
0.017 USD ต่อ 1 รายการ (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: "paris" ...
บริการบนเว็บ
- ส่งคําขอ 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 USD | 0.00 USD | 0.00 THB |
ตัวอย่าง
หากแอปพลิเคชันของคุณออกการโทร 3 รายการต่อไปนี้ในเซสชันเดียว
Android
- findAutocompletePredictions() (.setQuery(”par”), .setSessionToken(XYZ))
- findAutocompletePredictions() (.setQuery(”paris”), .setSessionToken(XYZ))
- fetchPlace() (ที่มี
FetchPlaceRequest
พร้อมด้วยรหัสสถานที่และช่อง ADDRESS)
iOS
- placesClient?.findAutocompletePredictions(fromQuery: "par" ...
- placesClient?.findAutocompletePredictions(fromQuery: "paris" ...
- fetchPlaceFromPlaceID:
(รวมถึงรหัสสถานที่และฟิลด์
GMSPlaceFieldFormattedAddress
)
บริการผ่านเว็บ
- คำขอ Place Autocomplete (input=”par”, session_token: XYZ)
- คําขอ Place Autocomplete (input=”paris”, session_token: XYZ)
- รายละเอียดสถานที่ (place_id, session_token: XYZ, fields:formatted_address)
ในใบเรียกเก็บเงิน คุณจะเห็น SKU เหล่านี้แสดงอยู่ (เมื่อดูใบเรียกเก็บเงินตาม SKU)
- ฟีเจอร์เติมข้อความอัตโนมัติ (รวมอยู่ในรายละเอียดสถานที่) – ต่อเซสชัน (เรียกเก็บเงินที่ 0.00 USD)
- รายละเอียดสถานที่ (ราคาเริ่มต้นที่ 0.017 USD ต่อเซสชัน)
- ข้อมูลพื้นฐาน (ระบบจะเรียกเก็บเงินที่ 0.00 USD)
SKU: การเติมข้อความอัตโนมัติของคําค้นหา – ต่อคําขอ
ระบบจะเรียกเก็บเงิน SKU การเติมข้อความอัตโนมัติสำหรับคำค้นหา – ต่อคำขอสำหรับคำขอแต่ละรายการเพื่อดำเนินการต่อไปนี้
- JavaScript: บริการ Place Autocomplete ของ 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 ต่อ 1 รายการ (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:
วิดเจ็ตช่องค้นหาสถานที่ของ Maps JavaScript API:
getPlaces()
เมธอดหลังจากที่ผู้ใช้เลือกผลการค้นหาสถานที่ (ไอคอน: หมุด) *ไม่ใช่* การค้นหา (ไอคอน: แว่นขยาย) ดังที่แสดงที่นี่ - บริการบนเว็บ: บริการ Places API รายละเอียดสถานที่
เมื่อใช้ Web API และบริการ ระบบจะเรียกเก็บเงินสำหรับ SKU รายละเอียดสถานที่ไม่ว่าจะระบุโทเค็นเซสชันหรือไม่ก็ตาม
การเรียกหรือคําขอรายละเอียดสถานที่จะสร้าง SKU ของข้อมูล (พื้นฐาน รายชื่อติดต่อ และ/หรือ บรรยากาศ) ด้วย โดยขึ้นอยู่กับช่องที่ระบุในการเรียกหรือคําขอ หากไม่ได้ระบุฟิลด์ไม่ในคำขอหรือคำเรียกรายละเอียดสถานที่ ระบบจะเรียกใช้ SKU ข้อมูลทั้งหมด และระบบจะเรียกเก็บเงินจากคุณสำหรับคำขอหรือคำเรียกรายละเอียดสถานที่บวกค่าบริการของข้อมูลทั้งหมด
ตัวอย่าง
- โทรหรือขอรายการใดรายการหนึ่งต่อไปนี้
- อุปกรณ์เคลื่อนที่: โทรหา
fetchPlace()
ใน Android หรือfetchPlaceFromPlaceID:
ใน iOS แล้วระบุเฉพาะช่องADDRESS
- Web API หรือบริการ: ส่งคำขอรายละเอียดสถานที่และระบุเฉพาะช่องที่อยู่ ดังนี้
getPlaceDetails(fields: formatted_address)
- รายละเอียดสถานที่ (ราคาเริ่มต้นที่ 0.017 USD ต่อเซสชัน)
- ข้อมูลพื้นฐาน (ระบบจะเรียกเก็บเงินที่ 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 USD | 0.00 USD | 0.00 THB |
ตัวอย่าง
ส่งคำขอรายละเอียดสถานที่โดยระบุเฉพาะช่องรหัสสถานที่ ดังนี้
getPlaceDetails(fields: place_id)
คุณจะเห็น SKU นี้แสดงอยู่ในใบเรียกเก็บเงิน (เมื่อดูใบเรียกเก็บเงินตาม SKU)
- รายละเอียดสถานที่ – รีเฟรชรหัส (เรียกเก็บเงิน 0.00 USD)
SKU: ค้นหาสถานที่
ระบบจะเรียกเก็บเงินจาก Find Place สำหรับคำขอค้นหาสถานที่
ระดับการใช้งานรายเดือน (ราคาต่อสาย) |
||
---|---|---|
0.017 USD ต่อ 1 รายการ (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)- ค้นหา Place (ราคาเริ่มต้นที่ 0.017 USD ต่อการโทร)
- ข้อมูลพื้นฐาน (ระบบจะเรียกเก็บเงินที่ 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: ค้นหาสถานที่ – รหัสเท่านั้น
Find Place – ID เท่านั้นจะถูกเรียกเก็บเงินสำหรับคำขอ "Find Place" ซึ่งระบุเพียงรหัสสถานที่ที่จะส่งคืน โดยค่าเริ่มต้น หากไม่ได้ระบุช่องในคำขอค้นหาสถานที่ ระบบจะแสดงเฉพาะรหัสสถานที่
ระดับการใช้งานรายเดือน (ราคาต่อสาย) |
||
---|---|---|
0.00 USD | 0.00 USD | 0.00 THB |
ตัวอย่าง
คุณส่งคำขอค้นหาสถานที่และระบุเฉพาะช่อง place_id
: FindPlace(fields: place_id)
ในใบเรียกเก็บเงิน คุณจะเห็น SKU นี้แสดงอยู่ (เมื่อดูใบเรียกเก็บเงินตาม SKU)
- ค้นหาสถานที่ – รหัสเท่านั้น (เรียกเก็บเงินที่ 0.00 USD)
SKU: สถานที่ – การค้นหาใกล้เคียง
Place – การค้นหาใกล้เคียง จะถูกเรียกเก็บเงินสำหรับคำขอไปยัง
บริการ Place Nearby Search ของ Maps JavaScript API
(nearbySearch()
) หรือต่อ
บริการการค้นหาใกล้เคียงของ Places API
ระดับการใช้งานรายเดือน (ราคาต่อสาย) |
||
---|---|---|
0.032 USD ต่อ แต่ละรายการ (32.00 USD ต่อ 1,000 รายการ) |
0.0256 USD ต่อ แต่ละรายการ (25.60 USD ต่อ 1,000 รายการ) |
ติดต่อฝ่ายขายเพื่อสอบถามราคาสำหรับการใช้งานจำนวนมาก |
คำขอการค้นหาใกล้เคียงจะแสดงรายการสถานที่ แต่จะไม่รองรับการระบุช่องที่จะแสดง คำขอการค้นหาใกล้เคียงจะแสดงเซ็ตย่อยของช่องข้อมูลที่รองรับ ระบบจะเรียกเก็บเงินจากคุณสำหรับคำขอการค้นหาในพื้นที่โดยเริ่มต้นที่ 0.032 USD ต่อคำขอ 1 รายการ รวมถึง SKU ประเภทข้อมูลทั้งหมด (ข้อมูลพื้นฐาน ข้อมูลติดต่อ และข้อมูลบรรยากาศ)
ตัวอย่าง
คุณส่งคำขอค้นหาใกล้เคียง เช่น NearbySearch (San Francisco, 100 meters)
ในใบเรียกเก็บเงิน คุณจะเห็น SKU เหล่านี้แสดงอยู่ (เมื่อดูใบเรียกเก็บเงินตาม SKU)
- สถานที่ - การค้นหาใกล้เคียง (ราคาเริ่มต้นที่ 0.032 USD ต่อการโทร)
- Basic Data (เรียกเก็บเงินที่ 0.00 USD)
- ข้อมูลติดต่อ (ราคาเริ่มต้นที่ 0.003 USD ต่อคำขอ)
- ข้อมูลบรรยากาศ (ราคาเริ่มต้นที่ 0.005 USD ต่อคำขอ)
SKU: สถานที่ – การค้นหาข้อความ
สถานที่ตั้ง – การค้นหาข้อความจะเรียกเก็บเงินสำหรับคำขอไปยัง
บริการค้นหาข้อความสถานที่ตั้งของ Maps JavaScript API (textSearch()
) หรือไปยัง
บริการค้นหาข้อความของ Places API
ระดับการใช้งานรายเดือน (ราคาต่อสาย) |
||
---|---|---|
0.032 USD ต่อ แต่ละรายการ (32.00 USD ต่อ 1,000 รายการ) |
0.0256 USD ต่อ แต่ละรายการ (25.60 USD ต่อ 1,000 รายการ) |
ติดต่อฝ่ายขายเพื่อสอบถามราคาสำหรับการใช้งานจำนวนมาก |
คำขอการค้นหาข้อความแสดงรายการสถานที่ แต่ไม่รองรับการระบุว่าช่องใดแสดงผล คำขอการค้นหาข้อความจะแสดงชุดย่อยของช่องข้อมูลที่รองรับ ระบบจะเรียกเก็บเงินจากคุณสำหรับคำขอการค้นหาข้อความโดยเริ่มต้นที่ 0.032 USD ต่อคำขอ 1 รายการ รวมถึง SKU ประเภทข้อมูลทั้งหมด (ข้อมูลพื้นฐาน ข้อมูลติดต่อ และข้อมูลบรรยากาศ)
SKU สถานที่ – การค้นหาข้อความยังสร้างขึ้นโดยวิธี getPlaces()
วิดเจ็ตช่องค้นหาสถานที่ของ Maps JavaScript API getPlaces()
ด้วยหลังจากที่ผู้ใช้เลือกการค้นหาสถานที่ (ไอคอน: แว่นขยาย) ไม่ใช่ผลการค้นหา (ไอคอน: หมุด) ดังที่แสดงที่นี่
ตัวอย่าง
คุณส่งคําขอการค้นหาข้อความ เช่น 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()
แสดงผลเพื่อโหลดข้อมูลพิกเซลรูปภาพ - บริการผ่านเว็บ: คำขอไปยังบริการ Photos ของ Places API
สำหรับบริการ 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 นั้นได้สำหรับช่วงเวลาที่เหลือของวันนั้นๆ