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

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

การเรียกเก็บเงินของ Places API

Places API (ใหม่) และ Places API ใช้รูปแบบการกำหนดราคาแบบจ่ายเมื่อใช้ Google Maps Platform API และ SDK เรียกเก็บเงินตาม 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 รายการ และคำขอรายละเอียดสถานที่ (ใหม่) หรือคำขอตรวจสอบที่อยู่ ระบบจะส่งโทเค็นเซสชันเดียวกันไปยังคำขอเติมข้อความอัตโนมัติ (ใหม่) และไปยังคำขอรายละเอียดสถานที่ (ใหม่) หรือคำขอตรวจสอบที่อยู่ที่ตามมา

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

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

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

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

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

นอกจากนี้จะมีการเรียกเก็บเงินหากคุณใช้โทเค็นเซสชันและ

  • สิ้นสุดเซสชันโดยคำขอเดียวไปยังรายละเอียดสถานที่ (ใหม่) ที่ขอช่องใดๆ ที่กำหนดโดย SKU: รายละเอียดสถานที่ (สถานที่เท่านั้น)
    • ระบบจะเรียกเก็บเงินจากคำขอเติมข้อความอัตโนมัติ (ใหม่) แต่ละรายการที่มีคำขอสูงสุด 12 รายการโดยใช้ SKU: คำขอเติมข้อความอัตโนมัติ
    • คำขอเติมข้อความอัตโนมัติ (ใหม่) ที่ตามมาแต่ละรายการจะถูกเรียกเก็บเงินโดยใช้ SKU: การใช้งานเซสชันการเติมข้อความอัตโนมัติ
  • ยกเลิกเซสชันหรือสิ้นสุดเซสชันโดยเรียกใช้ 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: การใช้เซสชันการเติมข้อความอัตโนมัติ

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

ระบบจะเรียกเก็บเงิน SKU นี้ในสถานการณ์ต่อไปนี้

  • เซสชันการเติมข้อความอัตโนมัติสิ้นสุดโดยการเรียกไปที่ SKU: รายละเอียดสถานที่ (สถานที่เท่านั้น):

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

  • เซสชันการเติมข้อความอัตโนมัติสิ้นสุดด้วยการเรียกไปที่ SKU: รายละเอียดสถานที่ (พื้นฐาน ขั้นสูง หรือที่ต้องการ)

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

  • เซสชันการเติมข้อความอัตโนมัติสิ้นสุดด้วยการเรียกไปยัง SKU: การยืนยันที่อยู่ ที่ต้องการ

ดูข้อมูลเพิ่มเติมได้ที่เติมข้อความอัตโนมัติ (ใหม่) และราคาเซสชัน

ช่วงระดับเสียงรายเดือน
(ราคาสำหรับการโทรหนึ่งครั้ง)
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, displayName, googleMapsUri, iconBackgroundColor, iconMaskBaseUri, primaryType, primaryTypeDisplayName, subDestinations, utcOffsetMinutes

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

ช่วงระดับเสียงรายเดือน
(ราคาสำหรับการโทรหนึ่งครั้ง)
0-100,000 100,001-500,000 มากกว่า 500,000 คน
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-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, {2/3}, restroomreviewsservesBeerservesBreakfastservesBrunchservesCocktailsservesCoffeeservesDessertservesDinnerservesLunchservesVegetarianFoodservesWinetakeout

หากเซสชันการเติมข้อความอัตโนมัติสิ้นสุดด้วยการเรียกรายละเอียดสถานที่ที่ขอช่องใดก็ได้จาก 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 นี้จะทำงานเมื่อคุณขอช่องต่อไปนี้เท่านั้น

{1/3] 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, }{2/2}places.accessibilityOptionsplaces.nameplaces.primaryTypeplaces.primaryTypeDisplayNameplaces.shortFormattedAddressplaces.subDestinationsplaces.typesplaces.utcOffsetMinutesplaces.viewport

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.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, {2/3}, places.restroomplaces.reviewsplaces.servesBeerplaces.servesBreakfastplaces.servesBrunchplaces.servesCocktailsplaces.servesCoffeeplaces.servesDessertplaces.servesDinnerplaces.servesLunchplaces.servesVegetarianFoodplaces.servesWineplaces.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.displayName, places.formattedAddress, places.googleMapsUri, places.iconBackgroundColor, places.iconMaskBaseUri, places.location, places.photos, places.plusCode, places.primaryType, places.primaryTypeDisplayName, places.shortFormattedAddress, places.subDestinations, places.subDestinations, places.subDestinations, places.typesplaces.utcOffsetMinutesplaces.viewport

ช่วงระดับเสียงรายเดือน
(ราคาสำหรับการโทรหนึ่งครั้ง)
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.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, {2/3}, places.restroomplaces.reviewsplaces.servesBeerplaces.servesBreakfastplaces.servesBrunchplaces.servesCocktailsplaces.servesCoffeeplaces.servesDessertplaces.servesDinnerplaces.servesLunchplaces.servesVegetarianFoodplaces.servesWineplaces.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 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 ข้อมูลสถานที่ทั้ง 3 ประเภท ได้แก่ ข้อมูลพื้นฐาน ข้อมูลติดต่อ และข้อมูลบรรยากาศ

