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 รายการ ค่าใช้จ่ายคํานวณโดย
ใช้เครื่องคํานวณราคาและการใช้งานเพื่อประมาณค่าใช้จ่ายการใช้งานต่อ API หรือ SDK สําหรับ SKU ของ Google Maps Platform ที่ผ่านการรับรอง เครดิต Google Maps Platform มูลค่า $200 USD ต่อเดือนสําหรับแต่ละบัญชีสําหรับการเรียกเก็บเงิน โดยระบบจะให้เครดิตนี้1กับ SKU ที่มีคุณสมบัติโดยอัตโนมัติ
การกําหนดราคาสําหรับ Places API
เกี่ยวกับเซสชันการเติมข้อความอัตโนมัติ
เซสชันเติมข้อความอัตโนมัติมีคําขอที่เติมข้อความอัตโนมัติบางอย่าง (เพื่อดึงคําแนะนําของสถานที่ซึ่งเป็นประเภทของผู้ใช้) และคําขอรายละเอียดสถานที่มากที่สุด 1 รายการ (เพื่อดึงรายละเอียดเกี่ยวกับสถานที่ที่ผู้ใช้เลือก) ระบบจะส่งโทเค็นเซสชันเดียวกันไปยังการเติมข้อความอัตโนมัติ และคําขอรายละเอียดสถานที่ที่ตามมา เซสชันจะเริ่มต้นด้วยคําขอการเติมข้อความอัตโนมัติครั้งแรก (ซึ่งปกติจะเกิดขึ้นเมื่อผู้ใช้เริ่มพิมพ์) การเรียกรายละเอียดของ Places จะเกิดขึ้นเมื่อผู้ใช้เลือกหนึ่งในคําแนะนําที่เติมข้อความอัตโนมัติ หากผู้ใช้ไม่ได้เลือกคําแนะนํา ก็จะไม่มีการเรียกรายละเอียดสถานที่
หลังจากที่ผู้ใช้เลือกสถานที่ (นั่นคือการเรียกรายละเอียดสถานที่) คุณต้องเริ่มเซสชันใหม่โดยใช้โทเค็นเซสชันใหม่
คุณสามารถสร้างเซสชันการเติมข้อความอัตโนมัติจาก API ต่อไปนี้
- บริการเติมข้อความอัตโนมัติของ Places API หรือ บริการเติมข้อความอัตโนมัติของ Places API ของ Maps API คุณต้องออกแบบแอปพลิเคชันเพื่อระบุโทเค็นของเซสชัน (คุณอาจต้องเปลี่ยนโค้ดที่มีอยู่)
- วิดเจ็ตเติมข้อความอัตโนมัติของ Maps JavaScript 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.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.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.005 USD ต่อหน่วย (+ 5.00 USD ต่อ 1000) |
คําขอสถานที่มีค่าใช้จ่าย + 0.004 USD ต่อราย (+ 4.00 USD ต่อ 1000 คน) |
ติดต่อฝ่ายขายเพื่อสอบถามราคา |
SKU: การเติมข้อความอัตโนมัติ - ตามคําขอ
ระบบจะเรียกเก็บเงิน SKU จากการเติมข้อความอัตโนมัติ - ตามคําขอ สําหรับการโทรหรือคําขอที่ไม่มีโทเค็นของเซสชัน ดังนี้
- Android
findAutocompletePredictions()
- iOS:
findAutocompletePredictionsFromQuery:
- JavaScript: บริการเติมข้อความอัตโนมัติในแผนที่ JavaScript API
- บริการบนเว็บ: บริการเติมข้อความอัตโนมัติด้วย Places API
การโทรจากเซสชันของการเติมข้อความอัตโนมัติไม่ถูกต้อง (เช่น เซสชันที่ใช้โทเค็นเซสชันซ้ํา) จะถูกเรียกเก็บเงินด้วยการเติมข้อความอัตโนมัติ – ต่อ SKU คําขอ
คําขอเติมข้อความอัตโนมัติจาก วิดเจ็ตเติมข้อความ API ของ Maps JavaScript อาจถูกเรียกเก็บเงินสําหรับการเติมข้อความอัตโนมัติ – ตามคําขอ SKU ในกรณีที่ทําการโทรจากเซสชันการเติมข้อความอัตโนมัติที่ไม่ถูกต้อง กรณีนี้อาจเกิดขึ้นเมื่อผู้ใช้พิมพ์ที่อยู่ต่างๆ กันหลายที่อยู่ หรือคัดลอก/วางที่อยู่อื่นลงในวิดเจ็ต และไม่ได้เลือกการคาดคะเนการเติมข้อความอัตโนมัติเสมอไป
ช่วงความถี่รายเดือน (ราคาต่อคําขอ) |
||
---|---|---|
0.00283 USD ต่อ (2.83 USD ต่อ 1000) |
0.00227 USD ต่อ แต่ละรายการ(2.27 USD ต่อ 1,000) |
ติดต่อฝ่ายขายเพื่อสอบถามราคา |
SKU: เติมข้อความอัตโนมัติโดยไม่มีรายละเอียดสถานที่ – ต่อเซสชัน
ระบบจะเรียกเก็บเงิน SKU จากการเติมข้อความอัตโนมัติโดยไม่มีรายละเอียดสถานที่ – ต่อเซสชัน สําหรับเซสชันเติมข้อความอัตโนมัติที่ไม่รวมคําขอรายละเอียดสถานที่ (ภายในไม่กี่นาทีหลังจากเริ่มต้นเซสชัน)
ช่วง VOLUME รายเดือน (ราคาต่อ SESSION) |
||
---|---|---|
0.017 USD ต่อภาษา (17.00 USD ต่อ 1,000) |
0.0136 USD ต่อภาษา (13.60 USD ต่อ 1,000) |
ติดต่อฝ่ายขายเพื่อสอบถามราคา |
ตัวอย่าง
หากแอปพลิเคชันออกการโทร 2 สายนี้ในเซสชันเดียว
Android
- findAutocompletePredictions() (.setQuery(”par”), .setSessionToken(XYZ))
- findAutocompletePredictions() (.setQuery(”paris”), .setSessionToken(XYZ))
iOS
- placesClient..findAutocompletePredictions(fromQuery: "par" ...
- placesClient..findAutocompletePredictions(fromQuery: "paris" ...
บริการบนเว็บ
- ป้อนการเติมข้อความอัตโนมัติ (input=”par”, session_token: XYZ)
- คําขอเติมข้อความอัตโนมัติในสถานที่ (input=”paris” session_token: XYZ)
คุณจะเห็น SKU นี้ในใบเรียกเก็บเงิน (เมื่อดูการเรียกเก็บเงินตาม SKU) ให้ทําดังนี้
- เติมข้อความอัตโนมัติโดยไม่มีรายละเอียดสถานที่ – ต่อเซสชัน (ราคาเริ่มต้นที่ 0.017 USD ต่อเซสชัน)
SKU: การเติมข้อความอัตโนมัติ (รวมอยู่กับรายละเอียดสถานที่) – ต่อเซสชัน
การเติมข้อความอัตโนมัติ (รวมอยู่กับรายละเอียดสถานที่) – SKU ต่อเซสชัน จะถูกเรียกเก็บเงินสําหรับเซสชันเติมข้อความอัตโนมัติ ที่มีสิ่งต่อไปนี้
- Android: โทรหา
fetchPlace()
- iOS: การโทรติดต่อ
fetchPlaceFromPlaceID:
- บริการบนเว็บ: คําขอรายละเอียดสถานที่
คําขอเติมข้อความอัตโนมัติพร้อมใช้งานโดยไม่มีค่าใช้จ่าย และการเรียกใช้รายละเอียดสถานที่ในครั้งต่อๆ ไปจะยึดตามราคารายละเอียดสถานที่ปกติ
คําขอรายละเอียดสถานที่จะสร้าง SKU ข้อมูล (พื้นฐาน รายชื่อติดต่อ และ/หรือบรรยากาศ) ทั้งนี้ขึ้นอยู่กับช่องที่ระบุไว้ในคําขอ
หากคุณไม่ระบุช่องในคําขอรายละเอียดสถานที่ ระบบจะเรียกให้ SKU ข้อมูลทั้งหมดทํางาน (พื้นฐาน รายชื่อติดต่อ และบรรยากาศ)
คําขอรีเฟรชรหัสรายละเอียดสถานที่ (คําขอที่ระบุเฉพาะช่อง place_id
) ระหว่างเซสชันเติมข้อความอัตโนมัติจะถูกเรียกเก็บเงินเป็น SKU: เติมข้อความอัตโนมัติ
โดยไม่มีรายละเอียดสถานที่ – ต่อเซสชัน
ช่วง VOLUME รายเดือน (ราคาต่อ SESSION) |
||
---|---|---|
0.00 THB | 0.00 THB | 0.00 THB |
ตัวอย่าง
หากแอปพลิเคชันออกการเรียก 3 รายการต่อไปนี้ในเซสชันเดียว
Android
- findAutocompletePredictions() (.setQuery(”par”), .setSessionToken(XYZ))
- findAutocompletePredictions() (.setQuery(”paris”), .setSessionToken(XYZ))
- fetchPlace() (มี
FetchPlaceRequest
รวมรหัสสถานที่และช่อง ADDRESS)
iOS
- placesClient..findAutocompletePredictions(fromQuery: "par" ...
- placesClient..findAutocompletePredictions(fromQuery: "paris" ...
- fetchPlaceFromPlaceID:
(รวมถึงรหัสสถานที่และช่อง
GMSPlaceFieldFormattedAddress
)
บริการบนเว็บ
- คําขอเติมข้อความสถานที่อัตโนมัติ (input=”par”, session_token: XYZ)
- คําขอเติมข้อความสถานที่อัตโนมัติ (input=”paris”, session_token: XYZ)
- รายละเอียดสถานที่ (place_id, session_token: XYZ, ช่อง:formatted_address)
คุณจะเห็น SKU เหล่านี้ในใบเรียกเก็บเงิน (เมื่อดูการเรียกเก็บเงินตาม SKU) ให้ทําดังนี้
- เติมข้อความอัตโนมัติ (รวมอยู่ในรายละเอียดสถานที่) – ต่อเซสชัน (เรียกเก็บเงิน 0.00 USD)
- รายละเอียดสถานที่ (ราคาเริ่มต้น 0.017 USD ต่อเซสชัน)
- ข้อมูลพื้นฐาน (เรียกเก็บเงิน 0.00 USD)
SKU: เติมข้อความค้นหาอัตโนมัติ – ตามคําขอ
ระบบจะเรียกเก็บเงิน SKU ของการเติมข้อความค้นหาอัตโนมัติ – ต่อคําขอ สําหรับคําขอแต่ละรายการดังนี้
- JavaScript:
บริการเติมข้อความอัตโนมัติของ Places ใน JavaScript API (
getQueryPredictions()
) และใช้ วิดเจ็ต SearchBox ของ Maps JavaScript API (คําขอเติมข้อความอัตโนมัติสร้างขึ้นเป็นประเภทผู้ใช้) - บริการเว็บ: บริการเติมข้อความอัตโนมัติใน API สถานที่
ช่วงความถี่รายเดือน (ราคาต่อคําขอ) |
||
---|---|---|
0.00283 USD ต่อ (2.83 USD ต่อ 1000) |
0.00227 USD ต่อ แต่ละรายการ(2.27 USD ต่อ 1,000) |
ติดต่อฝ่ายขายเพื่อสอบถามราคา |
การเติมข้อความอัตโนมัติไม่รองรับการกําหนดราคาตามเซสชันการเติมข้อความอัตโนมัติ การโทรสําหรับรายละเอียดสถานที่ในภายหลังจะถูกเรียกเก็บเงินโดยอิงจากราคาสําหรับรายละเอียดสถานที่แบบปกติ
SKU: รายละเอียดสถานที่
การเรียกรายละเอียดของสถานที่จะมีการเรียกเก็บเงินดังนี้
ช่วงความถี่รายเดือน (ราคาต่อการโทร) |
||
---|---|---|
0.017 USD ต่อภาษา (17.00 USD ต่อ 1,000) |
0.0136 USD ต่อภาษา (13.60 USD ต่อ 1,000) |
ติดต่อฝ่ายขายเพื่อสอบถามราคา |
SKU ของรายละเอียดสถานที่สร้างขึ้นจาก API ต่อไปนี้
- Android: Places SDK สําหรับ Android
(
fetchPlace()
) - iOS: Places SDK สําหรับ iOS
(
fetchPlaceFromPlaceID:
) - JavaScript:
บริการข้อมูลรายละเอียดสถานที่ของ Maps JavaScript API (
getDetails
) - JavaScript:
วิดเจ็ตการเติมข้อความอัตโนมัติของ Places ใน JavaScript API (
getPlace
) - JavaScript:
วิดเจ็ตสถานที่ใน Search Console ของ Maps JavaScript API:
getPlaces()
เมธอดหลังจากผู้ใช้เลือกผลการค้นหาสถานที่ (ไอคอน: หมุด), *ไม่ใช่* คําค้นหา (ไอคอน: แว่นขยาย) ดังที่แสดงที่นี่ในผลลัพธ์ของวิดเจ็ตช่องค้นหา หลังจากพิมพ์ "พิซซ่า" ในช่องค้นหา ให้สังเกตว่า Pazza Autentico มีไอคอนหมุดอยู่ข้างๆ สถานที่ (ไม่ใช่ไอคอน) ซึ่งแสดงว่าไอคอนนั้นอยู่ข้างๆ - บริการบนเว็บ: บริการรายละเอียดสถานที่ของ Places API
เมื่อใช้ API เว็บและบริการ ระบบจะเรียกเก็บเงิน SKU รายละเอียดสถานที่โดยไม่คํานึงว่าจะให้โทเค็นเซสชันหรือไม่
การเรียกหรือคําขอรายละเอียดสถานที่จะสร้าง SKU ข้อมูล (พื้นฐาน รายชื่อติดต่อ และ/หรือบรรยากาศ) ด้วย ทั้งนี้ขึ้นอยู่กับช่องที่ระบุไว้ในการโทรหรือคําขอ หากมีการระบุช่อง NO ไว้ในการเรียกหรือคําขอรายละเอียดสถานที่ ระบบจะเรียกให้ SKU ของข้อมูลทั้งหมดปรากฏขึ้น และคุณจะถูกเรียกเก็บเงินสําหรับการเรียกใช้หรือคําขอรายละเอียดสถานที่รวมกับค่าใช้จ่ายของข้อมูลทั้งหมด
ตัวอย่าง
- โทรออกหรือส่งคําขออย่างใดอย่างหนึ่งต่อไปนี้
- อุปกรณ์เคลื่อนที่: เรียกใช้
fetchPlace()
ใน Android หรือfetchPlaceFromPlaceID:
ใน iOS และระบุเฉพาะช่องADDRESS
- Web API หรือบริการ: สร้างคําขอรายละเอียดสถานที่และระบุเฉพาะช่องที่อยู่ดังนี้
getPlaceDetails(fields: formatted_address)
- รายละเอียดสถานที่ (ราคาเริ่มต้น 0.017 USD ต่อเซสชัน)
- ข้อมูลพื้นฐาน (เรียกเก็บเงิน 0.00 USD)
- อุปกรณ์เคลื่อนที่: เรียกใช้
- โทรออกหรือส่งคําขออย่างใดอย่างหนึ่งต่อไปนี้
- อุปกรณ์เคลื่อนที่: เรียกใช้
fetchPlace()
ใน Android หรือfetchPlaceFromPlaceID:
ใน iOS และระบุเฉพาะช่องPHONE_NUMBER
- Web API หรือบริการ: สร้างคําขอรายละเอียดสถานที่และระบุช่องหมายเลขโทรศัพท์
getPlaceDetails(fields: formatted_phone_number)
- รายละเอียดสถานที่ (ราคาเริ่มต้น 0.017 USD ต่อเซสชัน)
- ข้อมูลรายชื่อติดต่อ (ราคาเริ่มต้นที่ 0.003 THB ต่อคําขอ)
- อุปกรณ์เคลื่อนที่: เรียกใช้
- โทรออกหรือส่งคําขออย่างใดอย่างหนึ่งต่อไปนี้
- อุปกรณ์เคลื่อนที่: เรียกใช้
fetchPlace()
ใน Android หรือfetchPlaceFromPlaceID:
ใน iOS และระบุช่องทั้งหมด - Web API หรือบริการ: สร้างคําขอ "รายละเอียดสถานที่" และระบุช่องทั้งหมด (คําขอประเภทนี้จะเป็นค่าเริ่มต้นหากคุณไม่ระบุช่องใดๆ):
getPlaceDetails()
- รายละเอียดสถานที่ (ราคาเริ่มต้น 0.017 USD ต่อเซสชัน)
- ข้อมูลพื้นฐาน (เรียกเก็บเงิน 0.00 USD)
- ข้อมูลรายชื่อติดต่อ (ราคาเริ่มต้นที่ 0.003 THB ต่อคําขอ)
- ข้อมูลบรรยากาศ (ราคาเริ่มต้นที่ 0.005 THB ต่อคําขอ)
- อุปกรณ์เคลื่อนที่: เรียกใช้
SKU: รายละเอียดสถานที่ – การรีเฟรชรหัส
ใช้คําขอรายละเอียดสถานที่เพื่อ รีเฟรชรหัสสถานที่ที่ไม่มีอัปเดต คําขอประเภทนี้พร้อมให้ใช้งานโดยไม่มีค่าใช้จ่าย
ช่วงความถี่รายเดือน (ราคาต่อการโทร) |
||
---|---|---|
0.00 THB | 0.00 THB | 0.00 THB |
ตัวอย่าง
สร้างคําขอ "รายละเอียดสถานที่" โดยระบุเฉพาะช่องรหัสสถานที่ดังนี้
getPlaceDetails(fields: place_id)
คุณจะเห็น SKU นี้ในใบเรียกเก็บเงิน (เมื่อดูการเรียกเก็บเงินตาม SKU) ให้ทําดังนี้
- รายละเอียดสถานที่ – การรีเฟรชรหัส (เรียกเก็บเมื่อ 0.00 USD)
SKU: ค้นหาสถานที่
ระบบจะเรียกเก็บเงินค้นหาสถานที่สําหรับคําขอค้นหาสถานที่
ช่วงความถี่รายเดือน (ราคาต่อการโทร) |
||
---|---|---|
0.017 USD ต่อภาษา (17.00 USD ต่อ 1,000) |
0.0136 USD ต่อภาษา (13.60 USD ต่อ 1,000) |
ติดต่อฝ่ายขายเพื่อสอบถามราคา |
นอกจากนี้ การค้นหาสถานที่ยังสร้าง SKU ข้อมูล (พื้นฐาน, รายชื่อติดต่อ และ/หรือบรรยากาศ) ด้วย ทั้งนี้ขึ้นอยู่กับช่องที่ระบุไว้ในคําขอ เช่นเดียวกับคําขอ "รายละเอียดสถานที่" คุณสามารถใช้พารามิเตอร์ฟิลด์ในคําขอ ค้นหาสถานที่ เพื่อจํากัดการตอบกลับไว้เฉพาะฟิลด์เหล่านั้น ระบบจะเรียกเก็บเงินคุณสําหรับคําขอค้นหาสถานที่และข้อมูลที่ขอ โดยค่าเริ่มต้น หากมีการขอช่อง NO ไว้ ระบบจะแสดงเฉพาะรหัสสถานที่เท่านั้น ดังนั้นจึงไม่มีค่าใช้จ่ายเพิ่มเติม
ตัวอย่าง
- คุณสร้างคําขอ "ค้นหาสถานที่" และระบุเฉพาะช่องที่อยู่ดังนี้
FindPlace(fields: formatted_address)
คุณจะเห็น SKU เหล่านี้ในใบเรียกเก็บเงิน (เมื่อ ดูการเรียกเก็บเงินตาม SKU) ให้ทําดังนี้- ค้นหาสถานที่ (ราคาเริ่มต้นที่ 0.017 USD ต่อการโทรหนึ่งครั้ง)
- ข้อมูลพื้นฐาน (เรียกเก็บเงิน 0.00 USD)
- คุณสร้างคําขอสถานที่เพื่อระบุช่องหมายเลขโทรศัพท์:
FindPlace(fields: formatted_phone_number)
คุณจะเห็น SKU เหล่านี้ในใบเรียกเก็บเงิน (เมื่อ ดูการเรียกเก็บเงินตาม SKU) ให้ทําดังนี้- ค้นหาสถานที่ (ราคาเริ่มต้นที่ 0.017 USD ต่อการโทรหนึ่งครั้ง)
- ข้อมูลรายชื่อติดต่อ (ราคาเริ่มต้นที่ 0.003 THB ต่อคําขอ)
- คุณสร้างคําขอ "ค้นหาสถานที่" และระบุช่องจากที่เก็บข้อมูลทั้ง 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.00 THB | 0.00 THB | 0.00 THB |
ตัวอย่าง
คุณสร้างคําขอ Place Place และระบุเฉพาะฟิลด์ place_id
: FindPlace(fields: place_id)
คุณจะเห็น SKU นี้ในใบเรียกเก็บเงิน (เมื่อดูการเรียกเก็บเงินตาม SKU) ให้ทําดังนี้
- ค้นหาสถานที่ – เฉพาะรหัสเท่านั้น (เรียกเก็บเงิน 0.00 USD)
SKU: สถานที่ – การค้นหาใกล้เคียง
Place – Nearby Search จะเรียกเก็บเงินสําหรับคําขอที่ส่งไปยัง
บริการค้นหาสถานที่ใกล้เคียงของ Maps JavaScript API
(nearbySearch()
) หรือไปที่
Places API บริการค้นหาสถานที่ใกล้เคียง
ช่วงความถี่รายเดือน (ราคาต่อการโทร) |
||
---|---|---|
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.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 จากรูปภาพสถานที่ในกรณีต่อไปนี้
- Android: โทรหา
fetchPhoto()
- iOS: โทรหา
loadPlacePhoto:
- JavaScript: ไปยังคลังสถานที่ ซึ่งเป็นบริการ Place Photos ของ Maps JavaScript API เมื่อขอข้อมูลจาก URL ที่แสดงโดย
PlacePhoto.getUrl()
เพื่อโหลดข้อมูลพิกเซลภาพ - บริการบนเว็บ: คําขอไปยังบริการ Places ของ Photos Photos
สําหรับบริการ JavaScript การเรียกใช้เมธอด PlacePhoto.getUrl()
จะไม่ทําให้เกิดการเรียกเก็บเงินจนกว่าจะมีการใช้ URL เพื่อรับข้อมูลพิกเซลจริงๆ
ช่วงความถี่รายเดือน (ราคาต่อการโทร) |
||
---|---|---|
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 ให้ทําดังนี้
- ใน Cloud Console ให้เปิดหน้าโควต้า Google Maps Platform
- คลิกเมนูแบบเลื่อนลง API และเลือก Places API
- หากต้องการดูขีดจํากัดโควต้า ให้เลื่อนลงไปที่การ์ดคําขอ
ตารางจะแสดงชื่อรายการโควต้าและขีดจํากัด - หากต้องการเปลี่ยนขีดจํากัดโควต้า ให้คลิกไอคอนแก้ไขของขีดจํากัดนั้น
ในกล่องโต้ตอบที่ปรากฏขึ้น ให้ป้อนจํานวนโควต้ารายวันที่ต้องการที่เรียกเก็บเงินได้ในช่องขีดจํากัดโควต้า (ไม่เกินขีดจํากัดของโควต้า หากมี) โดย Google จะเลือกบันทึก
หากการใช้งาน API ถึงขีดจํากัดโควต้าที่เรียกเก็บเงินได้ในวันหนึ่งๆ แล้ว แอปพลิเคชันจะเข้าถึง API สําหรับช่วงเวลาที่เหลือของวันนั้นไม่ได้
แหล่งข้อมูลเกี่ยวกับการจัดการค่าใช้จ่ายที่เกี่ยวข้อง
-
ผู้ใช้ในอินเดียต้องสร้างบัญชีสําหรับการเรียกเก็บเงินของ Google Cloud Platform ก่อนสร้างบัญชีสําหรับการเรียกเก็บเงินของ Google Maps Platform เพื่อรับเครดิต Maps Platform↩