การใช้งานและการเรียกเก็บเงินของ Places API

Places API (ใหม่) และ Places API ใช้รูปแบบการกำหนดราคาแบบจ่ายเมื่อใช้ คำขอ Places API (ใหม่) และ Places API จะสร้างการเรียกใช้ SKU หลายรายการ นอกจากข้อกำหนดในการใช้งานโดยรวมของ Google แล้ว ยังมีขีดจำกัดการใช้งานสำหรับ Places API โดยเฉพาะ จัดการต้นทุนและการใช้งานด้วยเครื่องมือที่มีให้ใช้งานในคอนโซล Google Cloud

วิธีการเรียกเก็บเงินสำหรับ Places API

Places API (ใหม่) และ Places API ใช้รูปแบบการเรียกเก็บเงินแบบจ่ายเมื่อใช้ ระบบจะเรียกเก็บเงินสำหรับ API และ SDK ของ Google Maps Platform ตาม SKU ระบบจะติดตามการใช้งานสำหรับ SKU แต่ละรายการ และ API หรือ SDK หนึ่งๆ อาจมีSKU ของผลิตภัณฑ์มากกว่า 1 รายการ ระบบจะคำนวณค่าใช้จ่ายดังนี้

การใช้งาน SKU × ราคาต่อการใช้งาน

ใช้เครื่องคำนวณราคาและการใช้งานเพื่อประมาณต้นทุนการใช้งานต่อ 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–100,000 100,001–500,000 500,000+
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–100,000 100,001–500,000 500,000+
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–100,000 100,001–500,000 500,000+
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–100,000 100,001–500,000 500,000+
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–100,000 100,001–500,000 500,000+
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–100,000 100,001–500,000 500,000+
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–100,000 100,001–500,000 500,000+
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.googleMapsUri, places.iconBackgroundColor, places.iconMaskBaseUri, places.id, places.location, places.name**, places.photos, places.plusCode, places.primaryType, places.primaryTypeDisplayName, places.pureServiceAreaBusiness, places.shortFormattedAddress, places.subDestinations, places.types, places.utcOffsetMinutes, places.viewport

* ช่อง places.googleMapsLinks อยู่ในระยะการทดลองใช้ก่อน GA และไม่มีค่าใช้จ่าย ซึ่งหมายความว่าการเรียกเก็บเงินจะเป็น $0 สำหรับการใช้งานในช่วงทดลองใช้

** ช่อง places.name มีชื่อทรัพยากรของสถานที่ในรูปแบบ places/PLACE_ID ใช้ places.displayName เพื่อเข้าถึงชื่อข้อความของสถานที่

ระดับการใช้งานรายเดือน
(ราคาต่อสาย)
0–100,000 100,001–500,000 500,000+
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–100,000 100,001–500,000 500,000+
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–100,000 100,001–500,000 500,000+
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–100,000 100,001–500,000 500,000+
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–100,000 100,001–500,000 500,000+
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–100,000 100,001–500,000 500,000+
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–100,000 100,001–500,000 500,000+
0.040 USD ต่อ
แต่ละรายการ(40.00 USD ต่อ 1,000 รายการ)		 0.032 USD ต่อ
แต่ละรายการ(32.00 USD ต่อ 1,000 รายการ)		 ติดต่อฝ่ายขายเพื่อสอบถามราคาสำหรับการใช้งานจำนวนมาก

SKU: Place Photo

ระบบจะเรียกเก็บเงินสำหรับ SKU Place Photo สำหรับคำขอไปยัง API แต่ละรายการ

ระดับการใช้งานรายเดือน
(ราคาต่อสาย)
0–100,000 100,001–500,000 500,000+
0.007 USD ต่อ
แต่ละรายการ(7.00 USD ต่อ 1,000 รายการ)		 0.0056 USD ต่อ
แต่ละรายการ(5.60 USD ต่อ 1,000 รายการ)		 ติดต่อฝ่ายขายเพื่อสอบถามราคาสำหรับการใช้งานจำนวนมาก

ราคาสำหรับ Places API

เกี่ยวกับเซสชันการเติมข้อความอัตโนมัติ

