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

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

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

Places API ใช้รูปแบบการกําหนดราคาแบบจ่ายเมื่อใช้ SKU ของ Google Maps Platform และ SDK จะเรียกเก็บเงินโดย 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

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

ทริกเกอร์ SKU ข้อมูลอย่างน้อย 1 รายการ ได้แก่

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

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

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

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

SKU: ข้อมูลบรรยากาศ

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

  • Android: Place.Field.CURBSIDE_PICKUP, Place.Field.DELIVERY, 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 ต่อ 1000)		 ติดต่อฝ่ายขายเพื่อสอบถามเกี่ยวกับปริมาณ

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

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

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

คําขอเติมข้อความอัตโนมัติจากวิดเจ็ตการเติมข้อความอัตโนมัติของสถานที่ใน 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 แบบเติมข้อความอัตโนมัติโดยไม่มีรายละเอียดสถานที่ – ต่อเซสชันจะเรียกเก็บสําหรับเซสชันการเติมข้อความอัตโนมัติที่ไม่รวมคําขอรายละเอียดสถานที่ (ภายในไม่กี่นาทีหลังจากเริ่มต้นเซสชัน)

ช่วงความถี่รายเดือน
(ราคาต่อเซสชัน)
0-100,000 100,001-500,000 500,000+
0.017 USD ต่อ
(17.00 USD ต่อ 1,000)		 0.0136 USD ต่อ
(13.60 USD ต่อ 1000)		 ติดต่อฝ่ายขายเพื่อสอบถามเกี่ยวกับปริมาณ

ตัวอย่าง

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

Android

iOS

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

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

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

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

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

  • Android: การโทรไปที่ fetchPlace()
  • iOS: การโทรไปที่ fetchPlaceFromPlaceID:
  • บริการบนเว็บ: คําขอรายละเอียดสถานที่

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

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

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

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

ช่วงความถี่รายเดือน
(ราคาต่อเซสชัน)
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 ต่อ 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 ต่อ 1000)		 ติดต่อฝ่ายขายเพื่อสอบถามเกี่ยวกับปริมาณ

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

เมื่อคุณใช้ 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 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 ต่อ 1000)		 ติดต่อฝ่ายขายเพื่อสอบถามเกี่ยวกับปริมาณ

คําขอสถานที่ยังสร้าง 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 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 THB 0.00 THB 0.00 THB

ตัวอย่าง

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

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

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

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

ตัวอย่าง

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

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

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

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

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

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

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

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

ตัวอย่าง

คุณส่งคําขอการค้นหาข้อความ เช่น 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

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

ข้อกําหนดในการใช้งาน

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

จัดการต้นทุนการใช้งาน

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

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

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

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

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