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