เซสชันการเติมข้อความอัตโนมัติจะมีคำขอการเติมข้อความอัตโนมัติบางรายการ (เพื่อดึงข้อมูลคำแนะนำเกี่ยวกับสถานที่ในขณะที่ผู้ใช้พิมพ์) และคำขอรายละเอียดสถานที่ไม่เกิน 1 รายการ (เพื่อดึงรายละเอียดเกี่ยวกับสถานที่ที่ผู้ใช้เลือก) ระบบจะส่งโทเค็นเซสชันเดียวกันไปยังฟีเจอร์เติมข้อความอัตโนมัติและคําขอรายละเอียดสถานที่ต่อๆ ไป เซสชันจะเริ่มต้นด้วยคําขอการเติมข้อความอัตโนมัติรายการแรก (ซึ่งมักจะเกิดขึ้นเมื่อผู้ใช้เริ่มพิมพ์) การเรียกใช้รายละเอียดสถานที่จะเกิดขึ้นเมื่อผู้ใช้เลือกคําแนะนําที่เติมข้อความอัตโนมัติรายการใดรายการหนึ่ง หากผู้ใช้ไม่เลือกคำแนะนำ ระบบจะไม่เรียกใช้รายละเอียดสถานที่

หลังจากผู้ใช้เลือกสถานที่ (เช่น มีการเรียกใช้รายละเอียดสถานที่) คุณต้องเริ่มเซสชันใหม่โดยใช้โทเค็นเซสชันใหม่

คุณสร้างเซสชันการเติมข้อความอัตโนมัติได้จาก 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: ข้อมูลพื้นฐาน

การใช้พารามิเตอร์ฟิลด์ในคำขอรายละเอียดสถานที่หรือค้นหาสถานที่ช่วยให้คุณจำกัดการตอบกลับให้แสดงเฉพาะฟิลด์ที่ระบุได้ ช่องในหมวดหมู่พื้นฐานจะรวมอยู่ในต้นทุนฐานของคำขอ 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–100,000 100,001–500,000 500,000+
ค่าขอสถานที่
+ 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–100,000 100,001–500,000 500,000+
ค่าขอสถานที่
+ 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–100,000 100,001–500,000 500,000+
ค่าขอสถานที่
+ 0.005 USD ต่อรายการ
(+ 5.00 USD ต่อ 1,000 รายการ)		 ค่าคำขอ Places
+ 0.004 USD ต่อรายการ
(+ 4.00 USD ต่อ 1,000 รายการ)		 ติดต่อฝ่ายขายเพื่อสอบถามราคาสำหรับการใช้งานจำนวนมาก

SKU: เติมข้อความอัตโนมัติ – ต่อคำขอ

ระบบจะเรียกเก็บเงินจาก SKU Autocomplete – Per Request สําหรับการเรียกใช้หรือคําขอเหล่านี้ที่ไม่มีโทเค็นเซสชัน

การเรียกใช้จากเซสชันการเติมข้อความอัตโนมัติที่ไม่ถูกต้อง (เช่น เซสชันที่ใช้โทเค็นเซสชันซ้ำ) จะมีการเรียกเก็บเงินตาม SKU การเติมข้อความอัตโนมัติ - ต่อคำขอด้วย

ระบบอาจเรียกเก็บเงินสำหรับคำขอการเติมข้อความอัตโนมัติจาก วิดเจ็ตการเติมข้อความอัตโนมัติของ Maps JavaScript API โดยใช้ SKU การเติมข้อความอัตโนมัติต่อคำขอในกรณีที่มีการเรียกใช้จากเซสชันการเติมข้อความอัตโนมัติที่ไม่ถูกต้อง กรณีนี้อาจเกิดขึ้นเมื่อผู้ใช้พิมพ์ที่อยู่หลายรายการที่แตกต่างกัน หรือคัดลอก/วางที่อยู่ต่างๆ ลงในวิดเจ็ต และไม่ได้เลือกการคาดคะเนการเติมข้อความอัตโนมัติเสมอไป

ปริมาณรายเดือน
(ราคาต่อคำขอ)
0–100,000 100,001–500,000 500,000+
0.00283 USD ต่อ
แต่ละรายการ(2.83 USD ต่อ 1,000 รายการ)		 0.00227 USD ต่อ
แต่ละรายการ(2.27 USD ต่อ 1,000 รายการ)		 ติดต่อฝ่ายขายเพื่อสอบถามราคาสำหรับการใช้งานจำนวนมาก