มีการเรียก SKU ข้อมูลอย่างน้อย 1 รายการสำหรับรายการต่อไปนี้

  • Android: แต่ละคำขอไปยัง fetchPlace() หรือ findCurrentPlace()
  • iOS: การโทรมาที่ fetchPlaceFromPlaceID: หรือ findPlaceLikelihoodsFromCurrentLocationWithPlaceFields: แต่ละครั้ง
  • บริการผ่านเว็บ: คำขอ Places แต่ละรายการขึ้นอยู่กับช่องที่ระบุไว้ในคำขอ

SKU ข้อมูลจะมีการเรียกเก็บเงินเสมอนอกเหนือจาก SKU พื้นฐานสำหรับคำขอที่ทริกเกอร์ SKU ดังกล่าว ตัวอย่างเช่น คำขอรายละเอียดสถานที่ซึ่งรวมช่องข้อมูลพื้นฐานจะมีการเรียกเก็บเงินทั้งภายใต้ SKU ข้อมูลพื้นฐานและ SKU รายละเอียดสถานที่

สำหรับบริการบนเว็บ API ของ Places เหล่านี้จะเรียกใช้การสนับสนุนที่ระบุฟิลด์ข้อมูลที่จะแสดง:

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

SKU: ข้อมูลพื้นฐาน

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

  • Android: Place.Field.ADDRESS, Place.Field.ADDRESS_COMPONENTS, Place.Field.BUSINESS_STATUS, Place.Field.ICON_BACKGROUND_COLOR, Place.Field.ICON_URL, Place.Field.ID, Place.Field.LAT_LNG, Place.Field.NAME, Place.Field.PHOTO_METADATAS, Place.Field.PLUS_CODE, Place.Field.TYPES, Place.Field.VIEWPORT, Place.Field.UTC_OFFSET หรือ Place.Field.WHEELCHAIR_ACCESSIBLE_ENTRANCE
  • 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.OPENING_HOURS, Place.Field.PHONE_NUMBER, 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_RATINGS_TOTAL
  • 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)		 ค่าใช้จ่ายคำขอเกี่ยวกับสถานที่
+ 0.004 USD ต่อรายการ
(+ 4.00 USD ต่อ 1,000)		 ติดต่อฝ่ายขายเพื่อขอข้อมูลราคาปริมาณ

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

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

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

คำขอเติมข้อความอัตโนมัติจากวิดเจ็ตเติมข้อความอัตโนมัติใน Places ของ 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 นาทีนับจากการเริ่มต้นเซสชัน)

