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

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

Places API จะถูกเรียกเก็บเงินอย่างไร

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

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

ใช้เครื่องคํานวณราคาและการใช้งานเพื่อประมาณค่าใช้จ่ายการใช้งานต่อ API หรือ SDK สําหรับ SKU ของ Google Maps Platform ที่ผ่านการรับรอง เครดิต Google Maps Platform มูลค่า $200 USD ต่อเดือนสําหรับแต่ละบัญชีสําหรับการเรียกเก็บเงิน โดยระบบจะให้เครดิตนี้1กับ SKU ที่มีคุณสมบัติโดยอัตโนมัติ

การกําหนดราคาสําหรับ Places API

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

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

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

คุณสามารถสร้างเซสชันการเติมข้อความอัตโนมัติจาก API ต่อไปนี้

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

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

เกี่ยวกับ SKU ข้อมูลของ Places

Places Data SKU มี 3 แบบ ได้แก่ ข้อมูลพื้นฐาน ข้อมูลติดต่อ และข้อมูลบรรยากาศ

มีการเรียกใช้ SKU ของข้อมูลอย่างน้อย 1 รายการในกรณีต่อไปนี้

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

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

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

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

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

การใช้พารามิเตอร์ช่องในคําขอรายละเอียดสถานที่หรือการค้นหาสถานที่ช่วยให้คุณจํากัดคําตอบเฉพาะช่องที่ระบุได้ ช่องในหมวดหมู่พื้นฐานจะรวมอยู่ในราคาฐานของคําขอ Places และไม่ทําให้เกิดการเรียกเก็บเงินเพิ่มเติม ระบบจะทริกเกอร์ 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, GMSPlaceFieldBusinesssStatus, 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 ต่อ 1000 คน)		 คําขอสถานที่
+ 0.0024 USD ต่อสถานที่
(+ 2.40 USD ต่อ 1000 คน)		 ติดต่อฝ่ายขายเพื่อสอบถามราคา

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 ต่อ 1000)		 คําขอสถานที่มีค่าใช้จ่าย
+ 0.004 USD ต่อราย
(+ 4.00 USD ต่อ 1000 คน)		 ติดต่อฝ่ายขายเพื่อสอบถามราคา

SKU: การเติมข้อความอัตโนมัติ - ตามคําขอ

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

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

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

ช่วงความถี่รายเดือน
(ราคาต่อคําขอ)
0-100,000 100,001–500,000 คน มากกว่า 500,000
0.00283 USD ต่อ
(2.83 USD ต่อ 1000)		 0.00227 USD ต่อ
แต่ละรายการ(2.27 USD ต่อ 1,000)		 ติดต่อฝ่ายขายเพื่อสอบถามราคา

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

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

ช่วง VOLUME รายเดือน
(ราคาต่อ 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: เติมข้อความอัตโนมัติ โดยไม่มีรายละเอียดสถานที่ – ต่อเซสชัน

ช่วง VOLUME รายเดือน
(ราคาต่อ 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 ต่อเซสชัน)
  • ข้อมูลพื้นฐาน (เรียกเก็บเงิน 0.00 USD)

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

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

ช่วงความถี่รายเดือน
(ราคาต่อคําขอ)
0-100,000 100,001–500,000 คน มากกว่า 500,000
0.00283 USD ต่อ
(2.83 USD ต่อ 1000)		 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 ต่อเซสชัน)
    • ข้อมูลพื้นฐาน (เรียกเก็บเงิน 0.00 USD)
  2. โทรออกหรือส่งคําขออย่างใดอย่างหนึ่งต่อไปนี้
    • อุปกรณ์เคลื่อนที่: เรียกใช้ fetchPlace() ใน Android หรือ fetchPlaceFromPlaceID: ใน iOS และระบุเฉพาะช่อง PHONE_NUMBER
    • Web API หรือบริการ: สร้างคําขอรายละเอียดสถานที่และระบุช่องหมายเลขโทรศัพท์ getPlaceDetails(fields: formatted_phone_number)
    คุณจะเห็น SKU เหล่านี้ในใบเรียกเก็บเงิน (เมื่อดูใบเรียกเก็บเงินตาม SKU)
    • รายละเอียดสถานที่ (ราคาเริ่มต้น 0.017 USD ต่อเซสชัน)
    • ข้อมูลรายชื่อติดต่อ (ราคาเริ่มต้นที่ 0.003 THB ต่อคําขอ)
  3. โทรออกหรือส่งคําขออย่างใดอย่างหนึ่งต่อไปนี้
    • อุปกรณ์เคลื่อนที่: เรียกใช้ fetchPlace() ใน Android หรือ fetchPlaceFromPlaceID: ใน iOS และระบุช่องทั้งหมด
    • Web API หรือบริการ: สร้างคําขอ "รายละเอียดสถานที่" และระบุช่องทั้งหมด (คําขอประเภทนี้จะเป็นค่าเริ่มต้นหากคุณไม่ระบุช่องใดๆ): getPlaceDetails()
    คุณจะเห็น SKU เหล่านี้ในใบเรียกเก็บเงิน (เมื่อดูใบเรียกเก็บเงินตาม SKU)
    • รายละเอียดสถานที่ (ราคาเริ่มต้น 0.017 USD ต่อเซสชัน)
    • ข้อมูลพื้นฐาน (เรียกเก็บเงิน 0.00 USD)
    • ข้อมูลรายชื่อติดต่อ (ราคาเริ่มต้นที่ 0.003 THB ต่อคําขอ)
    • ข้อมูลบรรยากาศ (ราคาเริ่มต้นที่ 0.005 THB ต่อคําขอ)

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: ค้นหาสถานที่

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

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

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

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