SKU: ฟีเจอร์เติมข้อความอัตโนมัติโดยไม่มีรายละเอียดสถานที่ – ต่อเซสชัน

ระบบจะเรียกเก็บเงินจาก SKU การเติมข้อความอัตโนมัติโดยไม่มีรายละเอียดสถานที่ตั้ง – ต่อเซสชันสำหรับเซสชันการเติมข้อความอัตโนมัติที่ไม่มีคำขอรายละเอียดสถานที่ตั้ง (ภายใน 2-3 นาทีหลังจากเริ่มเซสชัน)

RANGE ของปริมาณรายเดือน
(ราคาต่อเซสชัน)
0–100,000 100,001–500,000 500,000+
0.017 USD ต่อ
1 รายการ(17.00 USD ต่อ 1,000 รายการ)		 0.0136 USD ต่อ
แต่ละรายการ(13.60 USD ต่อ 1,000 รายการ)		 ติดต่อฝ่ายขายเพื่อสอบถามราคาสำหรับการใช้งานจำนวนมาก

ตัวอย่าง

หากแอปพลิเคชันของคุณทำการเรียก 2 รายการนี้ในเซสชันเดียว

Android

iOS

บริการบนเว็บ

คุณจะเห็น SKU นี้แสดงอยู่ในใบเรียกเก็บเงิน (เมื่อดูใบเรียกเก็บเงินตาม SKU)

  • ฟีเจอร์เติมข้อความอัตโนมัติโดยไม่มีรายละเอียดสถานที่ – ต่อเซสชัน (ราคาเริ่มต้นที่ 0.017 USD ต่อเซสชัน)

SKU: ฟีเจอร์เติมข้อความอัตโนมัติ (รวมอยู่ในรายละเอียดสถานที่) – ต่อเซสชัน

ระบบจะเรียกเก็บเงินจาก SKU การเติมข้อความอัตโนมัติ (รวมอยู่ในรายละเอียดสถานที่) – ต่อเซสชันสำหรับเซสชันการเติมข้อความอัตโนมัติที่มีรายการต่อไปนี้

  • Android: การเรียกใช้ fetchPlace()
  • iOS: การเรียกใช้ fetchPlaceFromPlaceID:
  • บริการผ่านเว็บ: คำขอรายละเอียดสถานที่

คำขอการเติมข้อความอัตโนมัติจะใช้งานได้โดยไม่มีค่าใช้จ่าย และการเรียกใช้รายละเอียดสถานที่ต่อๆ ไปจะมีการเรียกเก็บเงินตามราคาปกติของรายละเอียดสถานที่

คำขอรายละเอียดสถานที่จะสร้าง SKU ของข้อมูล (พื้นฐาน รายชื่อติดต่อ และ/หรือ บรรยากาศ) โดยขึ้นอยู่กับช่องที่ระบุในคำขอ

หากคุณไม่ได้ระบุช่องในคำขอรายละเอียดสถานที่ ระบบจะเรียกใช้ SKU ข้อมูลทั้งหมด (พื้นฐาน รายชื่อติดต่อ และบรรยากาศ)

ระบบจะเรียกเก็บเงินคำขอรีเฟรชรหัสรายละเอียดสถานที่ (คำขอที่ระบุเฉพาะช่อง place_id) ในเซสชันการเติมข้อความอัตโนมัติเป็น SKU: การเติมข้อความอัตโนมัติ โดยไม่มีรายละเอียดสถานที่ – ต่อเซสชัน

RANGE ของปริมาณรายเดือน
(ราคาต่อเซสชัน)
0–100,000 100,001–500,000 500,000+
0.00 USD 0.00 USD 0.00 USD

ตัวอย่าง

หากแอปพลิเคชันของคุณทำการเรียก 3 รายการต่อไปนี้ในเซสชันเดียว

Android

iOS

บริการบนเว็บ