ช่วงระดับเสียงรายเดือน
(ราคาต่อ SESSION)
0-100,000 100,001-500,000 มากกว่า 500,000 คน
0.017 USD ต่อแต่ละรายการ
(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: เติมข้อความอัตโนมัติ โดยไม่มีรายละเอียดสถานที่ – ต่อเซสชัน

ช่วงระดับเสียงรายเดือน
(ราคาต่อ SESSION)
0-100,000 100,001-500,000 มากกว่า 500,000 คน
0.00 THB 0.00 THB 0.00 THB

ตัวอย่าง

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

Android

iOS

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

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

  • เติมข้อความอัตโนมัติ (รวมกับรายละเอียดสถานที่) – ต่อเซสชัน (เรียกเก็บเงิน 0.00 USD)
  • รายละเอียดสถานที่ (ราคาเริ่มต้นที่ 0.017 USD ต่อเซสชัน)
  • Basic Data (เรียกเก็บเงินที่ 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 ต่อแต่ละรายการ
(17.00 USD ต่อ 1,000)		 0.0136 USD ต่อแต่ละรายการ
(13.60 USD ต่อ 1,000)		 ติดต่อฝ่ายขายเพื่อขอข้อมูลราคาปริมาณ

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

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

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

ตัวอย่าง

  1. โทรหรือขอรายการใดรายการหนึ่งต่อไปนี้
    • อุปกรณ์เคลื่อนที่: เรียกใช้ fetchPlace() ใน Android หรือ fetchPlaceFromPlaceID: ใน iOS และระบุเฉพาะช่อง ADDRESS
    • Web API หรือบริการ: ส่งคำขอรายละเอียดสถานที่และระบุเฉพาะช่องที่อยู่ ดังนี้ getPlaceDetails(fields: formatted_address)
    ในใบเรียกเก็บเงิน คุณจะเห็น SKU เหล่านี้แสดงอยู่ (เมื่อดูการเรียกเก็บเงินตาม SKU)
    • รายละเอียดสถานที่ (ราคาเริ่มต้นที่ 0.017 USD ต่อเซสชัน)
    • Basic Data (เรียกเก็บเงินที่ 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 ต่อเซสชัน)
    • Basic Data (เรียกเก็บเงินที่ 0.00 USD)
    • ข้อมูลติดต่อ (ราคาเริ่มต้นที่ 0.003 USD ต่อคำขอ)
    • ข้อมูลบรรยากาศ (ราคาเริ่มต้นที่ 0.005 USD ต่อคำขอ)

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

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

ช่วงระดับเสียงรายเดือน
(ราคาสำหรับการโทรหนึ่งครั้ง)
0-100,000 100,001-500,000 มากกว่า 500,000 คน
0.00 THB 0.00 THB 0.00 THB

ตัวอย่าง

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

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

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

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

ช่วงระดับเสียงรายเดือน
(ราคาสำหรับการโทรหนึ่งครั้ง)
0-100,000 100,001-500,000 มากกว่า 500,000 คน
0.017 USD ต่อแต่ละรายการ
(17.00 USD ต่อ 1,000)		 0.0136 USD ต่อแต่ละรายการ
(13.60 USD ต่อ 1,000)		 ติดต่อฝ่ายขายเพื่อขอข้อมูลราคาปริมาณ

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

ตัวอย่าง

  1. คุณส่งคำขอค้นหาสถานที่และระบุเฉพาะช่องที่อยู่: FindPlace(fields: formatted_address) คุณจะเห็น SKU ต่อไปนี้ในใบเรียกเก็บเงิน (เมื่อ ดูใบเรียกเก็บเงินตาม SKU)
    • ค้นหาสถานที่ (ราคาเริ่มต้นที่ 0.017 USD ต่อการโทร)
    • Basic Data (เรียกเก็บเงินที่ 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 ต่อการโทร)
    • Basic Data (เรียกเก็บเงินที่ 0.00 USD)
    • ข้อมูลติดต่อ (ราคาเริ่มต้นที่ 0.003 USD ต่อคำขอ)
    • ข้อมูลบรรยากาศ (ราคาเริ่มต้นที่ 0.005 USD ต่อคำขอ)

SKU: ค้นหาสถานที่ – รหัสเท่านั้น

Find Place – ID เท่านั้นจะถูกเรียกเก็บเงินสำหรับคำขอ "Find Place" ซึ่งระบุเพียงรหัสสถานที่ที่จะส่งคืน โดยค่าเริ่มต้น ถ้าไม่มีการระบุช่องในคำขอค้นหาสถานที่ ระบบจะส่งคืนเฉพาะรหัสสถานที่เท่านั้น

ช่วงระดับเสียงรายเดือน
(ราคาสำหรับการโทรหนึ่งครั้ง)
0-100,000 100,001-500,000 มากกว่า 500,000 คน
0.00 THB 0.00 THB 0.00 THB

ตัวอย่าง

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

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

Place – การค้นหาใกล้เคียง จะมีการเรียกเก็บเงินสำหรับคำขอไปยัง บริการ Place Nearby Search ของ 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)		 ติดต่อฝ่ายขายเพื่อขอข้อมูลราคาปริมาณ

คำขอการค้นหาใกล้เคียงจะแสดงรายการสถานที่ แต่ไม่สนับสนุนการระบุช่องที่จะแสดง คำขอการค้นหาใกล้เคียงจะแสดงเซ็ตย่อยของช่องข้อมูลที่รองรับ ระบบจะเรียกเก็บค่าบริการสำหรับคำขอ Nearby Search ที่ราคาใบละ 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 – การค้นหาข้อความจะถูกเรียกเก็บเงินสำหรับคำขอไปยัง บริการ Place Text Search ของ Maps JavaScript API (textSearch()) หรือ บริการPlaces API Text Search

ช่วงระดับเสียงรายเดือน
(ราคาสำหรับการโทรหนึ่งครั้ง)
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 ต่อแต่ละรายการ รวมถึง SKU ประเภทข้อมูลทั้งหมด (ข้อมูลพื้นฐาน ข้อมูลติดต่อ และข้อมูลบรรยากาศ)

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

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

ตัวอย่าง

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

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

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

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

สำหรับบริการ 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 ใน Cloud Console
  2. คลิกเมนูแบบเลื่อนลง API และเลือก Places API
  3. หากต้องการดูขีดจำกัดโควต้า ให้เลื่อนลงไปที่การ์ดคำขอ
    ตารางแสดงชื่อโควต้าและขีดจำกัด
  4. หากต้องการเปลี่ยนขีดจำกัดโควต้า ให้คลิกไอคอนแก้ไขสำหรับขีดจำกัดนั้น
    ในกล่องโต้ตอบที่ปรากฏขึ้น ให้ป้อนขีดจำกัดโควต้ารายวันที่เรียกเก็บเงินได้ที่ต้องการ (ถึงขีดจำกัดโควต้าที่ Google ระบุไว้) แล้วเลือกบันทึก ในช่องขีดจำกัดโควต้า

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