ช่วงความถี่รายเดือน
(ราคาต่อการโทร)
0-100,000 100,001–500,000 คน มากกว่า 500,000
0.00 THB 0.00 THB 0.00 THB

ตัวอย่าง

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

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

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 ต่อ 1000)		 ติดต่อฝ่ายขายเพื่อสอบถามราคา

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

ตัวอย่าง

คุณสร้างคําขอการค้นหาใกล้เคียง เช่น NearbySearch (San Francisco, 100 meters) คุณจะเห็น SKU เหล่านี้ในใบเรียกเก็บเงิน (เมื่อดูการเรียกเก็บเงินตาม SKU) ให้ทําดังนี้

  • สถานที่ - ค้นหาใกล้เคียง (ราคาเริ่มต้น 0.032 USD ต่อการโทรหนึ่งครั้ง)
  • ข้อมูลพื้นฐาน (เรียกเก็บเงิน 0.00 USD)
  • ข้อมูลรายชื่อติดต่อ (ราคาเริ่มต้นที่ 0.003 THB ต่อคําขอ)
  • ข้อมูลบรรยากาศ (ราคาเริ่มต้นที่ 0.005 THB ต่อคําขอ)

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

Place – Text Search จะเรียกเก็บเงินสําหรับคําขอที่ส่งไปยัง บริการ Place Text API ของ Maps JavaScript API (textSearch()) หรือไปที่ Places API Text Search Search

ช่วงความถี่รายเดือน
(ราคาต่อการโทร)
0-100,000 100,001–500,000 คน มากกว่า 500,000
0.032 USD ต่อภาษา
(32.00 USD ต่อ 1,000)		 0.0256 USD ต่อภาษา
(25.60 USD ต่อ 1000)		 ติดต่อฝ่ายขายเพื่อสอบถามราคา

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

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

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

ตัวอย่าง

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

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

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

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

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

ช่วงความถี่รายเดือน
(ราคาต่อการโทร)
0-100,000 100,001–500,000 คน มากกว่า 500,000
0.007 USD ต่อ
(7.00 USD ต่อ 1000)		 0.0056 USD ต่อ
(5.60 USD ต่อ 1000)		 ติดต่อฝ่ายขายเพื่อสอบถามราคา

ขีดจํากัดการใช้งานอื่นๆ

แม้จะไม่มีจํานวนคําขอสูงสุดต่อวัน แต่ขีดจํากัดการใช้งานต่อไปนี้จะยังคงมีผลเมื่อใช้ Places API

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

ข้อจํากัดของข้อกําหนดในการให้บริการ

สําหรับข้อมูลเกี่ยวกับข้อกําหนดในการให้บริการ โปรดดู นโยบายสําหรับ Places API และ ส่วนข้อจํากัดใบอนุญาต ของข้อกําหนดในการให้บริการของ Google Maps Platform

จัดการต้นทุนการใช้งานของคุณ

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

หากต้องการดูหรือเปลี่ยนแปลงขีดจํากัดของโควต้าสําหรับ Places API ให้ทําดังนี้

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

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

  1. ผู้ใช้ในอินเดียต้องสร้างบัญชีสําหรับการเรียกเก็บเงินของ Google Cloud Platform ก่อนสร้างบัญชีสําหรับการเรียกเก็บเงินของ Google Maps Platform เพื่อรับเครดิต Maps Platform↩