ในใบเรียกเก็บเงิน คุณจะเห็น SKU เหล่านี้แสดงอยู่ (เมื่อดูใบเรียกเก็บเงินตาม SKU)

  • ฟีเจอร์เติมข้อความอัตโนมัติ (รวมอยู่ในรายละเอียดสถานที่) – ต่อเซสชัน (ระบบจะเรียกเก็บเงินที่ 0.00 USD)
  • รายละเอียดสถานที่ (ราคาเริ่มต้นที่ 0.017 USD ต่อเซสชัน)
  • ข้อมูลพื้นฐาน (ระบบจะเรียกเก็บเงินที่ 0.00 USD)

SKU: การเติมข้อความอัตโนมัติของคําค้นหา – ต่อคําขอ

ระบบจะเรียกเก็บเงิน SKU การเติมข้อความอัตโนมัติสำหรับคำค้นหา – ต่อคำขอสำหรับคำขอแต่ละรายการเพื่อดำเนินการต่อไปนี้

ปริมาณรายเดือน
(ราคาต่อคำขอ)
0–100,000 100,001–500,000 500,000+
0.00283 USD ต่อ
แต่ละรายการ(2.83 USD ต่อ 1,000 รายการ)		 0.00227 USD ต่อ
แต่ละรายการ(2.27 USD ต่อ 1,000 รายการ)		 ติดต่อฝ่ายขายเพื่อสอบถามราคาสำหรับการใช้งานจำนวนมาก

ระบบไม่รองรับการกำหนดราคาตามเซสชันการเติมข้อความอัตโนมัติโดยใช้การเติมข้อความอัตโนมัติของคําค้นหา การเรียกใช้รายละเอียดสถานที่ต่อๆ ไปจะมีการเรียกเก็บเงินตามราคาปกติของรายละเอียดสถานที่

SKU: รายละเอียดสถานที่

การเรียกใช้รายละเอียดสถานที่จะคิดค่าบริการดังนี้

ระดับการใช้งานรายเดือน
(ราคาต่อสาย)
0–100,000 100,001–500,000 500,000+
0.017 USD ต่อ
1 รายการ(17.00 USD ต่อ 1,000 รายการ)		 0.0136 USD ต่อ
แต่ละรายการ(13.60 USD ต่อ 1,000 รายการ)		 ติดต่อฝ่ายขายเพื่อสอบถามราคาสำหรับการใช้งานจำนวนมาก

SKU รายละเอียดสถานที่สร้างขึ้นจาก API ต่อไปนี้

เมื่อใช้ Web API และบริการ ระบบจะเรียกเก็บเงินสำหรับ SKU รายละเอียดสถานที่ไม่ว่าจะระบุโทเค็นเซสชันหรือไม่ก็ตาม

การเรียกหรือคําขอรายละเอียดสถานที่จะสร้าง SKU ของข้อมูล (พื้นฐาน รายชื่อติดต่อ และ/หรือ บรรยากาศ) ด้วย โดยขึ้นอยู่กับช่องที่ระบุในการเรียกหรือคําขอ หากไม่ได้ระบุช่องไม่ในคำขอหรือคําเรียกรายละเอียดสถานที่ ระบบจะเรียกใช้ SKU ข้อมูลทั้งหมด และระบบจะเรียกเก็บเงินจากคุณสำหรับคำขอหรือคําเรียกรายละเอียดสถานที่บวกค่าบริการของข้อมูลทั้งหมด

ตัวอย่าง

  1. โทรหรือส่งคำขออย่างใดอย่างหนึ่งต่อไปนี้
    • อุปกรณ์เคลื่อนที่: โทรหา fetchPlace() ใน Android หรือ fetchPlaceFromPlaceID: ใน iOS แล้วระบุเฉพาะช่อง ADDRESS
    • Web API หรือบริการ: ส่งคำขอรายละเอียดสถานที่และระบุเฉพาะช่องที่อยู่ ดังนี้ getPlaceDetails(fields: formatted_address)
    ในใบเรียกเก็บเงิน คุณจะเห็น SKU เหล่านี้แสดงอยู่ (เมื่อดูใบเรียกเก็บเงินตาม SKU)
    • รายละเอียดสถานที่ (ราคาเริ่มต้นที่ 0.017 USD ต่อเซสชัน)
    • ข้อมูลพื้นฐาน (ระบบจะเรียกเก็บเงินที่ 0.00 USD)
  2. โทรหรือส่งคำขออย่างใดอย่างหนึ่งต่อไปนี้
    • อุปกรณ์เคลื่อนที่: โทรหา fetchPlace() ใน Android หรือ fetchPlaceFromPlaceID: ใน iOS แล้วระบุเฉพาะช่อง PHONE_NUMBER
    • Web API หรือบริการ: ส่งคําขอรายละเอียดสถานที่และระบุช่องหมายเลขโทรศัพท์ ดังนี้ getPlaceDetails(fields: formatted_phone_number)
    ในใบเรียกเก็บเงิน คุณจะเห็น SKU เหล่านี้แสดงอยู่ (เมื่อดูใบเรียกเก็บเงินตาม SKU)
    • รายละเอียดสถานที่ (ราคาเริ่มต้นที่ 0.017 USD ต่อเซสชัน)
    • ข้อมูลติดต่อ (ราคาเริ่มต้นที่ 0.003 USD ต่อคำขอ)
  3. โทรหรือส่งคำขออย่างใดอย่างหนึ่งต่อไปนี้
    • อุปกรณ์เคลื่อนที่: โทรหา fetchPlace() ใน Android หรือ fetchPlaceFromPlaceID: ใน iOS แล้วระบุข้อมูลในช่องทั้งหมด
    • Web API หรือบริการ: ส่งคำขอรายละเอียดสถานที่และระบุช่องทั้งหมด (คำขอประเภทนี้เป็นค่าเริ่มต้นหากคุณไม่ได้ระบุช่องใดเลย) getPlaceDetails()
    ในใบเรียกเก็บเงิน คุณจะเห็น SKU เหล่านี้แสดงอยู่ (เมื่อดูใบเรียกเก็บเงินตาม SKU)
    • รายละเอียดสถานที่ (ราคาเริ่มต้นที่ 0.017 USD ต่อเซสชัน)
    • ข้อมูลพื้นฐาน (ระบบจะเรียกเก็บเงินที่ 0.00 USD)
    • ข้อมูลติดต่อ (ราคาเริ่มต้นที่ 0.003 USD ต่อคำขอ)
    • ข้อมูลบรรยากาศ (ราคาเริ่มต้นที่ 0.005 USD ต่อคำขอ)

SKU: รายละเอียดสถานที่ – รีเฟรชรหัส

ใช้คำขอรายละเอียดสถานที่เพื่อ รีเฟรชรหัสสถานที่ที่ล้าสมัย คำขอประเภทเหล่านี้ไม่มีค่าใช้จ่าย

ระดับการใช้งานรายเดือน
(ราคาต่อสาย)
0–100,000 100,001–500,000 500,000+
0.00 USD 0.00 USD 0.00 USD

ตัวอย่าง

ส่งคำขอรายละเอียดสถานที่โดยระบุเฉพาะช่องรหัสสถานที่ ดังนี้ getPlaceDetails(fields: place_id) คุณจะเห็น SKU นี้แสดงอยู่ในใบเรียกเก็บเงิน (เมื่อดูใบเรียกเก็บเงินตาม SKU)

  • รายละเอียดสถานที่ – รีเฟรชรหัส (ระบบจะเรียกเก็บเงิน 0.00 USD)

SKU: ค้นหาสถานที่

ระบบจะเรียกเก็บเงินจาก Find Place สำหรับคำขอค้นหาสถานที่

ระดับการใช้งานรายเดือน
(ราคาต่อสาย)
0–100,000 100,001–500,000 500,000+
0.017 USD ต่อ
1 รายการ(17.00 USD ต่อ 1,000 รายการ)		 0.0136 USD ต่อ
แต่ละรายการ(13.60 USD ต่อ 1,000 รายการ)		 ติดต่อฝ่ายขายเพื่อสอบถามราคาสำหรับการใช้งานจำนวนมาก

คำขอค้นหาสถานที่จะสร้าง Data SKU (Basic, Contact และ/หรือ Atmosphere) ด้วย โดยขึ้นอยู่กับช่องที่ระบุในคำขอ คุณสามารถใช้พารามิเตอร์ฟิลด์ในคำขอค้นหาสถานที่เพื่อจำกัดการตอบกลับให้แสดงเฉพาะฟิลด์ที่ระบุได้ เช่นเดียวกับคำขอรายละเอียดสถานที่ ระบบจะเรียกเก็บเงินจากคุณสำหรับคำขอค้นหาสถานที่และข้อมูลที่ขอ โดยค่าเริ่มต้น หากมีการขอช่อง NO ระบบจะแสดงเฉพาะรหัสสถานที่เท่านั้น เพื่อไม่ให้มีการเรียกเก็บค่าอินเทอร์เน็ตเพิ่มเติม

ตัวอย่าง

  1. คุณส่งคำขอค้นหาสถานที่และระบุเฉพาะช่องที่อยู่ ดังนี้ FindPlace(fields: formatted_address) ในใบเรียกเก็บเงิน คุณจะเห็น SKU เหล่านี้แสดงอยู่ (เมื่อ ดูใบเรียกเก็บเงินตาม SKU)
    • ค้นหาสถานที่ (ราคาเริ่มต้นที่ 0.017 USD ต่อสาย)
    • ข้อมูลพื้นฐาน (ระบบจะเรียกเก็บเงินที่ 0.00 USD)
  2. คุณส่งคำขอค้นหาสถานที่และระบุช่องหมายเลขโทรศัพท์ ดังนี้ FindPlace(fields: formatted_phone_number) ในใบเรียกเก็บเงิน คุณจะเห็น SKU เหล่านี้แสดงอยู่ (เมื่อ ดูใบเรียกเก็บเงินตาม SKU)
    • ค้นหาสถานที่ (ราคาเริ่มต้นที่ 0.017 USD ต่อสาย)
    • ข้อมูลติดต่อ (ราคาเริ่มต้นที่ 0.003 USD ต่อคำขอ)
  3. คุณส่งคําขอค้นหาสถานที่และระบุช่องจากที่เก็บข้อมูลประเภทข้อมูลทั้ง 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–100,000 100,001–500,000 500,000+
0.00 USD 0.00 USD 0.00 USD

ตัวอย่าง

คุณส่งคำขอค้นหาสถานที่และระบุเฉพาะช่อง place_id: FindPlace(fields: place_id) คุณจะเห็น SKU นี้แสดงอยู่ในใบเรียกเก็บเงิน (เมื่อดูใบเรียกเก็บเงินตาม SKU)

  • ค้นหาสถานที่ – รหัสเท่านั้น (เรียกเก็บเงินที่ 0.00 USD)

สถานที่ – การค้นหาใกล้เคียงจะเรียกเก็บเงินสำหรับคำขอไปยัง บริการการค้นหาสถานที่ใกล้เคียงของ Maps JavaScript API (nearbySearch()) หรือไปยัง บริการการค้นหาใกล้เคียงของ Places API

ระดับการใช้งานรายเดือน
(ราคาต่อสาย)
0–100,000 100,001–500,000 500,000+
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 ต่อสาย)
  • ข้อมูลพื้นฐาน (ระบบจะเรียกเก็บเงินที่ 0.00 USD)
  • ข้อมูลติดต่อ (ราคาเริ่มต้นที่ 0.003 USD ต่อคำขอ)
  • ข้อมูลบรรยากาศ (ราคาเริ่มต้นที่ 0.005 USD ต่อคำขอ)

SKU: สถานที่ – การค้นหาข้อความ

สถานที่ตั้ง – การค้นหาข้อความจะเรียกเก็บเงินสำหรับคำขอไปยัง บริการค้นหาข้อความสถานที่ตั้งของ Maps JavaScript API (textSearch()) หรือไปยัง บริการค้นหาข้อความของ Places API

ระดับการใช้งานรายเดือน
(ราคาต่อสาย)
0–100,000 100,001–500,000 500,000+
0.032 USD ต่อ
แต่ละรายการ(32.00 USD ต่อ 1,000 รายการ)		 0.0256 USD ต่อ
แต่ละรายการ(25.60 USD ต่อ 1,000 รายการ)		 ติดต่อฝ่ายขายเพื่อสอบถามราคาสำหรับการใช้งานจำนวนมาก

คำขอการค้นหาข้อความจะแสดงรายการสถานที่ แต่ไม่รองรับการระบุช่องที่จะแสดงผล คำขอการค้นหาข้อความจะแสดงชุดย่อยของช่องข้อมูลที่รองรับ ระบบจะเรียกเก็บเงินจากคุณสำหรับคำขอการค้นหาข้อความโดยเริ่มต้นที่ 0.032 USD ต่อคำขอ 1 รายการ รวมถึง SKU ประเภทข้อมูลทั้งหมด (ข้อมูลพื้นฐาน ข้อมูลติดต่อ และข้อมูลบรรยากาศ)

SKU สถานที่ – การค้นหาข้อความยังสร้างขึ้นโดยวิธี วิดเจ็ตช่องค้นหาสถานที่ของ Maps JavaScript API getPlaces() ด้วยหลังจากที่ผู้ใช้เลือกการค้นหาสถานที่ (ไอคอน: แว่นขยาย) ไม่ใช่ผลการค้นหา (ไอคอน: หมุด) ดังที่แสดงที่นี่

การเลือกการค้นหาของวิดเจ็ตช่องค้นหารายละเอียดสถานที่
ในผลการค้นหาของวิดเจ็ตช่องค้นหา หลังจากพิมพ์ "pizza" ในช่องค้นหาแล้ว ให้สังเกตว่าการนำส่งพิซซ่ามีไอคอนแว่นขยายอยู่ข้างๆ ซึ่งบ่งบอกว่าเป็นการค้นหาสถานที่ (ไม่ใช่ผลการค้นหา)

ตัวอย่าง

คุณส่งคําขอการค้นหาข้อความ เช่น TextSearch(123 Main Street) ในใบเรียกเก็บเงิน คุณจะเห็น SKU เหล่านี้แสดงอยู่ (เมื่อดูใบเรียกเก็บเงินตาม SKU)

  • สถานที่ - การค้นหาข้อความ (ราคาเริ่มต้นที่ 0.032 USD ต่อสาย)
  • ข้อมูลพื้นฐาน (ระบบจะเรียกเก็บเงินที่ 0.00 USD)
  • ข้อมูลติดต่อ (ราคาเริ่มต้นที่ 0.003 USD ต่อคำขอ)
  • ข้อมูลบรรยากาศ (ราคาเริ่มต้นที่ 0.005 USD ต่อคำขอ)

SKU: รูปภาพสถานที่

ระบบจะเรียกเก็บเงินสำหรับ SKU รูปภาพในสถานที่ในกรณีต่อไปนี้

สําหรับบริการ JavaScript การเรียกใช้เมธอด PlacePhoto.getUrl() จะไม่ทําให้เกิดการเรียกเก็บเงินจนกว่าจะมีการใช้ URL เพื่อรับข้อมูลพิกเซลจริง

ระดับการใช้งานรายเดือน
(ราคาต่อสาย)
0–100,000 100,001–500,000 500,000+
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

  1. ในคอนโซลระบบคลาวด์ ให้เปิดหน้าโควต้าของ Google Maps Platform
  2. คลิกเมนูแบบเลื่อนลงของ API แล้วเลือก Places API
  3. หากต้องการดูขีดจํากัดโควต้า ให้เลื่อนลงไปที่การ์ดคําขอ
    ตารางจะแสดงชื่อและขีดจํากัดโควต้า
  4. หากต้องการเปลี่ยนขีดจำกัดโควต้า ให้คลิกไอคอนแก้ไขสำหรับขีดจำกัดนั้น
    ในกล่องโต้ตอบที่ปรากฏขึ้น ให้ป้อนขีดจำกัดโควต้ารายวันที่เรียกเก็บเงินได้ที่ต้องการ (ไม่เกินขีดจำกัดโควต้าที่ Google ระบุไว้ หากมี) ในช่องขีดจำกัดโควต้า แล้วเลือกบันทึก

หากการใช้งาน API ของคุณถึงขีดจํากัดโควต้าที่เรียกเก็บเงินได้ในวันใดวันหนึ่ง แอปพลิเคชันของคุณจะไม่สามารถเข้าถึง API ได้อีกตลอดทั้งวัน