این بخش SKUهای تعریف شده برای محصولات اصلی Google Maps Platform را فهرست می کند. محصولات اصلی عبارتند از پرداخت به هنگام رفتن و شما فقط برای SKUهایی که استفاده می کنید پرداخت می کنید.
برای هر SKU لیست شده، خواهید دید:
- نام SKU همانطور که در گزارش صورتحساب شما ظاهر میشود.
- جزئیات توصیف کننده نوع استفاده ای که باعث ایجاد SKU (رویدادهای قابل پرداخت) می شود.
- قیمت هر بار استفاده برای سطوح مبتنی بر حجم.
- هر گونه یادداشت قیمتی اضافی برای SKU.
SKUهای تک تک محصول را در اینجا جستجو کنید، یا از ماشین حساب قیمت و استفاده ما برای تخمین میزان استفاده خود در مقابل هزینه کل هر API استفاده کنید.
محصول GMP / جدول SKU
SKUهای محصول Maps
APIهای موجود در Maps عبارتند از: Maps SDK for Android . Maps SDK برای iOS ؛ Maps JavaScript API ; Maps Static API ; Street View Static API ; و Maps Embed API .
SKU: Mobile Native Static Maps
شامل یک شی نقشه Google در حالت ساده، بدون شناسه نقشه، در Maps SDK برای برنامه تلفن همراه Android است.
محدوده حجم ماهانه (قیمت به ازای بارگذاری نقشه) | ||
---|---|---|
| | |
0.00 USD | 0.00 USD | 0.00 USD |
یک بار نقشه واحد برای هر نمونه از یک شی نقشه Google در حالت ساده، در Maps SDK برای برنامه تلفن همراه Android جمع می شود. نقشهها با نمونههایی از کلاسهای MapFragment
، SupportMapFragment
، یا MapView
ایجاد میشوند. هر بار که متد onCreate()
مربوطه فراخوانی می شود، یک بار نقشه شمارش می شود.
SKU: نقشه های پویا بومی موبایل
یک شی نقشه Google که با شناسه نقشه بارگیری نشده است، در Maps SDK برای Android یا Maps SDK برای برنامه تلفن همراه iOS .
محدوده حجم ماهانه (قیمت به ازای بارگذاری نقشه) | ||
---|---|---|
| | |
0.00 USD | 0.00 USD | 0.00 USD |
یک بار نقشه واحد برای هر نمونه از یک شی نقشه Google در Maps SDK برای Android یا Maps SDK برای برنامه تلفن همراه iOS جمع می شود:
- یکی از کلاس های
MapFragment
،SupportMapFragment
، یاMapView
در اندروید. هر بار که متدonCreate()
مربوطه فراخوانی می شود، یک بار نقشه شمارش می شود. - یک شی
GMSMapView
در iOS.
تعاملات کاربر با نقشه، مانند پاننگ، بزرگنمایی، یا تغییر لایه های نقشه، بارهای نقشه اضافی ایجاد نمی کند. با مدل قیمتگذاری پرداختی، ایجاد پانورامای نمای خیابان دیگر بهعنوان بارگذاری نقشه بومی موبایل محاسبه نمیشود. به عنوان نمای خیابان پویا شارژ می شود.
SKU: Embed و SKU: Embed Advanced
همه درخواستهای Maps Embed API بدون هزینه و با استفاده نامحدود در دسترس هستند.
SKU: نقشه های ایستا
درخواستی به Maps Static API .
محدوده حجم ماهانه (قیمت به ازای بارگذاری نقشه) | ||
---|---|---|
| | |
0.002 دلار برای هر کدام (2.00 دلار در هر 1000) | 0.0016 دلار برای هر کدام (1.60 دلار در هر 1000) | برای اطلاع از قیمت حجم با واحد فروش تماس بگیرید |
SKU: نقشه های پویا
برنامهای که نقشه بارگیری شده با یا بدون شناسه نقشه را با استفاده از Maps JavaScript API ، یا نقشهای بارگذاری شده با شناسه نقشه و با استفاده از Maps SDK برای Android یا Maps SDK برای iOS نمایش میدهد.
محدوده حجم ماهانه (قیمت به ازای بارگذاری نقشه) | ||
---|---|---|
| | |
0.007 دلار برای هر کدام (7.00 دلار در هر 1000) | 0.0056 دلار برای هر کدام (5.60 دلار در هر 1000) | برای اطلاع از قیمت حجم با واحد فروش تماس بگیرید |
تعاملات کاربر با نقشه، مانند پاننگ، بزرگنمایی، یا تغییر لایه های نقشه، بارهای نقشه اضافی ایجاد نمی کند.
SKU: نمای خیابان ثابت
همهنمای نمای خیابان و بارهای نقشه اکنون جداگانه شارژ میشوند. یک پانورامای استاتیک نمای خیابان برای هر درخواست به API استاتیک نمای خیابان برای جاسازی یک پانورامای نمای خیابان ثابت (غیر تعاملی) هزینه میشود. استفاده از نقطه پایانی فراداده تصویر نمای خیابان هزینه ای دریافت نمی کند.
محدوده حجم ماهانه (قیمت هر پانوراما) | ||
---|---|---|
| | |
0.007 دلار برای هر کدام (7.00 دلار در هر 1000) | 0.0056 دلار برای هر کدام (5.60 دلار در هر 1000) | برای اطلاع از قیمت حجم با واحد فروش تماس بگیرید |
SKU: نمای خیابان پویا
همهنمای نمای خیابان و بارهای نقشه اکنون جداگانه شارژ میشوند. برای هر نمونه از یک شی پانوراما در Maps JavaScript API ، Maps SDK برای Android ، Maps SDK برای iOS ، یک پانورامای پویا نمای خیابان هزینه میشود.
محدوده حجم ماهانه (قیمت هر پانوراما) | ||
---|---|---|
| | |
0.014 دلار برای هر کدام (14.00 دلار در هر 1000) | 0.0112 دلار برای هر کدام (11.20 دلار در هر 1000) | برای اطلاع از قیمت حجم با واحد فروش تماس بگیرید |
نمونه ای از یک شی پانوراما رخ می دهد:
- در جاوا اسکریپت ، با کلاس
google.maps.StreetViewPanorama()
یا متدMap.getStreetView()
. نه تجربه داخلی نمای خیابان بر اساس کنترل آدمک خیابان نمای خیابان و نه استفاده از کلاسStreetViewService()
شارژ نمی شود. - در Android ، با یکی از کلاسهای
StreetViewPanoramaFragment
،SupportStreetViewPanoramaFragment
، یاStreetViewPanoramaView
. هر بار که متدonCreate()
مربوطه فراخوانی می شود، یک پانوراما شمارش می شود. - در iOS ، با شی
GMSPanoramaView
.
SKU: نمای هوایی
درخواستی به Aerial View API که URL ویدیوی هوایی را برمی گرداند.
محدوده حجم ماهانه (قیمت هر درخواست موفقیت آمیز lookupVideo ) | ||
---|---|---|
| | |
0.016 دلار برای هر کدام (16.00 دلار در هر 1000) | 0.0128 دلار برای هر کدام (12.80 دلار در هر 1000) | برای اطلاع از قیمت حجم با واحد فروش تماس بگیرید |
فقط تماسهایی که به lookupVideo
برمیگردند صورتحساب دریافت میکنند. یک پاسخ lookupVideo
موفق ممکن است چندین URL را بازگرداند که هر کدام برای وضوح یا جهت متفاوتی هستند، اما تنها یک رویداد قابل پرداخت را تشکیل میدهند. توجه داشته باشید که قیمت گذاری به بازدیدهای واقعی آن URL ها توسط کاربران نهایی بستگی ندارد.
SKUهای محصول را مسیریابی می کند
APIهای موجود در مسیرها عبارتند از: Directions API ; Distance Matrix API ; and Roads API .
SKU: مسیرها
درخواستی به سرویس راهنمای Maps JavaScript API (به استثنای درخواستهایی که SKU صورتحساب پیشرفته Directions را فعال میکنند) یا Directions API .
محدوده حجم ماهانه (قیمت هر QUERY) | ||
---|---|---|
| | |
0.005 دلار برای هر کدام (5.00 دلار در هر 1000) | 0.004 دلار برای هر کدام (4.00 دلار در هر 1000) | برای اطلاع از قیمت حجم با واحد فروش تماس بگیرید |
SKU: مسیرهای پیشرفته
درخواستی به Maps JavaScript's Directions Service یا Directions API که از اطلاعات ترافیک، بیش از 10 ایستگاه بین راه، بهینه سازی نقاط بین راهی و/یا اصلاح کننده های مکان استفاده می کند.
محدوده حجم ماهانه (قیمت هر QUERY) | ||
---|---|---|
| | |
0.01 دلار برای هر کدام (10.00 دلار در هر 1000) | 0.008 دلار برای هر کدام (8.00 دلار در هر 1000) | برای اطلاع از قیمت حجم با واحد فروش تماس بگیرید |
یک Directions Advanced SKU برای سرویس مسیرهای Maps JavaScript API یا یک درخواست Directions API که از یک یا چند مورد از موارد زیر استفاده می کند، دریافت می شود:
- اطلاعات ترافیک اطلاعات ترافیک زمانی استفاده می شود که همه موارد زیر اعمال شوند (اینها شرایط لازم برای دریافت فیلد
duration_in_traffic
در پاسخ Directions هستند):- پارامتر
mode
سفرdriving
است، یا مشخص نشده است (driving
حالت سفر پیشفرض است). - درخواست شامل یک پارامتر
departure_time
معتبر است.departure_time
را می توان روی زمان فعلی یا مدتی در آینده تنظیم کرد. نمی تواند در گذشته باشد. - این درخواست شامل ایستگاه های توقف نیست. اگر درخواست شامل نقاط بین راهی است، پیشوند هر نقطه بین راه را با
via:
برای تأثیرگذاری بر مسیر اما اجتناب از توقف. به عنوان مثال،&waypoints=via:San Francisco|via:Mountain View|...
- پارامتر
- بیش از 10 نقطه بین (بین 11 و 25).
- بهینه سازی نقاط راه پارامتر
optimize
برای نقاط راه رویtrue
تنظیم شده است. به عنوان مثال،&waypoints=optimize:true|San Francisco|Mountain View|...
- اصلاح کننده های مکان هنگامی که از اصلاحکنندههای مکان زیر برای نشان دادن نحوه نزدیک شدن رانندگان به یک مکان خاص استفاده میکنید:
-
side_of_road
-
heading
-
SKU: ماتریس فاصله
درخواستی به Distance Matrix API یا Maps JavaScript's Distance Matrix Service (به استثنای درخواستهایی که SKU صورتحساب پیشرفته Distance Matrix SKU را فعال میکنند).
محدوده حجم ماهانه (قیمت هر ELEMENT) | ||
---|---|---|
| | |
0.005 دلار برای هر کدام (5.00 دلار در هر 1000) | 0.004 دلار برای هر کدام (4.00 دلار در هر 1000) | برای اطلاع از قیمت حجم با واحد فروش تماس بگیرید |
هر پرس و جو ارسال شده به API ماتریس فاصله، عناصری را تولید می کند که در آن تعداد origins
ضربدر تعداد destinations
برابر با تعداد عناصر است.
SKU: Distance Matrix Advanced
درخواستی به Distance Matrix API یا Maps JavaScript API's Distance Matrix Service که از اطلاعات ترافیک و/یا اصلاح کننده های مکان استفاده می کند.
محدوده حجم ماهانه (قیمت هر ELEMENT) | ||
---|---|---|
| | |
0.01 دلار برای هر کدام (10.00 دلار در هر 1000) | 0.008 دلار برای هر کدام (8.00 دلار در هر 1000) | برای اطلاع از قیمت حجم با واحد فروش تماس بگیرید |
هر پرس و جو ارسال شده به API ماتریس فاصله، عناصری را تولید می کند که در آن تعداد origins
ضربدر تعداد destinations
برابر با تعداد عناصر است.
یک SKU پیشرفته ماتریس فاصله برای یک API ماتریس فاصله یا سرویس ماتریس فاصله Maps JavaScript API که از یک یا چند مورد از موارد زیر استفاده می کند، هزینه دریافت می کند:
- اطلاعات ترافیک اطلاعات ترافیک زمانی استفاده می شود که همه موارد زیر اعمال شوند (اینها شرایط لازم برای دریافت فیلد
duration_in_traffic
در پاسخ ماتریس فاصله هستند):- پارامتر
mode
سفرdriving
است، یا مشخص نشده است (driving
حالت سفر پیشفرض است). - درخواست شامل یک پارامتر
departure_time
معتبر است.departure_time
را می توان روی زمان فعلی یا مدتی در آینده تنظیم کرد. نمی تواند در گذشته باشد.
- پارامتر
- اصلاح کننده های مکان هنگامی که از اصلاحکنندههای مکان زیر برای نشان دادن نحوه نزدیک شدن رانندگان به یک مکان خاص استفاده میکنید:
-
side_of_road
-
heading
-
SKU: جاده ها - مسیر سفر شده
درخواستی به سرویس Roads API Snap to Roads .
محدوده حجم ماهانه (قیمت هر QUERY) | ||
---|---|---|
| | |
0.01 دلار برای هر کدام (10.00 دلار در هر 1000) | 0.008 USD برای هر (8.00 دلار در هر 1000) | برای اطلاع از قیمت حجم با واحد فروش تماس بگیرید |
SKU: جاده ها - نزدیکترین جاده
درخواستی به سرویس نزدیکترین جادههای Roads API.
محدوده حجم ماهانه (قیمت هر QUERY) | ||
---|---|---|
| | |
0.01 دلار برای هر کدام (10.00 دلار در هر 1000) | 0.008 USD برای هر (8.00 دلار در هر 1000) | برای اطلاع از قیمت حجم با واحد فروش تماس بگیرید |
SKU: جاده ها – محدودیت های سرعت
درخواستی به سرویس محدودیت سرعت Roads API . محدوده حجم ماهانه (قیمت هر ELEMENT) | ||
---|---|---|
| | |
0.02 دلار برای هر کدام (20.00 دلار در هر 1000) | 0.016 دلار برای هر کدام (16.00 دلار در هر 1000) | برای اطلاع از قیمت حجم با واحد فروش تماس بگیرید |
درخواستهای محدودیت سرعت به ازای عنصر محدودیت سرعتی که در پاسخ API بازگردانده میشود، صورتحساب میشوند. این مقدار همیشه برابر یا کمتر از تعداد امتیازهای دریافت شده در درخواست اصلی خواهد بود.
SKU: Routes: Compute Routes - Basic
درخواستی برای محاسبه مسیرها
محدوده حجم ماهانه قیمت در هر QUERY | ||
---|---|---|
| | |
0.005 دلار برای هر کدام (5.00 دلار در هر 1000) | 0.004 دلار برای هر کدام (4.00 دلار در هر 1000) | برای اطلاع از قیمت حجم با واحد فروش تماس بگیرید |
SKU: Routes: Compute Routes - Advanced
درخواستی برای محاسبه مسیرها که از ویژگی های پیشرفته استفاده می کند.
محدوده حجم ماهانه قیمت در هر QUERY | ||
---|---|---|
| | |
0.01 دلار برای هر کدام (10.00 دلار در هر 1000) | 0.008 USD برای هر (8.00 دلار در هر 1000) | برای اطلاع از قیمت حجم با واحد فروش تماس بگیرید |
SKU پیشرفته برای درخواست مسیرهای محاسباتی که از یک یا چند ویژگی زیر استفاده می کند، هزینه دریافت می کند:
- بین 11 تا 25 ایستگاه میانی
- مسیریابی بهینه آگاه از ترافیک یا آگاه از ترافیک. این گزینههای مسیریابی مربوط به تنظیم ویژگی
routingPreference
در درخواست بهTRAFFIC_AWARE
یاTRAFFIC_AWARE_OPTIMAL
است. - اصلاح کننده های مکان هنگامی که از گزینه های زیر برای نشان دادن نحوه نزدیک شدن رانندگان به یک مکان خاص استفاده می کنید:
SKU: مسیرها: محاسبه مسیرها - ترجیحی
درخواستی برای محاسبه مسیرها که از ویژگی های ترجیحی استفاده می کند.
محدوده حجم ماهانه قیمت در هر QUERY | ||
---|---|---|
| | |
0.015 دلار برای هر کدام (15.00 دلار در هر 1000) | 0.012 دلار برای هر کدام (12.00 دلار در هر 1000) | برای اطلاع از قیمت حجم با واحد فروش تماس بگیرید |
SKU ترجیحی برای درخواست مسیرهای محاسباتی که از یک یا چند ویژگی زیر استفاده می کند، هزینه می شود:
SKU: Routes: Compute Route Matrix - Basic
درخواستی برای محاسبه ماتریس مسیر .
محدوده حجم ماهانه قیمت هر ELEMENT | ||
---|---|---|
| | |
0.005 دلار برای هر کدام (5.00 دلار در هر 1000) | 0.004 دلار برای هر کدام (4.00 دلار در هر 1000) | برای اطلاع از قیمت حجم با واحد فروش تماس بگیرید |
SKU: مسیرها: محاسبه مسیر ماتریس - پیشرفته
درخواستی برای محاسبه مسیر ماتریس که از ویژگی های پیشرفته استفاده می کند.
محدوده حجم ماهانه قیمت هر ELEMENT | ||
---|---|---|
| | |
0.01 دلار برای هر کدام (10.00 دلار در هر 1000) | 0.008 USD برای هر (8.00 دلار در هر 1000) | برای اطلاع از قیمت حجم با واحد فروش تماس بگیرید |
SKU پیشرفته برای درخواست ماتریس مسیر محاسباتی که از یک یا چند ویژگی زیر استفاده می کند، هزینه دریافت می کند:
- مسیریابی بهینه آگاه از ترافیک یا آگاه از ترافیک. این گزینههای مسیریابی مربوط به تنظیم ویژگی
routingPreference
در درخواست بهTRAFFIC_AWARE
یاTRAFFIC_AWARE_OPTIMAL
است. - اصلاح کننده های مکان هنگامی که از گزینه های زیر برای نشان دادن نحوه نزدیک شدن رانندگان به یک مکان خاص استفاده می کنید:
SKU: مسیرها: محاسبه مسیر ماتریس - ترجیحی
درخواستی برای محاسبه مسیر ماتریس که از ویژگی های ترجیحی استفاده می کند.
محدوده حجم ماهانه قیمت هر ELEMENT | ||
---|---|---|
| | |
0.015 دلار برای هر کدام (15.00 دلار در هر 1000) | 0.012 دلار برای هر کدام (12.00 دلار در هر 1000) | برای اطلاع از قیمت حجم با واحد فروش تماس بگیرید |
SKU ترجیحی برای درخواست ماتریس مسیر محاسبه که از یک یا چند ویژگی زیر استفاده میکند، هزینه میشود:
SKU: بهینه سازی مسیر: مسیریابی تک وسیله نقلیه
درخواستی به Route Optimization API که دقیقاً یک وسیله نقلیه را مشخص می کند.
محدوده حجم ماهانه (قیمت هر حمل و نقل) | ||
---|---|---|
| | |
0.01 دلار برای هر کدام (10.00 دلار در هر 1000) | 0.004 دلار برای هر کدام (4.00 دلار در هر 1000) | برای اطلاع از قیمت حجم با واحد فروش تماس بگیرید |
SKU: بهینه سازی مسیر: مسیریابی ناوگان
درخواستی به Route Optimization API که بیش از یک وسیله نقلیه را مشخص می کند.
محدوده حجم ماهانه (قیمت هر حمل و نقل) | ||
---|---|---|
| | |
0.03 دلار برای هر کدام (30.00 دلار در هر 1000) | 0.014 دلار برای هر کدام (14.00 دلار در هر 1000) | برای اطلاع از قیمت حجم با واحد فروش تماس بگیرید |
مکانها (جدید) SKUهای محصول
درباره ماسک های میدانی
در درخواستهای خود از ماسکهای فیلد که لیستهای فیلد نیز نامیده میشوند استفاده کنید تا لیست فیلدهایی را که باید در پاسخ بازگردانده شوند مشخص کنید. سپس با بالاترین SKU مربوط به درخواست شما صورتحساب دریافت می کنید. این بدان معناست که اگر فیلدهایی را در SKU (پایه) و SKU (پیشرفته) انتخاب کنید، بر اساس SKU (پیشرفته) صورتحساب دریافت می کنید.
استفاده از یک فیلد ماسک یک روش طراحی خوب برای اطمینان از عدم درخواست داده های غیر ضروری است که به جلوگیری از زمان پردازش غیر ضروری و هزینه های صورتحساب کمک می کند.
درباره جلسات تکمیل خودکار (جدید).
یک جلسه تکمیل خودکار (جدید) شامل یک یا چند درخواست تکمیل خودکار (جدید) و یک درخواست جزئیات مکان (جدید) یا درخواست اعتبار سنجی آدرس است. همان نشانه جلسه به درخواست تکمیل خودکار (جدید) و به درخواست بعدی جزئیات مکان (جدید) یا درخواست اعتبار سنجی آدرس ارسال می شود.
یک جلسه با اولین درخواست تکمیل خودکار (جدید) شروع می شود. زمانی که کاربر یکی از پیشنهادات تکمیل خودکار (جدید) را انتخاب کرد، درخواست جزئیات مکان (جدید) یا درخواست اعتبار سنجی آدرس داده می شود. اگر جلسه رها شود، به این معنی که هیچ درخواستی برای جزئیات مکان (جدید) یا درخواست اعتبار سنجی آدرس انجام نشود، درخواستهای تکمیل خودکار (جدید) بهگونهای محاسبه میشوند که گویی هیچ نشانه جلسه ارائه نشده است.
پس از اینکه کاربر یک مکان را انتخاب کرد (به این معنی که درخواست جزئیات مکان (جدید) یا درخواست اعتبار سنجی آدرس انجام شد)، باید یک جلسه جدید را با استفاده از یک نشانه جلسه جدید شروع کنید.
نشانه جلسه برای یک جلسه مناسب است و نمی توان برای بیش از یک جلسه از آن استفاده کرد. اگر از یک نشانه جلسه استفاده مجدد کنید، جلسه نامعتبر تلقی می شود و درخواست ها به گونه ای محاسبه می شوند که گویی نشانه جلسه ارائه نشده است.
SKU: تکمیل خودکار درخواست ها
برای هر درخواست به API تکمیل خودکار (جدید) که شامل رمز جلسه نیست، یک SKU درخواست تکمیل خودکار هزینه میشود.
همچنین در صورت استفاده از نشانه های جلسه و یا:
- جلسات را با یک درخواست به جزئیات مکان (جدید) خاتمه دهید که فیلدهای تعریف شده توسط SKU را درخواست می کند: جزئیات مکان (فقط مکان) .
- هر درخواست تکمیل خودکار (جدید)، حداکثر تا 12 درخواست، با استفاده از SKU صورتحساب میشود: درخواستهای تکمیل خودکار .
- هر درخواست تکمیل خودکار (جدید) بعدی با استفاده از SKU صورتحساب میشود: استفاده از جلسه تکمیل خودکار .
- جلسه را رها کنید یا با برقراری تماس با SKU، جلسه را پایان دهید: جزئیات مکان (فقط شناسه ها) . تمام درخواستهای تکمیل خودکار (جدید) سپس با استفاده از SKU صورتحساب میشوند: درخواستهای تکمیل خودکار .
محدوده حجم ماهانه (قیمت هر تماس) | ||
---|---|---|
| | |
0.00283 USD به ازای هر (2.83 دلار در هر 1000) | 0.00227 USD به ازای هر (2.27 دلار در هر 1000) | برای اطلاع از قیمت حجم با واحد فروش تماس بگیرید |
SKU: استفاده از جلسه تکمیل خودکار
برای هر درخواست به API تکمیل خودکار (جدید) که شامل یک نشانه جلسه است، یک SKU استفاده از جلسه تکمیل خودکار دریافت میشود.
این SKU در این حالات شارژ می شود:
جلسه تکمیل خودکار با تماس با SKU پایان یافت: جزئیات مکان (فقط مکان) :
- هر درخواست تکمیل خودکار (جدید)، حداکثر تا 12 درخواست، با استفاده از SKU صورتحساب میشود: درخواستهای تکمیل خودکار .
- هر درخواست تکمیل خودکار (جدید) بعدی با استفاده از SKU صورتحساب میشود: استفاده از جلسه تکمیل خودکار .
جلسه تکمیل خودکار با تماس با SKU خاتمه می یابد: جزئیات مکان (پایه، پیشرفته، یا ترجیحی) .
یک تماس با جزئیات مکان که هر فیلدی را از SKU درخواست میکند: جزئیات مکان (پایه، پیشرفته یا ترجیحی) در SKU صورتحساب میشود: جزئیات مکان (ترجیحا) .
جلسه تکمیل خودکار با تماس با SKU پایان یافت: اعتبار سنجی آدرس ترجیح داده می شود .
برای اطلاعات بیشتر، تکمیل خودکار (جدید) و قیمت جلسه را ببینید.
محدوده حجم ماهانه (قیمت هر تماس) | ||
---|---|---|
| | |
0.00 دلار برای هر کدام (0.00 دلار در هر 1000) | 0.00 دلار برای هر کدام (0.00 دلار در هر 1000) | 0.00 دلار برای هر کدام (0.00 دلار در هر 1000) |
SKU: جزئیات مکان (فقط شناسه ها)
با استفاده از یک ماسک فیلد یا لیست فیلد در درخواست جزئیات مکان (جدید)، می توانید پاسخ را فقط به آن فیلدهای مشخص شده محدود کنید. این SKU زمانی فعال می شود که شما فقط فیلدهای زیر را درخواست کنید:
Android : Place.Field.DISPLAY_NAME
، Place.Field.ID
، Place.Field.PHOTO_METADATAS
، Place.Field.RESOURCE_NAME
کتابخانه مکانها، Maps JavaScript API : id
، photos
iOS : GMSPlacePropertyPlaceID
، GMSPlacePropertyName
، GMSPlacePropertyPhotos
وب سرویس : attributions
، id
، name
* ، photos
* فیلد name
حاوی نام منبع مکان به شکل است: places/ PLACE_ID
. از displayName
برای دسترسی به نام متنی مکان استفاده کنید.
محدوده حجم ماهانه (قیمت هر تماس) | ||
---|---|---|
| | |
0.0 دلار برای هر کدام (0.00 دلار در هر 1000) | 0.0 دلار برای هر کدام (0.00 دلار در هر 1000) | 0.0 دلار برای هر کدام (0.00 دلار در هر 1000) |
SKU: جزئیات مکان (فقط مکان)
با استفاده از یک ماسک فیلد یا لیست فیلد در درخواست جزئیات مکان (جدید)، می توانید پاسخ را فقط به آن فیلدهای مشخص شده محدود کنید. این SKU زمانی فعال می شود که شما فقط فیلدهای زیر را درخواست کنید:
Android : Place.Field.ADDRESS_COMPONENTS
, ADR_FORMAT_ADDRESS
, Place.Field.FORMATTED_ADDRESS
, Place.Field.LOCATION
, Place.Field.PLUS_CODE
, Place.Field.SHORT_FORMATTED_ADDRESS
, TY Place.Field.TYPES
, Place.Field.VIEWPORT
کتابخانه مکانها، Maps JavaScript API : addressComponents
، adrFormatAddress
، formattedAddress
، location
، plusCode
، types
، viewport
iOS : GMSPlacePropertyAddressComponents
، GMSPlacePropertyFormattedAddress
، GMSPlacePropertyCoordinate
، GMSPlacePropertyPlusCode
، GMSPlacePropertyTypes
، GMSPlacePropertyViewport
وب سرویس : addressComponents
، adrFormatAddress
، formattedAddress
، location
، plusCode
، shortFormattedAddress
، types
، viewport
محدوده حجم ماهانه (قیمت هر تماس) | ||
---|---|---|
| | |
0.005 دلار برای هر کدام (5.00 دلار در هر 1000) | 0.004 دلار برای هر کدام (4.00 دلار در هر 1000) | برای اطلاع از قیمت حجم با واحد فروش تماس بگیرید |
SKU: جزئیات مکان (اصلی)
با استفاده از یک ماسک فیلد یا لیست فیلد در درخواست جزئیات مکان (جدید)، می توانید پاسخ را فقط به آن فیلدهای مشخص شده محدود کنید. این SKU زمانی فعال می شود که شما فقط فیلدهای زیر را درخواست کنید:
Android : Place.Field.ACCESSIBILITY_OPTIONS
، Place.Field.BUSINESS_STATUS
، Place.Field.GOOGLE_MAPS_URI
، Place.Field.ICON_BACKGROUND_COLOR
، Place.Field.ICON_MASK_URL
، Place.Field.PRIMARY_TYPE_DISPLAY_NAME
Place.Field.SUB_DESTINATIONS
، Place.Field.UTC_OFFSET
کتابخانه مکانها، Maps JavaScript API : accessibilityOptions
، businessStatus
، displayName
، googleMapsUri
، iconBackgroundColor
، primaryTypeDisplayName
، svgIconMaskURI
، types
، utcOffsetMinutes
GMSPlacePropertyBusinessStatus
iOS GMSPlacePropertyIconBackgroundColor
GMSPlacePropertyIconImageURL
GMSPlacePropertyUTCOffsetMinutes
GMSPlacePropertyWheelchairAccessibleEntrance
وب سرویس : accessibilityOptions
، businessStatus
، displayName
، googleMapsUri
، iconBackgroundColor
، iconMaskBaseUri
، primaryType
، primaryTypeDisplayName
، subDestinations
، utcOffsetMinutes
اگر یک جلسه تکمیل خودکار با یک تماس جزئیات مکان که هر فیلدی را از SKU درخواست میکند خاتمه مییابد: جزئیات مکان (پایه، پیشرفته یا ترجیحی) ، آنگاه صورتحساب تماس در SKU: جزئیات مکان (ترجیحدهی) انجام میشود. برای اطلاعات بیشتر، SKU: تکمیل خودکار جلسه استفاده را ببینید.
محدوده حجم ماهانه (قیمت هر تماس) | ||
---|---|---|
| | |
0.0170 دلار برای هر کدام (17.00 دلار در هر 1000) | 0.0136 دلار برای هر کدام (13.60 دلار در هر 1000) | برای اطلاع از قیمت حجم با واحد فروش تماس بگیرید |
SKU: جزئیات مکان (پیشرفته)
با استفاده از یک ماسک فیلد یا لیست فیلد در درخواست جزئیات مکان (جدید)، می توانید پاسخ را فقط به آن فیلدهای مشخص شده محدود کنید. این SKU زمانی فعال می شود که شما فقط فیلدهای زیر را درخواست کنید:
Android : Place.Field.CURRENT_OPENING_HOURS
، Place.Field.CURRENT_SECONDARY_OPENING_HOURS
Place.Field.INTERNATIONAL_PHONE_NUMBER
، Place.Field.NATIONAL_PHONE_NUMBER
Place.Field.OPENING_HOURS
Place.Field.SECONDARY_OPENING_HOURS
Place.Field.RATING
Place.Field.PRICE_LEVEL
Place.Field.USER_RATING_COUNT
Place.Field.WEBSITE_URI
کتابخانه مکانها، Maps JavaScript API : internationalPhoneNumber
، nationalPhoneNumber
، priceLevel
، rating
، regularOpeningHours
، userRatingCount
، websiteUri
iOS : GMSPlacePropertyCurrentOpeningHours
, GMSPlacePropertySecondaryOpeningHours
, GMSPlacePropertyPhoneNumber
, GMSPlacePropertyPriceLevel
, GMSPlacePropertyRating
, GMSPlacePropertyR, GMSPlacePropertyOpeningHours
, GMSPlacePropertyUserRatingsTotal
GMSPlacePropertyWebsite
وب سرویس : currentOpeningHours
, currentSecondaryOpeningHours
, internationalPhoneNumber
, nationalPhoneNumber
, priceLevel
, rating
, regularOpeningHours
, regularSecondaryOpeningHours
, userRatingCount
, websiteUri
اگر یک جلسه تکمیل خودکار با یک تماس جزئیات مکان که هر فیلدی را از SKU درخواست میکند خاتمه مییابد: جزئیات مکان (پایه، پیشرفته یا ترجیحی) ، آنگاه صورتحساب تماس در SKU: جزئیات مکان (ترجیحدهی) انجام میشود. برای اطلاعات بیشتر، SKU: تکمیل خودکار جلسه استفاده را ببینید.
محدوده حجم ماهانه (قیمت هر تماس) | ||
---|---|---|
| | |
0.020 دلار برای هر کدام (20.00 دلار در هر 1000) | 0.016 دلار برای هر کدام (16.00 دلار در هر 1000) | برای اطلاع از قیمت حجم با واحد فروش تماس بگیرید |
SKU: جزئیات مکان (ترجیحا)
با استفاده از یک ماسک فیلد یا لیست فیلد در درخواست جزئیات مکان (جدید)، می توانید پاسخ را فقط به آن فیلدهای مشخص شده محدود کنید. این SKU زمانی فعال می شود که شما فقط فیلدهای زیر را درخواست کنید:
Android : Place.Field.ALLOWS_DOGS
, Place.Field.CURBSIDE_PICKUP
, Place.Field.DELIVERY
Place.Field.GOOD_FOR_CHILDREN
Place.Field.DINE_IN
, Place.Field.EDITORIAL_SUMMARY
, Place.Field.EV_CHARGE_OPTIONS
Place.Field.FUEL_OPTIONS
، Place.Field.GOOD_FOR_GROUPS
, Place.Field.GOOD_FOR_WATCHING_SPORTS
, Place.Field.LIVE_MUSIC
, Place.Field.MENU_FOR_CHILDREN
, Place.Field.OUTDOOR_SEATING
, Place.Field.PAYMENT_OPTIONS
Place.Field.RESERVABLE
Place.Field.PARKING_OPTIONS
Place.Field.RESTROOM
, Place.Field.REVIEWS
, Place.Field.SERVES_BEER
, Place.Field.SERVES_BREAKFAST
, Place.Field.SERVES_BRUNCH
, Place.Field.SERVES_COCKTAILS
Place.Field.SERVES_DESSERT
Place.Field.SERVES_COFFEE
Place.Field.SERVES_DINNER
، Place.Field.SERVES_LUNCH
، Place.Field.SERVES_VEGETARIAN_FOOD
، Place.Field.SERVES_WINE
، Place.Field.TAKEOUT
Places Library، Maps JavaScript API : allowsDogs
، editorialSummary
، evChargeOptions
، fuelOptions
، hasCurbsidePickup
، hasDelivery
isGoodForWatchingSports
hasDineIn
، hasLiveMusic
، hasMenuForChildren
، hasOutdoorSeating
، hasRestroom
، hasTakeout
hasWifi
، isGoodForChildren
، isReservable
، isGoodForGroups
parkingOptions
، paymentOptions
، priceLevel
، reviews
، servesBeer
, servesBreakfast
, servesBrunch
, servesCocktails
servesCoffee
, قهوه , servesDessert
دسر , servesDinner
, servesLunch
, servesVegetarianFood
, servesWine
GMSPlacePropertyTakeout
iOS GMSPlacePropertyCurbsidePickup
GMSPlacePropertyServesVegetarianFood
GMSPlacePropertyDelivery
GMSPlacePropertyServesBreakfast
GMSPlacePropertyServesDinner
GMSPlacePropertyEditorialSummary
, GMSPlacePropertyServesBrunch
GMSPlacePropertyDineIn
GMSPlacePropertyReviews
GMSPlacePropertyServesWine
GMSPlacePropertyServesLunch
GMSPlacePropertyServesBeer
GMSPlacePropertyReservable
وب سرویس : allowsDogs
, curbsidePickup
, delivery
, dineIn
, editorialSummary
, evChargeOptions
, fuelOptions
, goodForChildren
reviews
goodForGroups
, goodForWatchingSports
, liveMusic
, menuForChildren
, servesCocktails
parkingOptions
reservable
paymentOptions
خلاصه، * servesBeer
، servesBreakfast
outdoorSeating
، سرو restroom
، servesBrunch
routingSummaries
، servesCoffee
, servesDessert
, servesDinner
, servesLunch
, servesVegetarianFood
, servesWine
, takeout
* فقط جستجوی متن و جستجوی نزدیک
اگر یک جلسه تکمیل خودکار با یک تماس جزئیات مکان که هر فیلدی را از SKU درخواست میکند خاتمه مییابد: جزئیات مکان (پایه، پیشرفته یا ترجیحی) ، آنگاه صورتحساب تماس در SKU: جزئیات مکان (ترجیحدهی) انجام میشود. برای اطلاعات بیشتر، SKU: تکمیل خودکار جلسه استفاده را ببینید.
محدوده حجم ماهانه (قیمت هر تماس) | ||
---|---|---|
| | |
0.025 دلار برای هر کدام (25.00 دلار در هر 1000) | 0.020 دلار برای هر کدام (20.00 دلار در هر 1000) | برای اطلاع از قیمت حجم با واحد فروش تماس بگیرید |
SKU: جستجوی نزدیک (اصلی)
با استفاده از ماسک فیلد یا لیست فیلد در درخواست جستجوی نزدیک (جدید)، میتوانید پاسخ را فقط به آن قسمتهای مشخص شده محدود کنید. این SKU زمانی فعال می شود که شما فقط فیلدهای زیر را درخواست کنید:
Android Place.Field.ADDRESS
Place.Field.ADDRESS_COMPONENTS
Place.Field.ICON_BACKGROUND_COLOR
Place.Field.BUSINESS_STATUS
Place.Field.ICON_URL
Place.Field.LAT_LNG
Place.Field.PHOTO_METADATAS
Place.Field.PLUS_CODE
Place.Field.ID
Place.Field.VIEWPORT
Place.Field.NAME
، Place.Field.TYPES
، Place.Field.WHEELCHAIR_ACCESSIBLE_ENTRANCE
Place.Field.UTC_OFFSET
مکان های کتابخانه ، نقشه های JavaScript API : accessibilityOptions
، addressComponents
، adrFormatAddress
، businessStatus
svgIconMaskURI
displayName
، formattedAddress
، googleMapsUri
، iconBackgroundColor
، id
، location
، مکان ، photos
، plusCode
، types
، utcOffsetMinutes
، viewport
iOS GMSPlacePropertyTypes
GMSPlacePropertyAddressComponents
، GMSPlacePropertyBusinessStatus
، GMSPlacePropertyCoordinate
، GMSPlacePropertyFormattedAddress
GMSPlacePropertyUTCOffsetMinutes
GMSPlacePropertyIconBackgroundColor
GMSPlacePropertyName
، GMSPlacePropertyIconImageURL
GMSPlacePropertyWheelchairAccessibleEntrance
GMSPlacePropertyPhotos
، GMSPlacePropertyPlaceID
GMSPlacePropertyPlusCode
GMSPlacePropertyViewport
سرویس وب : places.displayName
places.accessibilityOptions
places.iconMaskBaseUri
places.attributions
places.businessStatus
places.googleMapsUri
places.iconBackgroundColor
places.location
. places.adrFormatAddress
places.formattedAddress
places.addressComponents
places.id
places.types
مکان ها places.shortFormattedAddress
places.name
* ، places.photos
places.viewport
places.plusCode
places.primaryType
places.subDestinations
places.primaryTypeDisplayName
places.utcOffsetMinutes
* قسمت places.name
شامل نام منبع مکان در فرم است: places/ PLACE_ID
. برای دسترسی به نام متن مکان از مکان ها استفاده کنید. places.displayName
دامنه حجم ماهانه (قیمت در هر تماس) | ||
---|---|---|
| | |
0.032 دلار در هر کدام (32.00 دلار در هر 1000) | 0.0256 دلار در هر کدام (25.60 دلار در هر 1000) | برای قیمت گذاری حجم با فروش تماس بگیرید |
SKU: جستجوی مجاور (پیشرفته)
با استفاده از یک ماسک فیلد یا لیست فیلد در درخواست جستجوی مجاور خود (جدید) ، می توانید پاسخ فقط به آن قسمت های مشخص شده را محدود کنید. این SKU هنگامی که فقط زمینه های زیر را درخواست می کنید ایجاد می شود:
Android Place.Field.SECONDARY_OPENING_HOURS
Place.Field.CURRENT_OPENING_HOURS
، Place.Field.CURRENT_SECONDARY_OPENING_HOURS
Place.Field.INTERNATIONAL_PHONE_NUMBER
، Place.Field.PRICE_LEVEL
Place.Field.OPENING_HOURS
Place.Field.RATING
Place.Field.NATIONAL_PHONE_NUMBER
Place.Field.USER_RATING_COUNT
Place.Field.WEBSITE_URI
کتابخانه مکان ها ، نقشه های JavaScript API : internationalPhoneNumber
، nationalPhoneNumber
، priceLevel
، rating
، regularOpeningHours
، userRatingCount
، websiteUri
iOS : GMSPlacePropertyCurrentOpeningHours
, GMSPlacePropertySecondaryOpeningHours
, GMSPlacePropertyPhoneNumber
, GMSPlacePropertyPriceLevel
, GMSPlacePropertyRating
, GMSPlacePropertyOpeningHours
, GMSPlacePropertyUserRatingsTotal
, GMSPlacePropertyWebsite
places.userRatingCount
وب places.regularSecondaryOpeningHours
places.currentOpeningHours
places.websiteUri
places.priceLevel
places.internationalPhoneNumber
places.regularOpeningHours
places.currentSecondaryOpeningHours
places.nationalPhoneNumber
places.rating
دامنه حجم ماهانه (قیمت در هر تماس) | ||
---|---|---|
| | |
0.035 دلار در هر کدام (35.00 دلار در هر 1000) | 0.028 دلار در هر کدام (28.00 دلار در هر 1000) | برای قیمت گذاری حجم با فروش تماس بگیرید |
SKU: جستجوی مجاور (ترجیحی)
با استفاده از یک ماسک فیلد یا لیست فیلد در درخواست جستجوی مجاور خود (جدید) ، می توانید پاسخ فقط به آن قسمت های مشخص شده را محدود کنید. این SKU هنگامی که فقط زمینه های زیر را درخواست می کنید ایجاد می شود:
Android : Place.Field.ALLOWS_DOGS
، Place.Field.CURBSIDE_PICKUP
، Place.Field.DELIVERY
، Place.Field.DINE_IN
، Place.Field.EDITORIAL_SUMMARY
، Place.Field.EV_CHARGE_OPTIONS
، Place.Field.FUEL_OPTIONS
، Place.Field.GOOD_FOR_CHILDREN
، ، Place.Field.GOOD_FOR_GROUPS
Place.Field.RESERVABLE
Place.Field.GOOD_FOR_WATCHING_SPORTS
Place.Field.OUTDOOR_SEATING
Place.Field.PARKING_OPTIONS
Place.Field.LIVE_MUSIC
Place.Field.PAYMENT_OPTIONS
، Place.Field.MENU_FOR_CHILDREN
Place.Field.RESTROOM
، Place.Field.REVIEWS
، Place.Field.SERVES_BEER
، Place.Field.SERVES_BREAKFAST
، Place.Field.SERVES_BRUNCH
، Place.Field.SERVES_COCKTAILS
، Place.Field.SERVES_COFFEE
، Place.Field.SERVES_DESSERT
، Place.Field.SERVES_DINNER
، Place.Field.SERVES_LUNCH
Place.Field.SERVES_VEGETARIAN_FOOD
Place.Field.SERVES_WINE
Place.Field.TAKEOUT
مکان های کتابخانه ، نقشه های JavaScript API : allowsDogs
DOGS ، editorialSummary
، evChargeOptions
، fuelOptions
، hasCurbsidePickup
، hasDelivery
، hasDineIn
، hasLiveMusic
، hasMenuForChildren
، hasOutdoorSeating
، hasRestroom
، hasTakeout
، hasWifi
، isGoodForChildren
، isgoodgoodgoodgood ، isGoodForGroups
، isgoodgoodgood ، isReservable
isGoodForWatchingSports
parkingOptions
، paymentOptions
، priceLevel
، reviews
، servesBeer
servesBreakfast
servesBrunch
servesCocktails
servesCoffee
servesDessert
servesDinner
servesLunch
servesVegetarianFood
servesWine
iOS : GMSPlacePropertyCurbsidePickup
, GMSPlacePropertyDelivery
, GMSPlacePropertyDineIn
, GMSPlacePropertyEditorialSummary
, GMSPlacePropertyReservable
, GMSPlacePropertyReviews
, GMSPlacePropertyServesBeer
, GMSPlacePropertyServesBreakfast
, GMSPlacePropertyServesBrunch
, GMSPlacePropertyServesDinner
, GMSPlacePropertyServesLunch
, GMSPlacePropertyServesVegetarianFood
, GMSPlacePropertyServesWine
, GMSPlacePropertyTakeout
places.goodForWatchingSports
وب places.goodForChildren
places.delivery
places.allowsDogs
places.goodForGroups
places.dineIn
places.fuelOptions
places.curbsidePickup
places.editorialSummary
places.evChargeOptions
places.liveMusic
places.menuForChildren
places.servesBrunch
places.parkingOptions
places.outdoorSeating
places.servesBeer
places.reviews
places.routingSummaries
places.paymentOptions
places.servesBreakfast
places.reservable
places.restroom
. places.servesCocktails
places.servesCoffee
places.servesDessert
places.servesDinner
places.servesLunch
places.servesVegetarianFood
places.servesWine
places.takeout
* جستجوی متن و فقط جستجوی مجاور
دامنه حجم ماهانه (قیمت در هر تماس) | ||
---|---|---|
| | |
در هر کدام 0.040 دلار (40.00 دلار در هر 1000) | 0.032 دلار در هر کدام (32.00 دلار در هر 1000) | برای قیمت گذاری حجم با فروش تماس بگیرید |
SKU: جستجوی متن (فقط شناسه)
با استفاده از یک ماسک فیلد یا لیست فیلد در درخواست متن خود (جدید) ، می توانید پاسخ فقط به قسمتهای مشخص شده را محدود کنید. این SKU هنگامی که فقط زمینه های زیر را درخواست می کنید ایجاد می شود:
Android : Place.Field.DISPLAY_NAME
، Place.Field.ID
، Place.Field.RESOURCE_NAME
iOS : GMSPlacePropertyPlaceID
، GMSPlacePropertyName
کتابخانه مکان ، نقشه های JavaScript API : id
سرویس وب : places.attributions
، places.id
، places.name
* ، nextPageToken
* قسمت places.name
شامل نام منبع مکان در فرم است: places/ PLACE_ID
. برای دسترسی به نام متن مکان از مکان ها استفاده کنید. places.displayName
دامنه حجم ماهانه (قیمت در هر تماس) | ||
---|---|---|
| | |
در هر کدام 0.0 دلار (0.00 دلار در هر 1000) | در هر کدام 0.0 دلار (0.00 دلار در هر 1000) | در هر کدام 0.0 دلار (0.00 دلار در هر 1000) |
SKU: جستجوی متن (پایه)
با استفاده از یک ماسک فیلد یا لیست فیلد در درخواست متن خود (جدید) ، می توانید پاسخ فقط به قسمتهای مشخص شده را محدود کنید. این SKU هنگامی که فقط زمینه های زیر را درخواست می کنید ایجاد می شود:
Android : Place.Field.ACCESSIBILITY_OPTIONS
، Place.Field.ADDRESS_COMPONENTS
، Place.Field.ADR_FORMAT_ADDRESS
، Place.Field.BUSINESS_STATUS
، Place.Field.FORMATTED_ADDRESS
، Place.Field.GOOGLE_MAPS_URI
، Place.Field.ICON_BACKGROUND_COLOR
، Place.Field.ICON_MASK_URL
. Place.Field.LOCATION
، Place.Field.PHOTO_METADATAS
، Place.Field.PLUS_CODE
، Place.Field.PRIMARY_TYPE_DISPLAY_NAME
، Place.Field.TYPES
، Place.Field.UTC_OFFSET
Place.Field.SHORT_FORMATTED_ADDRESS
place.types Place.Field.SUB_DESTINATIONS
Place.Field.VIEWPORT
iOS : GMSPlacePropertyAddressComponents
, GMSPlacePropertyBusinessStatus
, GMSPlacePropertyFormattedAddress
, GMSPlacePropertyIconBackgroundColor
, GMSPlacePropertyIconImageURL
, GMSPlacePropertyCoordinate
, GMSPlacePropertyPhotos
, GMSPlacePropertyPlusCode
, GMSPlacePropertyTypes
, GMSPlacePropertyUTCOffsetMinutes
, GMSPlacePropertyViewport
, GMSPlacePropertyWheelchairAccessibleEntrance
مکان های کتابخانه ، نقشه های JavaScript API : accessibilityOptions
، addressComponents
، adrFormatAddress
، businessStatus
، displayName
، formattedAddress
، googleMapsUri
، iconBackgroundColor
، location
، مکان ، photos
، plusCode
، svgIconMaskURI
، types
، utcOffsetMinutes
، viewport
places.formattedAddress
وب : places.googleMapsUri
places.accessibilityOptions
places.location
places.iconBackgroundColor
places.plusCode
places.addressComponents
places.displayName
places.photos
places.iconMaskBaseUri
places.adrFormatAddress
places.businessStatus
. ، places.primaryType
places.types
places.shortFormattedAddress
places.subDestinations
places.primaryTypeDisplayName
places.utcOffsetMinutes
places.viewport
دامنه حجم ماهانه (قیمت در هر تماس) | ||
---|---|---|
| | |
0.032 دلار در هر کدام (32.00 دلار در هر 1000) | 0.0256 دلار در هر کدام (25.60 دلار در هر 1000) | برای قیمت گذاری حجم با فروش تماس بگیرید |
SKU: جستجوی متن (پیشرفته)
با استفاده از یک ماسک فیلد یا لیست فیلد در درخواست متن خود (جدید) ، می توانید پاسخ فقط به قسمتهای مشخص شده را محدود کنید. این SKU هنگامی که فقط زمینه های زیر را درخواست می کنید ایجاد می شود:
Android Place.Field.SECONDARY_OPENING_HOURS
Place.Field.CURRENT_OPENING_HOURS
، Place.Field.CURRENT_SECONDARY_OPENING_HOURS
Place.Field.INTERNATIONAL_PHONE_NUMBER
، Place.Field.PRICE_LEVEL
Place.Field.OPENING_HOURS
Place.Field.RATING
Place.Field.NATIONAL_PHONE_NUMBER
Place.Field.USER_RATING_COUNT
Place.Field.WEBSITE_URI
iOS : GMSPlacePropertyCurrentOpeningHours
, GMSPlacePropertySecondaryOpeningHours
, GMSPlacePropertyPhoneNumber
, GMSPlacePropertyPriceLevel
, GMSPlacePropertyRating
, GMSPlacePropertyOpeningHours
, GMSPlacePropertyUserRatingsTotal
, GMSPlacePropertyWebsite
places.userRatingCount
وب places.regularSecondaryOpeningHours
places.currentOpeningHours
places.websiteUri
places.priceLevel
places.internationalPhoneNumber
places.regularOpeningHours
places.currentSecondaryOpeningHours
places.nationalPhoneNumber
places.rating
کتابخانه مکان ها ، نقشه های JavaScript API : internationalPhoneNumber
، nationalPhoneNumber
، priceLevel
، rating
، regularOpeningHours
، userRatingCount
، websiteUri
دامنه حجم ماهانه (قیمت در هر تماس) | ||
---|---|---|
| | |
0.035 دلار در هر کدام (35.00 دلار در هر 1000) | 0.028 دلار در هر کدام (28.00 دلار در هر 1000) | برای قیمت گذاری حجم با فروش تماس بگیرید |
SKU: جستجوی متن (ترجیحی)
با استفاده از یک ماسک فیلد یا لیست فیلد در درخواست متن خود (جدید) ، می توانید پاسخ فقط به قسمتهای مشخص شده را محدود کنید. این SKU هنگامی که فقط زمینه های زیر را درخواست می کنید ایجاد می شود:
Android : Place.Field.ALLOWS_DOGS
، Place.Field.CURBSIDE_PICKUP
، Place.Field.DELIVERY
، Place.Field.DINE_IN
، Place.Field.EDITORIAL_SUMMARY
، Place.Field.EV_CHARGE_OPTIONS
، Place.Field.FUEL_OPTIONS
، Place.Field.GOOD_FOR_CHILDREN
، ، Place.Field.GOOD_FOR_GROUPS
Place.Field.RESERVABLE
Place.Field.GOOD_FOR_WATCHING_SPORTS
Place.Field.OUTDOOR_SEATING
Place.Field.PARKING_OPTIONS
Place.Field.LIVE_MUSIC
Place.Field.PAYMENT_OPTIONS
، Place.Field.MENU_FOR_CHILDREN
Place.Field.RESTROOM
، Place.Field.REVIEWS
، Place.Field.SERVES_BEER
، Place.Field.SERVES_BREAKFAST
، Place.Field.SERVES_BRUNCH
، Place.Field.SERVES_COCKTAILS
، Place.Field.SERVES_COFFEE
، Place.Field.SERVES_DESSERT
، Place.Field.SERVES_DINNER
، Place.Field.SERVES_LUNCH
Place.Field.SERVES_VEGETARIAN_FOOD
Place.Field.SERVES_WINE
Place.Field.TAKEOUT
iOS : GMSPlacePropertyCurbsidePickup
, GMSPlacePropertyDelivery
, GMSPlacePropertyDineIn
, GMSPlacePropertyEditorialSummary
, GMSPlacePropertyReservable
, GMSPlacePropertyReviews
, GMSPlacePropertyServesBeer
, GMSPlacePropertyServesBreakfast
, GMSPlacePropertyServesBrunch
, GMSPlacePropertyServesDinner
, GMSPlacePropertyServesLunch
, GMSPlacePropertyServesVegetarianFood
, GMSPlacePropertyServesWine
, GMSPlacePropertyTakeout
مکان های کتابخانه ، نقشه های JavaScript API : allowsDogs
DOGS ، editorialSummary
، evChargeOptions
، fuelOptions
، hasCurbsidePickup
، hasDelivery
، hasDineIn
، hasLiveMusic
، hasMenuForChildren
، hasOutdoorSeating
، hasRestroom
، hasTakeout
، hasWifi
، isGoodForChildren
، isgoodgoodgoodgood ، isGoodForGroups
، isgoodgoodgood ، isReservable
isGoodForWatchingSports
parkingOptions
، paymentOptions
، priceLevel
، reviews
، servesBeer
servesBreakfast
servesBrunch
servesCocktails
servesCoffee
servesDessert
servesDinner
servesLunch
servesVegetarianFood
servesWine
places.goodForWatchingSports
وب places.goodForChildren
places.delivery
places.allowsDogs
places.goodForGroups
places.dineIn
places.fuelOptions
places.curbsidePickup
places.editorialSummary
places.evChargeOptions
places.liveMusic
places.menuForChildren
places.servesBrunch
places.parkingOptions
places.outdoorSeating
places.servesBeer
places.reviews
places.routingSummaries
places.paymentOptions
places.servesBreakfast
places.reservable
places.restroom
. places.servesCocktails
places.servesCoffee
places.servesDessert
places.servesDinner
places.servesLunch
places.servesVegetarianFood
places.servesWine
places.takeout
* جستجوی متن و فقط جستجوی مجاور
دامنه حجم ماهانه (قیمت در هر تماس) | ||
---|---|---|
| | |
در هر کدام 0.040 دلار (40.00 دلار در هر 1000) | 0.032 دلار در هر کدام (32.00 دلار در هر 1000) | برای قیمت گذاری حجم با فروش تماس بگیرید |
SKU: عکس قرار دهید
یک عکس SKU برای هر درخواست به API شارژ می شود.
دامنه حجم ماهانه (قیمت در هر تماس) | ||
---|---|---|
| | |
0.007 دلار در هر کدام (7.00 دلار در هر 1000) | 0.0056 دلار در هر کدام (5.60 دلار در هر 1000) | برای قیمت گذاری حجم با فروش تماس بگیرید |
SKU های محصول را مکان می کند
API ها در مکان ها شامل API ، مکان های SDK برای Android ؛ SDK را برای iOS قرار می دهد . کتابخانه مکان ، نقشه های JavaScript API ؛ GeoCoding API ؛ API جغرافیایی ؛ API منطقه زمانی ؛ و ارتفاع API .
درباره جلسات خودکار
یک جلسه خودکار شامل برخی از درخواست های خودکار (برای بازیابی پیشنهادات در یک مکان به عنوان انواع کاربر) ، و حداکثر یک مکان درخواست جزئیات (برای بازیابی جزئیات در مورد مکان انتخاب شده توسط کاربر) است. همان نشانه جلسه به درخواست جزئیات Autoclotte و مکان بعدی منتقل می شود. یک جلسه با اولین درخواست خودکار (که معمولاً هنگام شروع تایپ کردن کاربر اتفاق می افتد) شروع می شود. هنگامی که کاربر یکی از پیشنهادات خودکار را انتخاب کرده است ، یک تماس با جزئیات مکان انجام می شود. اگر کاربر پیشنهادی را انتخاب نکند ، هیچ یک از مکانها جزئیات تماس برقرار نمی شود.
بعد از اینکه یک کاربر مکانی را انتخاب کرد (یعنی تماس با جزئیات مکان) ، باید یک جلسه جدید را با استفاده از یک نشانه جلسه جدید شروع کنید.
جلسات خودکار می تواند از API های زیر ایجاد شود:
- مکان های API خدمات خودکار یا نقشه های API MAPS را به صورت خودکار قرار می دهد. برای تهیه نشانه های جلسه باید برنامه خود را طراحی کنید (ممکن است لازم باشد کد موجود خود را تغییر دهید).
- ویجت خودکار API JavaScript API . صورتحساب مبتنی بر جلسه به طور خودکار در آن ابزارک ها فعال می شود ، بدون اینکه هیچ گونه تغییر کد لازم باشد.
یک نشانه جلسه برای یک جلسه کاربر مناسب است و نباید بیش از یک جلسه کاربر استفاده شود. اگر از نشانه جلسه استفاده مجدد کنید ، جلسه نامعتبر تلقی می شود و درخواست ها به نظر می رسد که هیچ نشانه ای از جلسه ارائه نشده است.
درخواست های خودکار و درخواست های مربوط به جزئیات درخواست ها با استفاده از جلسات در SKU های مختلف صورتحساب می شوند.
در مورد مکان های SKU
سه مکان SKU ها عبارتند از: داده های اساسی ، داده های تماس و داده های جو .یک یا چند SKU داده برای:
- Android: هر درخواست برای
fetchPlace()
یاfindCurrentPlace()
- iOS: هر تماس به
fetchPlaceFromPlaceID:
یاfindPlaceLikelihoodsFromCurrentLocationWithPlaceFields:
- سرویس وب: هر مکان بسته به قسمتهای مشخص شده در درخواست درخواست می کند
SKU های داده ها همیشه علاوه بر SKU پایه برای درخواست ایجاد آنها ، شارژ می شوند. به عنوان مثال ، یک درخواست جزئیات مکان شامل زمینه های داده های اساسی هم تحت داده های اصلی SKU و هم جزئیات مکان SKU شارژ می شود.
برای سرویس وب ، این مکانها API با پشتیبانی از قسمت های داده برای بازگشت تماس می گیرند:
برای سرویس وب ، این مکانها تماس های API از مشخص کردن زمینه های برگشتی پشتیبانی نمی کنند . این تماس ها همیشه داده های مکان را باز می گرداند ، و علاوه بر هزینه هر درخواست API ، سه مکان SKU را شارژ می کند:
SKU: داده های اساسی
با استفاده از پارامتر Fields در جزئیات مکان خود یا یافتن درخواست مکان ، می توانید پاسخ فقط به آن قسمت های مشخص شده را محدود کنید. زمینه های موجود در رده اصلی در هزینه پایه درخواست مکان ها گنجانده شده است و هیچ هزینه اضافی منجر نمی شود. داده های اصلی SKU در صورت درخواست هر یک از این زمینه ها آغاز می شود:
- Android:
Place.Field.ICON_MASK_URL
Place.Field.ACCESSIBILITY_OPTIONS
Place.Field.ICON_BACKGROUND_COLOR
Place.Field.ADDRESS_COMPONENTS
Place.Field.BUSINESS_STATUS
Place.Field.ID
Place.Field.DISPLAY_NAME
Place.Field.FORMATTED_ADDRESS
.Place.Field.LOCATION
،Place.Field.PHOTO_METADATAS
،Place.Field.PLUS_CODE
،Place.Field.VIEWPORT
Place.Field.TYPES
Place.Field.UTC_OFFSET
. - iOS:
GMSPlaceFieldFormattedAddress
,GMSPlaceFieldBusinessStatus
,GMSPlaceFieldID
,GMSPlaceFieldCoordinate
,GMSPlaceFieldName
,GMSPlaceFieldPhotos
,GMSPlaceFieldPlusCode
,GMSPlaceFieldTypes
, orGMSPlaceFieldViewport
- سرویس وب:
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 دلار | هزینه های درخواست هزینه + 0.00 دلار | هزینه های درخواست هزینه + 0.00 دلار |
SKU: با داده های تماس بگیرید
با استفاده از پارامتر Fields در جزئیات مکان خود یا پیدا کردن درخواست مکان برای خدمات وب ، یا مجموعه ای از Place.Field
Field S برای Android یا iOS ، می توانید پاسخ فقط به آن قسمت های مشخص شده را محدود کنید. زمینه های موجود در گروه تماس منجر به بار اضافی می شوند. در صورت درخواست هر یک از این زمینه ها ، داده های تماس با SKU ایجاد می شود:
- Android:
Place.Field.CURRENT_OPENING_HOURS
،Place.Field.INTERNATIONAL_PHONE_NUMBER
،Place.Field.OPENING_HOURS
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 دلار در هر کدام (+ 3.00 دلار در هر 1000) | هزینه های درخواست هزینه + 0.0024 دلار در هر کدام (+ 2.40 دلار در هر 1000) | برای قیمت گذاری حجم با فروش تماس بگیرید |
SKU: داده های جو
با استفاده از پارامتر Fields در جزئیات مکان خود یا یافتن درخواست مکان ، می توانید پاسخ فقط به آن قسمت های مشخص شده را محدود کنید. زمینه های موجود در رده جو منجر به بار اضافی می شود. داده های جو SKU در صورت درخواست هر یک از این زمینه ها ایجاد می شود:
- Android:
Place.Field.CURBSIDE_PICKUP
،Place.Field.DELIVERY
،Place.Field.EDITORIAL_SUMMARY
Place.Field.RATING
Place.Field.PRICE_LEVEL
Place.Field.RESERVABLE
Place.Field.DINE_IN
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_RATING_COUNT
. - iOS:
GMSPlaceFieldPriceLevel
,GMSPlaceFieldRating
,GMSPlaceFieldUserRatingsTotal
,GMSPlaceFieldTakeout
,GMSPlaceFieldDelivery
,GMSPlaceFieldDineIn
,GMSPlaceFieldCurbsidePickup
,GMSPlaceFieldReservable
,GMSPlaceFieldServesBreakfast
,GMSPlaceFieldServesLunch
,GMSPlaceFieldServesDinner
,GMSPlaceFieldServesBeer
,GMSPlaceFieldServesWine
,GMSPlaceFieldServesBrunch
orGMSPlaceFieldServesVegetarianFood
. - JavaScript : به قسمت ها مراجعه کنید (جزئیات مکان)
- Web service :
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
, oruser_ratings_total
.
دامنه حجم ماهانه (قیمت در هر تماس) | ||
---|---|---|
| | |
هزینه های درخواست هزینه + 0.005 دلار در هر کدام (+ 5.00 دلار در هر 1000) | هزینه های درخواست هزینه + 0.004 دلار در هر کدام (+ 4.00 دلار در هر 1000) | برای قیمت گذاری حجم با فروش تماس بگیرید |
SKU: خودکار - در هر درخواست
AutoClemplete - در هر درخواست SKU برای هر یک از این تماس ها یا درخواست هایی که شامل یک جلسه جلسه نیست ، هزینه می شود:
- Android:
findAutocompletePredictions()
- iOS:
findAutocompletePredictionsFromQuery:
- JavaScript: Maps JavaScript API Service Autoclotte Service
- سرویس وب: مکان های API محلول AUTOCPLOCTETE
تماس های انجام شده از یک جلسه خودکار نامعتبر (به عنوان مثال ، جلسه ای که از یک جلسه جلسه استفاده می کند) نیز به طور خودکار - در هر درخواست SKU شارژ می شود.
درخواست های خودکار از نقشه های نقشه API JavaScript API AUTOCPLOCTETE ممکن است به صورت خودکار شارژ شود - در صورت درخواست SKU در صورت تماس از یک جلسه خودکار نامعتبر. این ممکن است زمانی اتفاق بیفتد که کاربر چندین آدرس مختلف را تایپ کند یا آدرس های مختلف را در ویجت کپی و چسباند و همیشه یک پیش بینی خودکار را انتخاب نکند.
دامنه حجم ماهانه (قیمت در هر درخواست) | ||
---|---|---|
| | |
0.00283 دلار در هر کدام (2.83 دلار در هر 1000) | 0.00227 دلار در هر کدام (2.27 دلار در هر 1000) | برای قیمت گذاری حجم با فروش تماس بگیرید |
SKU: به صورت خودکار بدون جزئیات - در هر جلسه
به طور خودکار بدون جزئیات جزئیات - SKU در هر جلسه برای یک جلسه خودکار که شامل درخواست جزئیات مکان (طی چند دقیقه از ابتدای جلسه) نیست ، هزینه می شود.
دامنه حجم ماهانه (قیمت در هر جلسه) | ||
---|---|---|
| | |
در هر کدام 0.017 دلار (17.00 دلار در هر 1000) | 0.0136 دلار در هر کدام (13.60 دلار در هر 1000) | برای قیمت گذاری حجم با فروش تماس بگیرید |
مثال
اگر برنامه شما این دو تماس را در یک جلسه واحد صادر می کند:
اندروید
- findautocompletepredictions () (.setQuery ("par") ، .SetsessionToken (xyz))
- findautocompletepredictions () (.setQuery ("پاریس") ، .SetsessionToken (xyz))
iOS
وب سرویس
- درخواست خودکار را قرار دهید (input = "par" ، session_token: xyz)
- درخواست خودکار را قرار دهید (input = "پاریس" ، Session_Token: XYZ)
در صورتحساب خود ، این SKU ذکر شده را مشاهده خواهید کرد (هنگام مشاهده صورتحساب خود توسط SKU ):
- به طور خودکار بدون جزئیات مکان - در هر جلسه (قیمت شروع از 0.017 دلار در هر جلسه)
SKU: Autoclotte (شامل جزئیات مکان) - در هر جلسه
AutoClotte (شامل جزئیات مکان) - در هر جلسه SKU برای یک جلسه خودکار که شامل هر یک از:
- Android: یک تماس برای
fetchPlace()
- iOS: فراخوانی به
fetchPlaceFromPlaceID:
- سرویس وب: درخواست جزئیات مکان
درخواست خودکار بدون هیچ هزینه ای در دسترس است و تماس جزئیات مکان بعدی بر اساس قیمت گذاری جزئیات مکان به طور منظم شارژ می شود.
یک درخواست جزئیات مکان ، بسته به زمینه هایی که در درخواست مشخص شده اند ، SKU های داده ( اساسی ، مخاطب و/یا جو ) ایجاد می کند.
اگر زمینه های موجود در درخواست Place Details را مشخص نکنید ، تمام SKU های داده ها تحریک می شوند (اساسی ، تماس و جو).
جزئیات را در مورد درخواست های تازه سازی شناسه (درخواست هایی که فقط قسمت place_id
را مشخص می کنند) در طی یک جلسه خودکار به صورت SKU صورتحساب داده می شود: به صورت خودکار بدون جزئیات مکان - در هر جلسه .
دامنه حجم ماهانه (قیمت در هر جلسه) | ||
---|---|---|
| | |
0.00 USD | 0.00 USD | 0.00 USD |
مثال
اگر برنامه شما سه تماس زیر را در یک جلسه واحد صادر می کند:
اندروید
- findautocompletepredictions () (.setQuery ("par") ، .SetsessionToken (xyz))
- findautocompletepredictions () (.setQuery ("پاریس") ، .SetsessionToken (xyz))
- FetchPlace () (با یک
FetchPlaceRequest
شامل شناسه مکان و قسمت آدرس)
iOS
- Placesclient؟
- Placesclient؟
- FetchPlaceFroplaceId: (از جمله شناسه Place ، و قسمت
GMSPlaceFieldFormattedAddress
)
وب سرویس
- درخواست خودکار را به صورت خودکار قرار می دهد (input = "par" ، session_token: xyz)
- درخواست خودکار را به صورت خودکار قرار می دهد (input = "پاریس" ، session_token: xyz)
- جزئیات مکان (place_id ، session_token: xyz ، زمینه ها: formatted_address)
در صورتحساب خود ، این SKU های ذکر شده را مشاهده خواهید کرد (هنگام مشاهده صورتحساب خود توسط SKU ):
- Autoclotte (شامل جزئیات مکان) - در هر جلسه (صورتحساب با 0.00 دلار)
- جزئیات مکان (قیمت شروع از 0.017 دلار در هر جلسه)
- داده های اساسی (صورتحساب با 0.00 دلار)
SKU: Query Autoclette - در هر درخواست
یک پرس و جو به صورت خودکار - برای هر درخواست SKU برای هر درخواست هزینه می شود:
- JavaScript: Maps JavaScript API سرویس های خودکار (
getQueryPredictions()
) و استفاده از نقشه های جعبه جستجوی MAPS JavaScript API (درخواست های خودکار خودکار به عنوان انواع کاربر تولید می شود). - سرویس وب: مکان های API Query Autoclotte Service
دامنه حجم ماهانه (قیمت در هر درخواست) | ||
---|---|---|
| | |
0.00283 دلار در هر کدام (2.83 دلار در هر 1000) | 0.00227 دلار در هر کدام (2.27 دلار در هر 1000) | برای قیمت گذاری حجم با فروش تماس بگیرید |
قیمت گذاری توسط جلسه خودکار با استفاده از پرس و جو AutoClote پشتیبانی نمی شود. جزئیات مکان های بعدی تماس ها بر اساس قیمت گذاری جزئیات مکان های معمولی شارژ می شوند.
SKU: جزئیات را قرار دهید
جزئیات مکان تماس ها به شرح زیر شارژ می شوند:
دامنه حجم ماهانه (قیمت در هر تماس) | ||
---|---|---|
| | |
در هر کدام 0.017 دلار (17.00 دلار در هر 1000) | 0.0136 دلار در هر کدام (13.60 دلار در هر 1000) | برای قیمت گذاری حجم با فروش تماس بگیرید |
جزئیات مکان SKU از این API ها تولید می شود:
- Android: SDK را برای Android (
fetchPlace()
) قرار می دهد - iOS: SDK را برای iOS (
fetchPlaceFromPlaceID:
:) - JavaScript: MAPS SERVITY PLACE PLACE JavaScript API (
getDetails
) - JavaScript: Maps JavaScript API Widget Autoclotte Widget (
getPlace
) - JavaScript: نقشه Widget Widget Widget :
getPlaces()
پس از انتخاب کاربر نتیجه (نماد: پین) ، * نه یک پرس و جو (نماد: بزرگنمایی) ، همانطور که در اینجا نشان داده شده است: - سرویس وب: محل خدمات جزئیات API را در مکان قرار می دهد
با استفاده از API و خدمات وب ، جزئیات مکان SKU شارژ می شود که آیا یک نشانه جلسه ارائه شده است یا خیر.
یک تماس و یا درخواست جزئیات مکان همچنین بسته به زمینه هایی که در تماس یا درخواست مشخص شده اند ، SKU های داده ( اساسی ، مخاطب و/یا جو ) را ایجاد می کند. اگر هیچ زمینه ای در محل تماس با جزئیات تماس یا درخواست مشخص نشده باشد ، کلیه SKU های داده ایجاد می شوند ، و شما برای مکان ها به جزئیات تماس یا درخواست به علاوه هزینه کلیه داده ها پرداخت می شود.
نمونه ها
- یکی از این تماس ها یا درخواست ها را انجام دهید:
- موبایل: با
fetchPlace()
با Android یاfetchPlaceFromPlaceID:
در iOS ، و فقط قسمتADDRESS
را مشخص کنید - API وب یا سرویس: یک مکان را درخواست کنید و فقط قسمت آدرس را مشخص کنید:
getPlaceDetails(fields: formatted_address)
- جزئیات مکان (قیمت شروع از 0.017 دلار در هر جلسه)
- داده های اساسی (صورتحساب با 0.00 دلار)
- موبایل: با
- یکی از این تماس ها یا درخواست ها را انجام دهید:
- موبایل: با
fetchPlace()
با Android یاfetchPlaceFromPlaceID:
در iOS تماس بگیرید و فقط قسمتPHONE_NUMBER
را مشخص کنید - API یا سرویس: یک مکان را درخواست کنید و قسمت شماره تلفن را مشخص کنید:
getPlaceDetails(fields: formatted_phone_number)
- Place Details (price starting at 0.017 USD per session)
- Contact Data (price starting at 0.003 USD per request)
- موبایل: با
- Make one of these calls or requests:
- Mobile: call
fetchPlace()
on Android orfetchPlaceFromPlaceID:
on iOS, and specify all the fields - Web API or service: make a Place Details request and specify all the fields (this type of request is the default if you do not specify any fields):
getPlaceDetails()
.
- Place Details (price starting at 0.017 USD per session)
- Basic Data (billed at 0.00 USD)
- Contact Data (price starting at 0.003 USD per request)
- Atmosphere Data (price starting at 0.005 USD per request)
- Mobile: call
SKU: Place Details – ID Refresh
Use the Place Details request to refresh stale place IDs . These types of requests are available at no charge.
MONTHLY VOLUME RANGE (Price per CALL) | ||
---|---|---|
| | |
0.00 USD | 0.00 USD | 0.00 USD |
مثال
Make a Place Details request specifying just the place id field: getPlaceDetails(fields: place_id)
. On your bill, you will see this SKU listed (when viewing your bill by SKU ):
- Place Details – ID Refresh (billed at 0.00 USD)
SKU: Find Place
Find Place is charged for a Find Place request.
MONTHLY VOLUME RANGE (Price per CALL) | ||
---|---|---|
| | |
0.017 USD per each (17.00 USD per 1000) | 0.0136 USD per each (13.60 USD per 1000) | Contact Sales for volume pricing |
Find Place requests also generate Data SKUs ( Basic , Contact , and/or Atmosphere ), depending on the fields that are specified in the request. Like Place Details requests, you can use the fields parameter in your Find Place request to limit the response to only those fields specified. You are billed for the Find Place request as well as the data requested. By default, if NO fields are requested, only the place id is returned, so no additional data charges are incurred.
نمونه ها
- You make a Find Place request and specify just the address field:
FindPlace(fields: formatted_address)
. On your bill, you will see these SKUs listed (when viewing your bill by SKU ):- Find Place (price starting at 0.017 USD per call)
- Basic Data (billed at 0.00 USD)
- You make a Find Place request and specify the phone number field:
FindPlace(fields: formatted_phone_number)
. On your bill, you will see these SKUs listed (when viewing your bill by SKU ):- Find Place (price starting at 0.017 USD per call)
- Contact Data (price starting at 0.003 USD per request)
- You make a Find Place request and specify fields from all three data-type buckets:
FindPlace(fields: formatted_address, opening_hours, price_level)
. On your bill, you will see these SKUs listed (when viewing your bill by SKU ):- Find Place (price starting at 0.017 USD per call)
- Basic Data (billed at 0.00 USD)
- Contact Data (price starting at 0.003 USD per request)
- Atmosphere Data (price starting at 0.005 USD per request)
SKU: Find Place – ID only
Find Place – ID only is charged for Find Place requests that only specify the Place ID to be returned. By default, if no fields are specified in the Find Place request, only the place id is returned.
MONTHLY VOLUME RANGE (Price per CALL) | ||
---|---|---|
| | |
0.00 USD | 0.00 USD | 0.00 USD |
مثال
You make a Find Place request and only specify the place_id
field: FindPlace(fields: place_id)
. On your bill, you will see this SKU listed (when viewing your bill by SKU ):
- Find Place – ID only (billed at 0.00 USD)
SKU: Find Current Place
Find Current Place is charged for calls to findCurrentPlace()
(Android) or findPlaceLikelihoodsFromCurrentLocationWithPlaceFields:
(iOS).
MONTHLY VOLUME RANGE (Price per CALL) | ||
---|---|---|
| | |
0.030 USD per each (30.00 USD per 1000) | 0.024 USD per each (24.00 USD per 1000) | Contact Sales for volume pricing |
Calls to findCurrentPlace()
(Android) or findPlaceLikelihoodsFromCurrentLocationWithPlaceFields:
(iOS) also generate Data SKUs ( Basic , Contact , and/or Atmosphere ), depending on the fields that are specified in the call. Specify data fields to limit the response to only those fields. You are billed for the Find Current Place call as well as the data requested.
نمونه ها
- You call
findCurrentPlace()
(Android) orfindPlaceLikelihoodsFromCurrentLocationWithPlaceFields:
(iOS) and specify just theADDRESS
field. On your bill, you will see these SKUs listed (when viewing your bill by SKU ):- Find Current Place (price starting at 0.030 USD per request)
- Basic Data (billed at 0.00 USD)
- You call
findCurrentPlace()
(Android) orfindPlaceLikelihoodsFromCurrentLocationWithPlaceFields:
(iOS) and specify thePHONE_NUMBER
field. On your bill, you will see these SKUs listed (when viewing your bill by SKU ):- Find Current Place (price starting at 0.030 USD per request)
- Contact Data (price starting at 0.003 USD per request)
- You call
findCurrentPlace()
(Android) orfindPlaceLikelihoodsFromCurrentLocationWithPlaceFields:
(iOS) and specify fields from all three data-type buckets. On your bill, you will see these SKUs listed (when viewing your bill by SKU ):- Find Current Place (price starting at 0.030 USD per request)
- Basic Data (billed at 0.00 USD)
- Contact Data (price starting at 0.003 USD per request)
- Atmosphere Data (price starting at 0.005 USD per request)
SKU: Place – Nearby Search
Place – Nearby Search is charged for requests to the Maps JavaScript API's Place Nearby Search service ( nearbySearch()
), or to the Places API Nearby Search service
MONTHLY VOLUME RANGE (Price per CALL) | ||
---|---|---|
| | |
0.032 USD per each (32.00 USD per 1000) | 0.0256 USD per each (25.60 USD per 1000) | Contact Sales for volume pricing |
Nearby Search requests return a list of places, but do not support specifying which fields are returned. Nearby Search requests return a subset of the supported data fields . You are charged for the Nearby Search request starting at 0.032 USD per each, as well as all of the data-type SKUs ( Basic Data , Contact Data , and Atmosphere Data ).
مثال
You make a Nearby Search request, such as NearbySearch (San Francisco, 100 meters)
. On your bill, you will see these SKUs listed (when viewing your bill by SKU ):
- Place - Nearby Search (price starting at 0.032 USD per call)
- Basic Data (billed at 0.00 USD)
- Contact Data (price starting at 0.003 USD per request)
- Atmosphere Data (price starting at 0.005 USD per request)
SKU: Place – Text Search
Place – Text Search is charged for requests to the Maps JavaScript API's Place Text Search service ( textSearch()
), or to the Places API Text Search service .
MONTHLY VOLUME RANGE (Price per CALL) | ||
---|---|---|
| | |
0.032 USD per each (32.00 USD per 1000) | 0.0256 USD per each (25.60 USD per 1000) | Contact Sales for volume pricing |
Text Search requests return a list of places, but do not support specifying which fields are returned. Text Search requests return a subset of the supported data fields . You are charged for the Text Search request starting at 0.032 USD per each, as well as all of the data-type SKUs ( Basic Data , Contact Data , and Atmosphere Data ).
The Place – Text Search SKU is also generated by the Maps JavaScript API's Place SearchBox widget : getPlaces()
method after the user selects a place query (icon: magnifier), not a result (icon: pin), as illustrated here:
مثال
You make a Text Search request, such as TextSearch(123 Main Street)
. On your bill, you will see these SKUs listed (when viewing your bill by SKU ):
- Place - Text Search (price starting at 0.032 USD per call)
- Basic Data (billed at 0.00 USD)
- Contact Data (price starting at 0.003 USD per request)
- Atmosphere Data (price starting at 0.005 USD per request)
SKU: Place Photo
A Place Photo SKU is charged for:
- Android: calls to
fetchPhoto()
- iOS: calls to
loadPlacePhoto:
- JavaScript: to Places Library, Maps JavaScript API's Place Photos service when requesting data from the URLs returned by
PlacePhoto.getUrl()
to load image pixel data - Web service: requests to the Places API Place Photos service
For the JavaScript service, invoking the PlacePhoto.getUrl()
method does not cause billing until the URL is actually used to obtain pixel data.
MONTHLY VOLUME RANGE (Price per CALL) | ||
---|---|---|
| | |
0.007 USD per each (7.00 USD per 1000) | 0.0056 USD per each (5.60 USD per 1000) | Contact Sales for volume pricing |
SKU: Geocoding
A Geocoding SKU is charged for requests to the Maps JavaScript API's Geocoding service or to the Geocoding API . In JavaScript , the method Geocoder.geocode()
initiates the request to the Geocoding Service.
MONTHLY VOLUME RANGE (Price per REQUEST) | ||
---|---|---|
| | |
0.005 USD per each (5.00 USD per 1000) | 0.004 USD per each (4.00 USD per 1000) | Contact Sales for volume pricing |
SKU: Geolocation
A Geolocation SKU is charged for requests to the Geolocation API .
MONTHLY VOLUME RANGE (Price per REQUEST) | ||
---|---|---|
| | |
0.005 USD per each (5.00 USD per 1000) | 0.004 USD per each (4.00 USD per 1000) | Contact Sales for volume pricing |
SKU: Map Tiles API: 2D Map Tiles
A request to Map Tiles API retrieving Roadmap , Satellite , or Terrain Tiles. Note that Session Token and Viewport information requests aren't billed.
MONTHLY VOLUME RANGE (Price per REQUEST) | |||||
---|---|---|---|---|---|
0 - 1,000,000 | 1,000,001 - 5,000,000 | 5,000,001+ | |||
0.0006 USD per each (0.60 USD per 1000) | 0.00048 USD per each (0.48 USD per 1000) | Contact Sales for volume pricing |
SKU: Map Tiles API: Street View Tiles
A request to Map Tiles API retrieving Street View Tiles, Street View Thumbnails, or Street View PanoIDs. Note that Session Token and Street View Metadata requests aren't billed.
MONTHLY VOLUME RANGE (Price per REQUEST) | |||||
---|---|---|---|---|---|
0 - 1,000,000 | 1,000,001 - 5,000,000 | 5,000,001+ | |||
0.002 USD per each (2.00 USD per 1000) | 0.0016 USD per each (1.60 USD per 1000) | Contact Sales for volume pricing |
SKU: Map Tiles API: Photorealistic 3D Tiles
A request to Map Tiles API retrieving 3D Root Tiles.
MONTHLY VOLUME RANGE (Price per REQUEST) | |||||
---|---|---|---|---|---|
| | | |||
0.006 USD per each (6.00 USD per 1000) | 0.0051 USD per each (5.10 USD per 1000) | Contact Sales for volume pricing |
SKU: Time Zone
A Time Zone SKU is charged for requests to the Time Zone API .
MONTHLY VOLUME RANGE (Price per REQUEST) | ||
---|---|---|
| | |
0.005 USD per each (5.00 USD per 1000) | 0.004 USD per each (4.00 USD per 1000) | Contact Sales for volume pricing |
SKU: Elevation
An Elevation SKU is charged for requests to the Maps JavaScript API ’s Elevation service or to the Elevation API .
MONTHLY VOLUME RANGE (Price per REQUEST) | ||
---|---|---|
| | |
0.005 USD per each (5.00 USD per 1000) | 0.004 USD per each (4.00 USD per 1000) | Contact Sales for volume pricing |
SKU: Address Validation
A request to the validateAddress method (REST) and ValidateAddress method (gRPC) of the Address Validation API .
MONTHLY VOLUME RANGE (Price per REQUEST) | ||
---|---|---|
| | |
0.017 USD per each (17.00 USD per 1000) | 0.0136 USD per each (13.60 USD per 1000) | Contact Sales for volume pricing |
SKU: Address Validation Preferred
Address Validation Preferred works with the Autocomplete (New) endpoint of the Places API when you use it with sessions that terminate with a call to the Address Validation API. Specifically, sessions that use Autocomplete (New) and terminate in either a request to validateAddress (REST) or ValidateAddress (gRPC) fall under this pricing model.
For details about both pricing and using Autocomplete (New) sessions with Places API, see the following guides in the Places API documentation:
When using Address Validation Preferred at the end of an Autocomplete (New) session, you are billed as follows:
MONTHLY VOLUME RANGE (Price per REQUEST) | ||
---|---|---|
| | |
0.025 USD per each (25.00 USD per 1000) | 0.020 USD per each (20.00 USD per 1000) | Contact Sales for volume pricing |
Environment product SKUs
APIs in Environment include: Air Quality API , Pollen API , and Solar API .
SKU: Air Quality
This SKU applies for the following endpoints and methods:
MONTHLY VOLUME RANGE (Price per REQUEST) | |||||
---|---|---|---|---|---|
| | | |||
0.005 USD per each (5.00 USD per 1000) | 0.004 USD per each (4.00 USD per 1000) | Contact Sales for volume pricing |
SKU: Pollen
This SKU applies for the following endpoints/methods:
MONTHLY VOLUME RANGE (Price per REQUEST) | |||||
---|---|---|---|---|---|
| | | |||
0.01 USD per each (10.00 USD per 1000) | 0.008 USD per each (8.00 USD per 1000) | Contact Sales for volume pricing |
SKU: Solar Building Insights
A request to buildingInsights .
MONTHLY VOLUME RANGE (Price per REQUEST) | |||||
---|---|---|---|---|---|
| | | |||
0.01 USD per each (10.00 USD per 1000) | 0.005 USD per each (5.00 USD per 1000) | Contact Sales for volume pricing |
SKU: Solar Data Layers
A request to dataLayers .
Accessing multiple imagery URLs from the same request does not generate additional charged queries. MONTHLY VOLUME RANGE (Price per REQUEST) | |||||
---|---|---|---|---|---|
| | | |||
0.075 USD per each (75.00 USD per 1000) | 0.0375 USD per each (37.50 USD per 1000) | Contact Sales for volume pricing |
Navigation SKU
Navigation SDKs include: Navigation SDK for Android and Navigation SDK for iOS .
SKU: Navigation Request
Each destination requested using the Navigation SDK is billed as a Navigation Request SKU unit. The price per SKU unit is determined by your total monthly call volume for the SKU:
MONTHLY VOLUME RANGE (Price per destination) | ||
---|---|---|
1–1,000 | 1,001–4,200,000 | 4,200,000+ |
بدون هزینه | 0.05 USD | 0.0395 USD |
Route request methods
Route generation requests to the Navigation SDK can be made by calling the following methods:
اندروید
- setDestination (Waypoint destination)
- setDestination (Waypoint destination, RoutingOptions options)
- setDestination (Waypoint destination, RoutingOptions routingOptions, DisplayOptions displayOptions)
- setDestinations (List<Waypoint> destinations)
- setDestinations (List<Waypoint> destinations, RoutingOptions options)
- setDestinations (List<Waypoint> destinations, CustomRoutesOptions customRoutesOptions)
- setDestinations (List<Waypoint> destinations, RoutingOptions routingOptions, DisplayOptions displayOptions)
- setDestinations (List<Waypoint> destinations, CustomRoutesOptions customRoutesOptions, DisplayOptions displayOptions)
- simulateLocationsAlongNewRoute(List<Waypoint> waypoints)
- simulateLocationsAlongNewRoute(List<Waypoint> waypoints, RoutingOptions routingOptions)
- simulateLocationsAlongNewRoute(List<Waypoint> waypoints, RoutingOptions routingOptions, SimulationOptions simulationOptions)
- [Deprecated] setDestinations (List<Waypoint> destinations, String routeToken)
iOS
Keep in mind that a single method call can contain up to 25 destinations, and the cost for each call is calculated by multiplying the number of destinations by the price per SKU unit .
،This section lists the SKUs defined for the core Google Maps Platform products. The core products are pay as you go and you only pay for the SKUs you use.
For each SKU listed you'll see:
- The SKU name as it appears on your billing report.
- Details describing the type of use that triggers the SKU (billable events).
- The price per each use for the volume-based tiers.
- Any additional SKU-specific pricing notes.
Look up individual product SKUs here, or use our Pricing and Usage calculator to estimate your usage versus total cost per API.
GMP Product / SKU table
Maps product SKUs
APIs in Maps include: Maps SDK for Android ; Maps SDK for iOS ; Maps JavaScript API ; Maps Static API ; Street View Static API ; and Maps Embed API .
SKU: Mobile Native Static Maps
Includes a Google map object in lite mode, not loaded with a map ID, in an Maps SDK for Android mobile application.
MONTHLY VOLUME RANGE (Price per MAP LOAD) | ||
---|---|---|
| | |
0.00 USD | 0.00 USD | 0.00 USD |
A single map load is accrued for each instantiation of a Google map object in lite mode, in a Maps SDK for Android mobile application. Maps are created with instances of MapFragment
, SupportMapFragment
, or MapView
classes. A map load is counted each time the related onCreate()
method is called.
SKU: Mobile Native Dynamic Maps
A Google map object, not loaded with a map ID, in a Maps SDK for Android or Maps SDK for iOS mobile application.
MONTHLY VOLUME RANGE (Price per MAP LOAD) | ||
---|---|---|
| | |
0.00 USD | 0.00 USD | 0.00 USD |
A single map load is accrued for each instantiation of a Google map object in a Maps SDK for Android or Maps SDK for iOS mobile application:
- One of
MapFragment
,SupportMapFragment
, orMapView
classes on Android. A map load is counted each time the relatedonCreate()
method is called. - A
GMSMapView
object on iOS.
User interactions with the map, such as panning, zooming, or switching map layers, do not generate additional map loads. With the pay-as-you-go pricing model, the creation of a Street View panorama is no longer charged as a Mobile Native map load. It is charged as a Dynamic Street View .
SKU: Embed and SKU: Embed Advanced
همه درخواستهای Maps Embed API بدون هزینه و با استفاده نامحدود در دسترس هستند.
SKU: Static Maps
A request to the Maps Static API .
MONTHLY VOLUME RANGE (Price per MAP LOAD) | ||
---|---|---|
| | |
0.002 USD per each (2.00 USD per 1000) | 0.0016 USD per each (1.60 USD per 1000) | Contact Sales for volume pricing |
SKU: Dynamic Maps
An application that displays either a map loaded with or without a map ID using Maps JavaScript API , or a map loaded with a map ID and using either the Maps SDK for Android or Maps SDK for iOS .
MONTHLY VOLUME RANGE (Price per MAP LOAD) | ||
---|---|---|
| | |
0.007 USD per each (7.00 USD per 1000) | 0.0056 USD per each (5.60 USD per 1000) | Contact Sales for volume pricing |
User interactions with the map, such as panning, zooming, or switching map layers, do not generate additional map loads.
SKU: Static Street View
Street View panoramas and map loads are now charged separately. A static Street View panorama is charged for each request to the Street View Static API to embed a static (non-interactive) Street View panorama. Usage of the Street View Image Metadata endpoint is not charged.
MONTHLY VOLUME RANGE (Price per PANORAMA) | ||
---|---|---|
| | |
0.007 USD per each (7.00 USD per 1000) | 0.0056 USD per each (5.60 USD per 1000) | Contact Sales for volume pricing |
SKU: Dynamic Street View
Street View panoramas and map loads are now charged separately. A dynamic Street View panorama is charged for each instantiation of a panorama object in a Maps JavaScript API , Maps SDK for Android , Maps SDK for iOS application.
MONTHLY VOLUME RANGE (Price per PANORAMA) | ||
---|---|---|
| | |
0.014 USD per each (14.00 USD per 1000) | 0.0112 USD per each (11.20 USD per 1000) | Contact Sales for volume pricing |
An instantiation of a panorama object occurs:
- In JavaScript , with the
google.maps.StreetViewPanorama()
class orMap.getStreetView()
method. Neither the built-in Street View experience based on the Street View Pegman control nor usage of theStreetViewService()
class is charged. - On Android , with one of
StreetViewPanoramaFragment
,SupportStreetViewPanoramaFragment
, orStreetViewPanoramaView
classes. A panorama is counted each time the relatedonCreate()
method is called. - On iOS , with the
GMSPanoramaView
object.
SKU: Aerial View
A request to the Aerial View API that returns an aerial video URL.
MONTHLY VOLUME RANGE (Price per successful lookupVideo request) | ||
---|---|---|
| | |
0.016 USD per each (16.00 USD per 1000) | 0.0128 USD per each (12.80 USD per 1000) | Contact Sales for volume pricing |
Only calls to lookupVideo
that return URLs are billed. A single, successful lookupVideo
response may return multiple URLs, each for a different resolution or orientation, but only constitutes a single billable event. Note that pricing does not depend on actual views of those URLs by end users.
Routes product SKUs
APIs in Routes include: Directions API ; Distance Matrix API ; and Roads API .
SKU: Directions
A request to the Maps JavaScript API's Directions Service (excludes requests triggering the Directions Advanced billing SKU) or the Directions API .
MONTHLY VOLUME RANGE (Price per QUERY) | ||
---|---|---|
| | |
0.005 USD per each (5.00 USD per 1000) | 0.004 USD per each (4.00 USD per 1000) | Contact Sales for volume pricing |
SKU: Directions Advanced
A request to the Maps JavaScript API's Directions Service or the Directions API that uses traffic information, more than 10 waypoints, waypoints optimization, and/or location modifiers.
MONTHLY VOLUME RANGE (Price per QUERY) | ||
---|---|---|
| | |
0.01 USD per each (10.00 USD per 1000) | 0.008 USD per each (8.00 USD per 1000) | Contact Sales for volume pricing |
A Directions Advanced SKU is charged for a Maps JavaScript API's Directions Service or a Directions API request that uses one or more of the following:
- Traffic information. Traffic information is used when all the following apply (these are the conditions required to receive the
duration_in_traffic
field in the Directions response):- The travel
mode
parameter isdriving
, or is not specified (driving
is the default travel mode). - The request includes a valid
departure_time
parameter . Thedeparture_time
can be set to the current time or some time in the future. It cannot be in the past. - The request does not include stopover waypoints . If the request includes waypoints, prefix each waypoint with
via:
to influence the route but avoid stopovers. به عنوان مثال،&waypoints=via:San Francisco|via:Mountain View|...
- The travel
- More than 10 waypoints (between 11 and 25).
- Waypoints optimization. The
optimize
parameter is set totrue
for waypoints. به عنوان مثال،&waypoints=optimize:true|San Francisco|Mountain View|...
- Location modifiers. When you use the following location modifiers to indicate how drivers should approach a particular location:
-
side_of_road
-
heading
-
SKU: Distance Matrix
A request to the Distance Matrix API or the Maps JavaScript API's Distance Matrix Service (excludes requests triggering the Distance Matrix Advanced billing SKU billing SKU).
MONTHLY VOLUME RANGE (Price per ELEMENT) | ||
---|---|---|
| | |
0.005 USD per each (5.00 USD per 1000) | 0.004 USD per each (4.00 USD per 1000) | Contact Sales for volume pricing |
Each query sent to the Distance Matrix API generates elements, where the number of origins
times the number of destinations
equals the number of elements.
SKU: Distance Matrix Advanced
A request to the Distance Matrix API or the Maps JavaScript API's Distance Matrix Service that uses traffic information and/or location modifiers.
MONTHLY VOLUME RANGE (Price per ELEMENT) | ||
---|---|---|
| | |
0.01 USD per each (10.00 USD per 1000) | 0.008 USD per each (8.00 USD per 1000) | Contact Sales for volume pricing |
Each query sent to the Distance Matrix API generates elements, where the number of origins
times the number of destinations
equals the number of elements.
A Distance Matrix Advanced SKU is charged for a Distance Matrix API or a Maps JavaScript API's Distance Matrix Service that uses one or more of the following:
- Traffic information. Traffic information is used when all the following apply (these are the conditions required to receive the
duration_in_traffic
field in the Distance Matrix response):- The travel
mode
parameter isdriving
, or is not specified (driving
is the default travel mode). - The request includes a valid
departure_time
parameter . Thedeparture_time
can be set to the current time or some time in the future. It cannot be in the past.
- The travel
- Location modifiers. When you use the following location modifiers to indicate how drivers should approach a particular location:
-
side_of_road
-
heading
-
SKU: Roads – Route Traveled
A request to the Roads API's Snap to Roads service .
MONTHLY VOLUME RANGE (Price per QUERY) | ||
---|---|---|
| | |
0.01 USD per each (10.00 USD per 1000) | 0.008 USD per each (8.00 USD per 1000) | Contact Sales for volume pricing |
SKU: Roads – Nearest Road
A request to the Roads API's Nearest Roads service .
MONTHLY VOLUME RANGE (Price per QUERY) | ||
---|---|---|
| | |
0.01 USD per each (10.00 USD per 1000) | 0.008 USD per each (8.00 USD per 1000) | Contact Sales for volume pricing |
SKU: Roads – Speed Limits
A request to the Roads API's Speed Limits service . MONTHLY VOLUME RANGE (Price per ELEMENT) | ||
---|---|---|
| | |
0.02 USD per each (20.00 USD per 1000) | 0.016 USD per each (16.00 USD per 1000) | Contact Sales for volume pricing |
Speed Limit requests are billed per speed limit element returned in the API response. This amount will always be equal to or less than the number of points passed in the original request.
SKU: Routes: Compute Routes - Basic
A request to Compute Routes .
MONTHLY VOLUME RANGE Price per QUERY | ||
---|---|---|
| | |
0.005 USD per each (5.00 USD per 1000) | 0.004 USD per each (4.00 USD per 1000) | Contact Sales for volume pricing |
SKU: Routes: Compute Routes - Advanced
A request to Compute Routes that uses advanced features.
MONTHLY VOLUME RANGE Price per QUERY | ||
---|---|---|
| | |
0.01 USD per each (10.00 USD per 1000) | 0.008 USD per each (8.00 USD per 1000) | Contact Sales for volume pricing |
The Advanced SKU is charged for a Compute Routes request that uses one or more of the following features:
- Between 11 and 25 intermediate waypoints
- Traffic aware or traffic aware optimal routing. These routing options correspond to setting the
routingPreference
property in the request toTRAFFIC_AWARE
orTRAFFIC_AWARE_OPTIMAL
. - Location modifiers. When you use the following options to indicate how drivers should approach a particular location:
SKU: Routes: Compute Routes - Preferred
A request to Compute Routes that uses preferred features.
MONTHLY VOLUME RANGE Price per QUERY | ||
---|---|---|
| | |
0.015 USD per each (15.00 USD per 1000) | 0.012 USD per each (12.00 USD per 1000) | Contact Sales for volume pricing |
The Preferred SKU is charged for a Compute Routes request that uses one or more of the following features:
SKU: Routes: Compute Route Matrix - Basic
A request to Compute Route Matrix .
MONTHLY VOLUME RANGE Price per ELEMENT | ||
---|---|---|
| | |
0.005 USD per each (5.00 USD per 1000) | 0.004 USD per each (4.00 USD per 1000) | Contact Sales for volume pricing |
SKU: Routes: Compute Route Matrix - Advanced
A request to Compute Route Matrix that uses advanced features.
MONTHLY VOLUME RANGE Price per ELEMENT | ||
---|---|---|
| | |
0.01 USD per each (10.00 USD per 1000) | 0.008 USD per each (8.00 USD per 1000) | Contact Sales for volume pricing |
The Advanced SKU is charged for a Compute Route Matrix request that uses one or more of the following features:
- Traffic aware or traffic aware optimal routing. These routing options correspond to setting the
routingPreference
property in the request toTRAFFIC_AWARE
orTRAFFIC_AWARE_OPTIMAL
. - Location modifiers. When you use the following options to indicate how drivers should approach a particular location:
SKU: Routes: Compute Route Matrix - Preferred
A request to Compute Route Matrix that uses preferred features.
MONTHLY VOLUME RANGE Price per ELEMENT | ||
---|---|---|
| | |
0.015 USD per each (15.00 USD per 1000) | 0.012 USD per each (12.00 USD per 1000) | Contact Sales for volume pricing |
The Preferred SKU is charged for a Compute Route Matrix request that uses one or more of the following features:
SKU: Route Optimization: Single Vehicle Routing
A request to the Route Optimization API that specifies exactly one vehicle.
MONTHLY VOLUME RANGE (Price per SHIPMENT) | ||
---|---|---|
| | |
0.01 USD per each (10.00 USD per 1000) | 0.004 USD per each (4.00 USD per 1000) | Contact Sales for volume pricing |
SKU: Route Optimization: Fleet Routing
A request to the Route Optimization API that specifies more than one vehicle.
MONTHLY VOLUME RANGE (Price per SHIPMENT) | ||
---|---|---|
| | |
0.03 USD per each (30.00 USD per 1000) | 0.014 USD per each (14.00 USD per 1000) | Contact Sales for volume pricing |
Places (New) product SKUs
About field masks
Use field masks, also called field lists , in your requests to specify the list of fields to return in the response. You are then billed at the highest SKU applicable to your request. That means if you select fields in both the (Basic) SKU and the (Advanced) SKU, you are billed based on the (Advanced) SKU.
Using a field mask is a good design practice to ensure that you don't request unnecessary data, which helps to avoid unnecessary processing time and billing charges.
About Autocomplete (New) sessions
An Autocomplete (New) session includes one or more Autocomplete (New) requests, and a Place Details (New) request or Address Validation request. The same session token is passed to the Autocomplete (New) request and to the subsequent Place Details (New) request or Address Validation request.
A session starts with the first Autocomplete (New) request. A Place Details (New) request or Address Validation request is then made when the user has selected one of the Autocomplete (New) suggestions. If a session is abandoned, meaning no Place Details (New) request or Address Validation request is made, Autocomplete (New) requests are charged as if no session token was provided.
After a user has selected a place (meaning a Place Details (New) request or Address Validation request is made), you must start a new session using a new session token.
A session token is good for one session and cannot be used for more than one session. If you reuse a session token, the session is considered invalid and the requests are charged as if no session token was provided.
SKU: Autocomplete Requests
An Autocomplete Requests SKU is charged for each request to the Autocomplete (New) API that does not include a session token.
It is also charged if you use session tokens and either:
- Terminate the sessions by a single request to Place Details (New) that requests any fields defined by the SKU: Place Details (Location Only) .
- Each Autocomplete (New) request, up to 12 requests, is billed using the SKU: Autocomplete Requests .
- Each subsequent Autocomplete (New) request is billed using the SKU: Autocomplete Session Usage .
- Abandon the session or end the session by making a call to the SKU: Place Details (IDs Only) . All Autocomplete (New) requests are then billed using the SKU: Autocomplete Requests .
MONTHLY VOLUME RANGE (Price per CALL) | ||
---|---|---|
| | |
0.00283 USD per each (2.83 USD per 1000) | 0.00227 USD per each (2.27 USD per 1000) | Contact Sales for volume pricing |
SKU: Autocomplete Session Usage
An Autocomplete Session Usage SKU is charged for each request to the Autocomplete (New) API that includes a session token.
This SKU is charged in these scenarios:
Autocomplete session terminated by a call to SKU: Place Details (Location Only) :
- Each Autocomplete (New) request, up to 12 requests, is billed using the SKU: Autocomplete Requests .
- Each subsequent Autocomplete (New) request is billed using the SKU: Autocomplete Session Usage .
Autocomplete session terminated with a call to SKU: Place Details (Basic, Advanced, or Preferred) .
A Place Details call that requests any field from the SKU: Place Details (Basic, Advanced, or Preferred) is billed at the SKU: Place Details (Preferred) .
Autocomplete session terminated with a call to SKU: Address Validation Preferred .
For more information, see Autocomplete (New) and session pricing .
MONTHLY VOLUME RANGE (Price per CALL) | ||
---|---|---|
| | |
0.00 USD per each (0.00 USD per 1000) | 0.00 USD per each (0.00 USD per 1000) | 0.00 USD per each (0.00 USD per 1000) |
SKU: Place Details (IDs Only)
Using a field mask or field list in your Place Details (New) request, you can limit the response to only those fields specified. This SKU is triggered when you only request the following fields:
Android : Place.Field.DISPLAY_NAME
, Place.Field.ID
, Place.Field.PHOTO_METADATAS
, Place.Field.RESOURCE_NAME
Places Library, Maps JavaScript API : id
, photos
iOS : GMSPlacePropertyPlaceID
, GMSPlacePropertyName
, GMSPlacePropertyPhotos
Web service : attributions
, id
, name
* , photos
* The name
field contains the place resource name in the form: places/ PLACE_ID
. Use displayName
to access the text name of the place.
MONTHLY VOLUME RANGE (Price per CALL) | ||
---|---|---|
| | |
0.0 USD per each (0.00 USD per 1000) | 0.0 USD per each (0.00 USD per 1000) | 0.0 USD per each (0.00 USD per 1000) |
SKU: Place Details (Location Only)
Using a field mask or field list in your Place Details (New) request, you can limit the response to only those fields specified. This SKU is triggered when you only request the following fields:
Android : Place.Field.ADDRESS_COMPONENTS
, ADR_FORMAT_ADDRESS
, Place.Field.FORMATTED_ADDRESS
, Place.Field.LOCATION
, Place.Field.PLUS_CODE
, Place.Field.SHORT_FORMATTED_ADDRESS
, Place.Field.TYPES
, Place.Field.VIEWPORT
Places Library, Maps JavaScript API : addressComponents
, adrFormatAddress
, formattedAddress
, location
, plusCode
, types
, viewport
iOS : GMSPlacePropertyAddressComponents
, GMSPlacePropertyFormattedAddress
, GMSPlacePropertyCoordinate
, GMSPlacePropertyPlusCode
, GMSPlacePropertyTypes
, GMSPlacePropertyViewport
Web service : addressComponents
, adrFormatAddress
, formattedAddress
, location
, plusCode
, shortFormattedAddress
, types
, viewport
MONTHLY VOLUME RANGE (Price per CALL) | ||
---|---|---|
| | |
0.005 USD per each (5.00 USD per 1000) | 0.004 USD per each (4.00 USD per 1000) | Contact Sales for volume pricing |
SKU: Place Details (Basic)
Using a field mask or field list in your Place Details (New) request, you can limit the response to only those fields specified. This SKU is triggered when you only request the following fields:
Android : Place.Field.ACCESSIBILITY_OPTIONS
, Place.Field.BUSINESS_STATUS
, Place.Field.GOOGLE_MAPS_URI
, Place.Field.ICON_BACKGROUND_COLOR
, Place.Field.ICON_MASK_URL
, Place.Field.PRIMARY_TYPE_DISPLAY_NAME
, Place.Field.SUB_DESTINATIONS
, Place.Field.UTC_OFFSET
Places Library, Maps JavaScript API : accessibilityOptions
, businessStatus
, displayName
, googleMapsUri
, iconBackgroundColor
, primaryTypeDisplayName
, svgIconMaskURI
, types
, utcOffsetMinutes
iOS : GMSPlacePropertyBusinessStatus
, GMSPlacePropertyIconBackgroundColor
, GMSPlacePropertyIconImageURL
, GMSPlacePropertyUTCOffsetMinutes
, GMSPlacePropertyWheelchairAccessibleEntrance
Web service : accessibilityOptions
, businessStatus
, displayName
, googleMapsUri
, iconBackgroundColor
, iconMaskBaseUri
, primaryType
, primaryTypeDisplayName
, subDestinations
, utcOffsetMinutes
If an Autocomplete session is terminated by a Place Details call that requests any field from the SKU: Place Details (Basic, Advanced, or Preferred) , then the call is billed at SKU: Place Details (Preferred) . For more information, see SKU: Autocomplete Session Usage .
MONTHLY VOLUME RANGE (Price per CALL) | ||
---|---|---|
| | |
0.0170 USD per each (17.00 USD per 1000) | 0.0136 USD per each (13.60 USD per 1000) | Contact Sales for volume pricing |
SKU: Place Details (Advanced)
Using a field mask or field list in your Place Details (New) request, you can limit the response to only those fields specified. This SKU is triggered when you only request the following fields:
Android : Place.Field.CURRENT_OPENING_HOURS
, Place.Field.CURRENT_SECONDARY_OPENING_HOURS
Place.Field.INTERNATIONAL_PHONE_NUMBER
, Place.Field.NATIONAL_PHONE_NUMBER
Place.Field.OPENING_HOURS
, Place.Field.PRICE_LEVEL
, Place.Field.RATING
, Place.Field.SECONDARY_OPENING_HOURS
, Place.Field.USER_RATING_COUNT
Place.Field.WEBSITE_URI
Places Library, Maps JavaScript API : internationalPhoneNumber
, nationalPhoneNumber
, priceLevel
, rating
, regularOpeningHours
, userRatingCount
, websiteUri
iOS : GMSPlacePropertyCurrentOpeningHours
, GMSPlacePropertySecondaryOpeningHours
, GMSPlacePropertyPhoneNumber
, GMSPlacePropertyPriceLevel
, GMSPlacePropertyRating
, GMSPlacePropertyOpeningHours
, GMSPlacePropertyUserRatingsTotal
, GMSPlacePropertyWebsite
Web service : currentOpeningHours
, currentSecondaryOpeningHours
, internationalPhoneNumber
, nationalPhoneNumber
, priceLevel
, rating
, regularOpeningHours
, regularSecondaryOpeningHours
, userRatingCount
, websiteUri
If an Autocomplete session is terminated by a Place Details call that requests any field from the SKU: Place Details (Basic, Advanced, or Preferred) , then the call is billed at SKU: Place Details (Preferred) . For more information, see SKU: Autocomplete Session Usage .
MONTHLY VOLUME RANGE (Price per CALL) | ||
---|---|---|
| | |
0.020 USD per each (20.00 USD per 1000) | 0.016 USD per each (16.00 USD per 1000) | Contact Sales for volume pricing |
SKU: Place Details (Preferred)
Using a field mask or field list in your Place Details (New) request, you can limit the response to only those fields specified. This SKU is triggered when you only request the following fields:
Android : Place.Field.ALLOWS_DOGS
, Place.Field.CURBSIDE_PICKUP
, Place.Field.DELIVERY
, Place.Field.DINE_IN
, Place.Field.EDITORIAL_SUMMARY
, Place.Field.EV_CHARGE_OPTIONS
, Place.Field.FUEL_OPTIONS
, Place.Field.GOOD_FOR_CHILDREN
, Place.Field.GOOD_FOR_GROUPS
, Place.Field.GOOD_FOR_WATCHING_SPORTS
, Place.Field.LIVE_MUSIC
, Place.Field.MENU_FOR_CHILDREN
, Place.Field.OUTDOOR_SEATING
, Place.Field.PARKING_OPTIONS
, Place.Field.PAYMENT_OPTIONS
, Place.Field.RESERVABLE
, Place.Field.RESTROOM
, Place.Field.REVIEWS
, Place.Field.SERVES_BEER
, Place.Field.SERVES_BREAKFAST
, Place.Field.SERVES_BRUNCH
, Place.Field.SERVES_COCKTAILS
, Place.Field.SERVES_COFFEE
, Place.Field.SERVES_DESSERT
, Place.Field.SERVES_DINNER
, Place.Field.SERVES_LUNCH
, Place.Field.SERVES_VEGETARIAN_FOOD
, Place.Field.SERVES_WINE
, Place.Field.TAKEOUT
Places Library, Maps JavaScript API : allowsDogs
, editorialSummary
, evChargeOptions
, fuelOptions
, hasCurbsidePickup
, hasDelivery
, hasDineIn
, hasLiveMusic
, hasMenuForChildren
, hasOutdoorSeating
, hasRestroom
, hasTakeout
, hasWifi
, isGoodForChildren
, isGoodForGroups
, isGoodForWatchingSports
, isReservable
, parkingOptions
, paymentOptions
, priceLevel
, reviews
, servesBeer
, servesBreakfast
, servesBrunch
, servesCocktails
, servesCoffee
, servesDessert
, servesDinner
, servesLunch
, servesVegetarianFood
, servesWine
iOS : GMSPlacePropertyCurbsidePickup
, GMSPlacePropertyDelivery
, GMSPlacePropertyDineIn
, GMSPlacePropertyEditorialSummary
, GMSPlacePropertyReservable
, GMSPlacePropertyReviews
, GMSPlacePropertyServesBeer
, GMSPlacePropertyServesBreakfast
, GMSPlacePropertyServesBrunch
, GMSPlacePropertyServesDinner
, GMSPlacePropertyServesLunch
, GMSPlacePropertyServesVegetarianFood
, GMSPlacePropertyServesWine
, GMSPlacePropertyTakeout
Web service : allowsDogs
, curbsidePickup
, delivery
, dineIn
, editorialSummary
, evChargeOptions
, fuelOptions
, goodForChildren
, goodForGroups
, goodForWatchingSports
, liveMusic
, menuForChildren
, parkingOptions
, paymentOptions
, outdoorSeating
, reservable
, restroom
, reviews
, routingSummaries
, * servesBeer
, servesBreakfast
, servesBrunch
, servesCocktails
, servesCoffee
, servesDessert
, servesDinner
, servesLunch
, servesVegetarianFood
, servesWine
, takeout
* Text Search and Nearby Search only
If an Autocomplete session is terminated by a Place Details call that requests any field from the SKU: Place Details (Basic, Advanced, or Preferred) , then the call is billed at SKU: Place Details (Preferred) . For more information, see SKU: Autocomplete Session Usage .
MONTHLY VOLUME RANGE (Price per CALL) | ||
---|---|---|
| | |
0.025 USD per each (25.00 USD per 1000) | 0.020 USD per each (20.00 USD per 1000) | Contact Sales for volume pricing |
SKU: Nearby Search (Basic)
Using a field mask or field list in your Nearby Search (New) request, you can limit the response to only those fields specified. This SKU is triggered when you only request the following fields:
Android : Place.Field.ADDRESS_COMPONENTS
, Place.Field.BUSINESS_STATUS
, Place.Field.ADDRESS
, Place.Field.ICON_BACKGROUND_COLOR
, Place.Field.ICON_URL
, Place.Field.LAT_LNG
, Place.Field.PHOTO_METADATAS
, Place.Field.PLUS_CODE
, Place.Field.ID
, Place.Field.NAME
, Place.Field.TYPES
, Place.Field.UTC_OFFSET
, Place.Field.VIEWPORT
, Place.Field.WHEELCHAIR_ACCESSIBLE_ENTRANCE
Places Library, Maps JavaScript API : accessibilityOptions
, addressComponents
, adrFormatAddress
, businessStatus
, displayName
, formattedAddress
, googleMapsUri
, iconBackgroundColor
, id
, location
, photos
, plusCode
, svgIconMaskURI
, types
, utcOffsetMinutes
, viewport
iOS : GMSPlacePropertyAddressComponents
, GMSPlacePropertyBusinessStatus
, GMSPlacePropertyCoordinate
, GMSPlacePropertyFormattedAddress
, GMSPlacePropertyName
, GMSPlacePropertyIconBackgroundColor
, GMSPlacePropertyIconImageURL
, GMSPlacePropertyPhotos
, GMSPlacePropertyPlaceID
, GMSPlacePropertyPlusCode
, GMSPlacePropertyTypes
, GMSPlacePropertyUTCOffsetMinutes
, GMSPlacePropertyViewport
, GMSPlacePropertyWheelchairAccessibleEntrance
Web service : places.accessibilityOptions
, 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
, places.primaryType
, places.primaryTypeDisplayName
, places.shortFormattedAddress
, places.subDestinations
, places.types
, places.utcOffsetMinutes
, places.viewport
* The places.name
field contains the place resource name in the form: places/ PLACE_ID
. Use places.displayName
to access the text name of the place.
MONTHLY VOLUME RANGE (Price per CALL) | ||
---|---|---|
| | |
0.032 USD per each (32.00 USD per 1000) | 0.0256 USD per each (25.60 USD per 1000) | Contact Sales for volume pricing |
SKU: Nearby Search (Advanced)
Using a field mask or field list in your Nearby Search (New) request, you can limit the response to only those fields specified. This SKU is triggered when you only request the following fields:
Android : Place.Field.CURRENT_OPENING_HOURS
, Place.Field.CURRENT_SECONDARY_OPENING_HOURS
Place.Field.INTERNATIONAL_PHONE_NUMBER
, Place.Field.NATIONAL_PHONE_NUMBER
Place.Field.OPENING_HOURS
, Place.Field.PRICE_LEVEL
, Place.Field.RATING
, Place.Field.SECONDARY_OPENING_HOURS
, Place.Field.USER_RATING_COUNT
Place.Field.WEBSITE_URI
Places Library, Maps JavaScript API : internationalPhoneNumber
, nationalPhoneNumber
, priceLevel
, rating
, regularOpeningHours
, userRatingCount
, websiteUri
iOS : GMSPlacePropertyCurrentOpeningHours
, GMSPlacePropertySecondaryOpeningHours
, GMSPlacePropertyPhoneNumber
, GMSPlacePropertyPriceLevel
, GMSPlacePropertyRating
, GMSPlacePropertyOpeningHours
, GMSPlacePropertyUserRatingsTotal
, GMSPlacePropertyWebsite
Web service : places.currentOpeningHours
, places.currentSecondaryOpeningHours
, places.internationalPhoneNumber
, places.nationalPhoneNumber
, places.priceLevel
, places.rating
, places.regularOpeningHours
, places.regularSecondaryOpeningHours
, places.userRatingCount
, places.websiteUri
MONTHLY VOLUME RANGE (Price per CALL) | ||
---|---|---|
| | |
0.035 USD per each (35.00 USD per 1000) | 0.028 USD per each (28.00 USD per 1000) | Contact Sales for volume pricing |
SKU: Nearby Search (Preferred)
Using a field mask or field list in your Nearby Search (New) request, you can limit the response to only those fields specified. This SKU is triggered when you only request the following fields:
Android : Place.Field.ALLOWS_DOGS
, Place.Field.CURBSIDE_PICKUP
, Place.Field.DELIVERY
, Place.Field.DINE_IN
, Place.Field.EDITORIAL_SUMMARY
, Place.Field.EV_CHARGE_OPTIONS
, Place.Field.FUEL_OPTIONS
, Place.Field.GOOD_FOR_CHILDREN
, Place.Field.GOOD_FOR_GROUPS
, Place.Field.GOOD_FOR_WATCHING_SPORTS
, Place.Field.LIVE_MUSIC
, Place.Field.MENU_FOR_CHILDREN
, Place.Field.OUTDOOR_SEATING
, Place.Field.PARKING_OPTIONS
, Place.Field.PAYMENT_OPTIONS
, Place.Field.RESERVABLE
, Place.Field.RESTROOM
, Place.Field.REVIEWS
, Place.Field.SERVES_BEER
, Place.Field.SERVES_BREAKFAST
, Place.Field.SERVES_BRUNCH
, Place.Field.SERVES_COCKTAILS
, Place.Field.SERVES_COFFEE
, Place.Field.SERVES_DESSERT
, Place.Field.SERVES_DINNER
, Place.Field.SERVES_LUNCH
, Place.Field.SERVES_VEGETARIAN_FOOD
, Place.Field.SERVES_WINE
, Place.Field.TAKEOUT
Places Library, Maps JavaScript API : allowsDogs
, editorialSummary
, evChargeOptions
, fuelOptions
, hasCurbsidePickup
, hasDelivery
, hasDineIn
, hasLiveMusic
, hasMenuForChildren
, hasOutdoorSeating
, hasRestroom
, hasTakeout
, hasWifi
, isGoodForChildren
, isGoodForGroups
, isGoodForWatchingSports
, isReservable
, parkingOptions
, paymentOptions
, priceLevel
, reviews
, servesBeer
, servesBreakfast
, servesBrunch
, servesCocktails
, servesCoffee
, servesDessert
, servesDinner
, servesLunch
, servesVegetarianFood
, servesWine
iOS : GMSPlacePropertyCurbsidePickup
, GMSPlacePropertyDelivery
, GMSPlacePropertyDineIn
, GMSPlacePropertyEditorialSummary
, GMSPlacePropertyReservable
, GMSPlacePropertyReviews
, GMSPlacePropertyServesBeer
, GMSPlacePropertyServesBreakfast
, GMSPlacePropertyServesBrunch
, GMSPlacePropertyServesDinner
, GMSPlacePropertyServesLunch
, GMSPlacePropertyServesVegetarianFood
, GMSPlacePropertyServesWine
, GMSPlacePropertyTakeout
Web service : 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
, places.restroom
, places.reviews
, places.routingSummaries
, * places.servesBeer
, places.servesBreakfast
, places.servesBrunch
, places.servesCocktails
, places.servesCoffee
, places.servesDessert
, places.servesDinner
, places.servesLunch
, places.servesVegetarianFood
, places.servesWine
, places.takeout
* Text Search and Nearby Search only
MONTHLY VOLUME RANGE (Price per CALL) | ||
---|---|---|
| | |
0.040 USD per each (40.00 USD per 1000) | 0.032 USD per each (32.00 USD per 1000) | Contact Sales for volume pricing |
SKU: Text Search (ID Only)
Using a field mask or field list in your Text Search (New) request, you can limit the response to only those fields specified. This SKU is triggered when you only request the following fields:
Android : Place.Field.DISPLAY_NAME
, Place.Field.ID
, Place.Field.RESOURCE_NAME
iOS : GMSPlacePropertyPlaceID
, GMSPlacePropertyName
Places Library, Maps JavaScript API : id
Web service : places.attributions
, places.id
, places.name
* , nextPageToken
* The places.name
field contains the place resource name in the form: places/ PLACE_ID
. Use places.displayName
to access the text name of the place.
MONTHLY VOLUME RANGE (Price per CALL) | ||
---|---|---|
| | |
0.0 USD per each (0.00 USD per 1000) | 0.0 USD per each (0.00 USD per 1000) | 0.0 USD per each (0.00 USD per 1000) |
SKU: Text Search (Basic)
Using a field mask or field list in your Text Search (New) request, you can limit the response to only those fields specified. This SKU is triggered when you only request the following fields:
Android : Place.Field.ACCESSIBILITY_OPTIONS
, Place.Field.ADDRESS_COMPONENTS
, Place.Field.ADR_FORMAT_ADDRESS
, Place.Field.BUSINESS_STATUS
, Place.Field.FORMATTED_ADDRESS
, Place.Field.GOOGLE_MAPS_URI
, Place.Field.ICON_BACKGROUND_COLOR
, Place.Field.ICON_MASK_URL
, Place.Field.LOCATION
, Place.Field.PHOTO_METADATAS
, Place.Field.PLUS_CODE
, Place.Field.PRIMARY_TYPE_DISPLAY_NAME
, Place.Field.SHORT_FORMATTED_ADDRESS
, Place.Field.SUB_DESTINATIONS
, Place.Field.TYPES
, Place.Field.UTC_OFFSET
, Place.Field.VIEWPORT
iOS : GMSPlacePropertyAddressComponents
, GMSPlacePropertyBusinessStatus
, GMSPlacePropertyFormattedAddress
, GMSPlacePropertyIconBackgroundColor
, GMSPlacePropertyIconImageURL
, GMSPlacePropertyCoordinate
, GMSPlacePropertyPhotos
, GMSPlacePropertyPlusCode
, GMSPlacePropertyTypes
, GMSPlacePropertyUTCOffsetMinutes
, GMSPlacePropertyViewport
, GMSPlacePropertyWheelchairAccessibleEntrance
Places Library, Maps JavaScript API : accessibilityOptions
, addressComponents
, adrFormatAddress
, businessStatus
, displayName
, formattedAddress
, googleMapsUri
, iconBackgroundColor
, location
, photos
, plusCode
, svgIconMaskURI
, types
, utcOffsetMinutes
, viewport
Web service : 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.types
, places.utcOffsetMinutes
, places.viewport
MONTHLY VOLUME RANGE (Price per CALL) | ||
---|---|---|
| | |
0.032 USD per each (32.00 USD per 1000) | 0.0256 USD per each (25.60 USD per 1000) | Contact Sales for volume pricing |
SKU: Text Search (Advanced)
Using a field mask or field list in your Text Search (New) request, you can limit the response to only those fields specified. This SKU is triggered when you only request the following fields:
Android : Place.Field.CURRENT_OPENING_HOURS
, Place.Field.CURRENT_SECONDARY_OPENING_HOURS
Place.Field.INTERNATIONAL_PHONE_NUMBER
, Place.Field.NATIONAL_PHONE_NUMBER
Place.Field.OPENING_HOURS
, Place.Field.PRICE_LEVEL
, Place.Field.RATING
, Place.Field.SECONDARY_OPENING_HOURS
, Place.Field.USER_RATING_COUNT
Place.Field.WEBSITE_URI
iOS : GMSPlacePropertyCurrentOpeningHours
, GMSPlacePropertySecondaryOpeningHours
, GMSPlacePropertyPhoneNumber
, GMSPlacePropertyPriceLevel
, GMSPlacePropertyRating
, GMSPlacePropertyOpeningHours
, GMSPlacePropertyUserRatingsTotal
, GMSPlacePropertyWebsite
Web service : places.currentOpeningHours
, places.currentSecondaryOpeningHours
, places.internationalPhoneNumber
, places.nationalPhoneNumber
, places.priceLevel
, places.rating
, places.regularOpeningHours
, places.regularSecondaryOpeningHours
, places.userRatingCount
, places.websiteUri
Places Library, Maps JavaScript API : internationalPhoneNumber
, nationalPhoneNumber
, priceLevel
, rating
, regularOpeningHours
, userRatingCount
, websiteUri
MONTHLY VOLUME RANGE (Price per CALL) | ||
---|---|---|
| | |
0.035 USD per each (35.00 USD per 1000) | 0.028 USD per each (28.00 USD per 1000) | Contact Sales for volume pricing |
SKU: Text Search (Preferred)
Using a field mask or field list in your Text Search (New) request, you can limit the response to only those fields specified. This SKU is triggered when you only request the following fields:
Android : Place.Field.ALLOWS_DOGS
, Place.Field.CURBSIDE_PICKUP
, Place.Field.DELIVERY
, Place.Field.DINE_IN
, Place.Field.EDITORIAL_SUMMARY
, Place.Field.EV_CHARGE_OPTIONS
, Place.Field.FUEL_OPTIONS
, Place.Field.GOOD_FOR_CHILDREN
, Place.Field.GOOD_FOR_GROUPS
, Place.Field.GOOD_FOR_WATCHING_SPORTS
, Place.Field.LIVE_MUSIC
, Place.Field.MENU_FOR_CHILDREN
, Place.Field.OUTDOOR_SEATING
, Place.Field.PARKING_OPTIONS
, Place.Field.PAYMENT_OPTIONS
, Place.Field.RESERVABLE
, Place.Field.RESTROOM
, Place.Field.REVIEWS
, Place.Field.SERVES_BEER
, Place.Field.SERVES_BREAKFAST
, Place.Field.SERVES_BRUNCH
, Place.Field.SERVES_COCKTAILS
, Place.Field.SERVES_COFFEE
, Place.Field.SERVES_DESSERT
, Place.Field.SERVES_DINNER
, Place.Field.SERVES_LUNCH
, Place.Field.SERVES_VEGETARIAN_FOOD
, Place.Field.SERVES_WINE
, Place.Field.TAKEOUT
iOS : GMSPlacePropertyCurbsidePickup
, GMSPlacePropertyDelivery
, GMSPlacePropertyDineIn
, GMSPlacePropertyEditorialSummary
, GMSPlacePropertyReservable
, GMSPlacePropertyReviews
, GMSPlacePropertyServesBeer
, GMSPlacePropertyServesBreakfast
, GMSPlacePropertyServesBrunch
, GMSPlacePropertyServesDinner
, GMSPlacePropertyServesLunch
, GMSPlacePropertyServesVegetarianFood
, GMSPlacePropertyServesWine
, GMSPlacePropertyTakeout
Places Library, Maps JavaScript API : allowsDogs
, editorialSummary
, evChargeOptions
, fuelOptions
, hasCurbsidePickup
, hasDelivery
, hasDineIn
, hasLiveMusic
, hasMenuForChildren
, hasOutdoorSeating
, hasRestroom
, hasTakeout
, hasWifi
, isGoodForChildren
, isGoodForGroups
, isGoodForWatchingSports
, isReservable
, parkingOptions
, paymentOptions
, priceLevel
, reviews
, servesBeer
, servesBreakfast
, servesBrunch
, servesCocktails
, servesCoffee
, servesDessert
, servesDinner
, servesLunch
, servesVegetarianFood
, servesWine
Web service : 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
, places.restroom
, places.reviews
, places.routingSummaries
, * places.servesBeer
, places.servesBreakfast
, places.servesBrunch
, places.servesCocktails
, places.servesCoffee
, places.servesDessert
, places.servesDinner
, places.servesLunch
, places.servesVegetarianFood
, places.servesWine
, places.takeout
* Text Search and Nearby Search only
MONTHLY VOLUME RANGE (Price per CALL) | ||
---|---|---|
| | |
0.040 USD per each (40.00 USD per 1000) | 0.032 USD per each (32.00 USD per 1000) | Contact Sales for volume pricing |
SKU: Place Photo
A Place Photo SKU is charged for each request to the API.
MONTHLY VOLUME RANGE (Price per CALL) | ||
---|---|---|
| | |
0.007 USD per each (7.00 USD per 1000) | 0.0056 USD per each (5.60 USD per 1000) | Contact Sales for volume pricing |
Places product SKUs
APIs in Places include Places API , Places SDK for Android ; Places SDK for iOS ; Places Library, Maps JavaScript API ; Geocoding API ; Geolocation API ; Time Zone API ; and Elevation API .
About Autocomplete sessions
An Autocomplete session includes some Autocomplete requests (to retrieve suggestions on a place as the user types), and at most one Places Details request (to retrieve details about the place selected by the user). The same session token is passed to the Autocomplete and the subsequent Place Detail request. A session starts with the first Autocomplete request (which typically happens when the user starts typing). A Places Details call is made when the user has selected one of the Autocomplete suggestions. If a user does not select a suggestion, no Places Details call is made.
After a user has selected a place (ie, a Places Details call is made), you must start a new session using a new session token.
Autocomplete sessions can be generated from the following APIs:
- The Places API Place Autocomplete service or the Maps JavaScript API's Places Autocomplete service . You need to design your application to provide session tokens (you may need to change your existing code).
- The Maps JavaScript API's Autocomplete widget . Session-based billing is automatically enabled on those widgets, without any code change required.
A session token is good for one user session and should not be used for more than one user session. If you reuse a session token, the session is considered invalid and the requests are charged as if no session token was provided.
The Autocomplete requests and the Places Details requests using sessions are billed on different SKUs.
About Places Data SKUs
The three Places Data SKUs are: Basic Data , Contact Data , and Atmosphere Data .One or more Data SKUs are triggered for:
- Android: each request to
fetchPlace()
orfindCurrentPlace()
- iOS: each call to
fetchPlaceFromPlaceID:
orfindPlaceLikelihoodsFromCurrentLocationWithPlaceFields:
- Web service: each Places request depending on the fields specified in the request
Data SKUs are always charged in addition to the base SKU for the request triggering them. For example, a Place Details request including Basic Data fields will be charged both under the Basic Data SKU and the Place Details SKU.
For the web service, these Places APIs calls support specifying the data fields to return:
For the web service, these Places APIs calls DO NOT support specifying the returned fields. These calls always return all the Places data, charging the three Places Data SKUs in addition to the charge for each API request:
SKU: Basic Data
Using the fields parameter in your Place Details or Find Place request, you can limit the response to only those fields specified. Fields in the Basic category are included in the base cost of the Places request and do not result in any additional charge. The Basic Data SKU is triggered when any of these fields are requested:
- Android:
Place.Field.ACCESSIBILITY_OPTIONS
,Place.Field.ADDRESS_COMPONENTS
,Place.Field.BUSINESS_STATUS
,Place.Field.DISPLAY_NAME
,Place.Field.FORMATTED_ADDRESS
,Place.Field.ICON_BACKGROUND_COLOR
,Place.Field.ICON_MASK_URL
,Place.Field.ID
,Place.Field.LOCATION
,Place.Field.PHOTO_METADATAS
,Place.Field.PLUS_CODE
,Place.Field.TYPES
,Place.Field.VIEWPORT
, orPlace.Field.UTC_OFFSET
. - iOS:
GMSPlaceFieldFormattedAddress
,GMSPlaceFieldBusinessStatus
,GMSPlaceFieldID
,GMSPlaceFieldCoordinate
,GMSPlaceFieldName
,GMSPlaceFieldPhotos
,GMSPlaceFieldPlusCode
,GMSPlaceFieldTypes
, orGMSPlaceFieldViewport
- Web service:
address_component
,adr_address
,business_status
,formatted_address
,geometry
,icon
,name
,permanently_closed
,photo
,place_id
,plus_code
,type
,url
,utc_offset
,vicinity
, orwheelchair_accessible_entrance
MONTHLY VOLUME RANGE (Price per CALL) | ||
---|---|---|
| | |
Places request cost + 0.00 USD | Places request cost + 0.00 USD | Places request cost + 0.00 USD |
SKU: Contact Data
Using the fields parameter in your Place Details or Find Place request for web services, or an array of Place.Field
s for Android or iOS, you can limit the response to only those fields specified. Fields in the Contact category result in an additional charge. The Contact Data SKU is triggered when any of these fields are requested:
- Android:
Place.Field.CURRENT_OPENING_HOURS
,Place.Field.INTERNATIONAL_PHONE_NUMBER
,Place.Field.OPENING_HOURS
,Place.Field.SECONDARY_OPENING_HOURS
, orPlace.Field.WEBSITE_URI
- iOS:
GMSPlaceFieldOpeningHours
,GMSPlaceFieldPhoneNumber
, orGMSPlaceFieldWebsite
- Web service:
formatted_phone_number
,international_phone_number
,opening_hours
,current_opening_hours
,secondary_opening_hours
, orwebsite
MONTHLY VOLUME RANGE (Price per CALL) | ||
---|---|---|
| | |
Places request cost + 0.003 USD per each (+ 3.00 USD per 1000) | Places request cost + 0.0024 USD per each (+ 2.40 USD per 1000) | Contact Sales for volume pricing |
SKU: Atmosphere Data
Using the fields parameter in your Place Details or Find Place request, you can limit the response to only those fields specified. Fields in the Atmosphere category result in an additional charge. The Atmosphere Data SKU is triggered when any of these fields are requested:
- 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
, orPlace.Field.USER_RATING_COUNT
- iOS:
GMSPlaceFieldPriceLevel
,GMSPlaceFieldRating
,GMSPlaceFieldUserRatingsTotal
,GMSPlaceFieldTakeout
,GMSPlaceFieldDelivery
,GMSPlaceFieldDineIn
,GMSPlaceFieldCurbsidePickup
,GMSPlaceFieldReservable
,GMSPlaceFieldServesBreakfast
,GMSPlaceFieldServesLunch
,GMSPlaceFieldServesDinner
,GMSPlaceFieldServesBeer
,GMSPlaceFieldServesWine
,GMSPlaceFieldServesBrunch
orGMSPlaceFieldServesVegetarianFood
. - JavaScript : See Fields (Place details)
- Web service :
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
, oruser_ratings_total
.
MONTHLY VOLUME RANGE (Price per CALL) | ||
---|---|---|
| | |
Places request cost + 0.005 USD per each (+ 5.00 USD per 1000) | Places request cost + 0.004 USD per each (+ 4.00 USD per 1000) | Contact Sales for volume pricing |
SKU: Autocomplete – Per Request
The Autocomplete – Per Request SKU is charged for any of these calls or requests that do not include a session token:
- Android:
findAutocompletePredictions()
- iOS:
findAutocompletePredictionsFromQuery:
- JavaScript: the Maps JavaScript API's Place Autocomplete service
- Web service: the Places API Place Autocomplete service
Calls made from an invalid Autocomplete session (for example, a session that reuses a session token) are also charged an Autocomplete – Per Request SKU.
Autocomplete requests from the Maps JavaScript API's Place Autocomplete Widget may be charged an Autocomplete – Per Request SKU in case calls are made from an invalid Autocomplete session. This may happen when a user is typing multiple different addresses or copy/pasting different addresses into the widget and not always selects an autocomplete prediction.
MONTHLY VOLUME RANGE (Price per REQUEST) | ||
---|---|---|
| | |
0.00283 USD per each (2.83 USD per 1000) | 0.00227 USD per each (2.27 USD per 1000) | Contact Sales for volume pricing |
SKU: Autocomplete without Place Details – Per Session
The Autocomplete without Place Details – Per Session SKU is charged for an Autocomplete session that does not include a Place Details request (within a few minutes of the beginning of the session).
MONTHLY VOLUME RANGE (Price per SESSION) | ||
---|---|---|
| | |
0.017 USD per each (17.00 USD per 1000) | 0.0136 USD per each (13.60 USD per 1000) | Contact Sales for volume pricing |
مثال
If your application issues these two calls in a single session:
اندروید
- findAutocompletePredictions() (.setQuery(”par”), .setSessionToken(XYZ))
- findAutocompletePredictions() (.setQuery(”paris”), .setSessionToken(XYZ))
iOS
- placesClient?.findAutocompletePredictions(fromQuery: "par" ...
- placesClient?.findAutocompletePredictions(fromQuery: "paris" ...
وب سرویس
- Place Autocomplete Request (input=”par”, session_token: XYZ)
- Place Autocomplete Request (input=”paris”, session_token: XYZ)
On your bill, you will see this SKU listed (when viewing your bill by SKU ):
- Autocomplete without Place Details – Per Session (price starting at 0.017 USD per session)
SKU: Autocomplete (included with Place Details) – Per Session
The Autocomplete (included with Place Details) – Per Session SKU is charged for an Autocomplete session that includes any of:
- Android: a call to
fetchPlace()
- iOS: a call to
fetchPlaceFromPlaceID:
- Web service: a Place Details request
The autocomplete request is available at no charge, and the subsequent Place Details call gets charged based on regular Place Details pricing .
A Place Details request generates Data SKUs ( Basic , Contact , and/or Atmosphere ) – depending on the fields that are specified in the request.
If you do not specify fields in the Place Details request, all Data SKUs are triggered (Basic, Contact, and Atmosphere).
Place Details ID refresh requests (requests that specify only the place_id
field) during an autocomplete session are billed as SKU: Autocomplete without Place Details – Per Session .
MONTHLY VOLUME RANGE (Price per SESSION) | ||
---|---|---|
| | |
0.00 USD | 0.00 USD | 0.00 USD |
مثال
If your application issues the following three calls in a single session:
اندروید
- findAutocompletePredictions() (.setQuery(”par”), .setSessionToken(XYZ))
- findAutocompletePredictions() (.setQuery(”paris”), .setSessionToken(XYZ))
- fetchPlace() (with a
FetchPlaceRequest
including the Place ID, and the ADDRESS field)
iOS
- placesClient?.findAutocompletePredictions(fromQuery: "par" ...
- placesClient?.findAutocompletePredictions(fromQuery: "paris" ...
- fetchPlaceFromPlaceID: (including the Place ID, and the
GMSPlaceFieldFormattedAddress
field)
وب سرویس
- Places Autocomplete Request (input=”par”, session_token: XYZ)
- Places Autocomplete Request (input=”paris”, session_token: XYZ)
- Places Details (place_id, session_token: XYZ, fields:formatted_address)
On your bill, you will see these SKUs listed (when viewing your bill by SKU ):
- Autocomplete (included with Place Details) – Per Session (billed at 0.00 USD)
- Place Details (price starting at 0.017 USD per session)
- Basic Data (billed at 0.00 USD)
SKU: Query Autocomplete – Per Request
A Query Autocomplete – Per Request SKU is charged for each request to:
- JavaScript: the Maps JavaScript API's Places Autocomplete Service (
getQueryPredictions()
) and the use of the Maps JavaScript API's SearchBox widget (Query Autocomplete requests are generated as the user types). - Web service: the Places API Query Autocomplete service
MONTHLY VOLUME RANGE (Price per REQUEST) | ||
---|---|---|
| | |
0.00283 USD per each (2.83 USD per 1000) | 0.00227 USD per each (2.27 USD per 1000) | Contact Sales for volume pricing |
Pricing by Autocomplete session is not supported using Query Autocomplete. Subsequent Places Details calls get charged based on regular Places Details pricing .
SKU: Place Details
Place Details calls are charged as follows:
MONTHLY VOLUME RANGE (Price per CALL) | ||
---|---|---|
| | |
0.017 USD per each (17.00 USD per 1000) | 0.0136 USD per each (13.60 USD per 1000) | Contact Sales for volume pricing |
The Place Details SKU is generated from these APIs:
- Android: Places SDK for Android (
fetchPlace()
) - iOS: Places SDK for iOS (
fetchPlaceFromPlaceID:
) - JavaScript: Maps JavaScript API's Place Details service (
getDetails
) - JavaScript: Maps JavaScript API's Place Autocomplete widget (
getPlace
) - JavaScript: Maps JavaScript API's Place SearchBox widget :
getPlaces()
method after the user selects a place result (icon: pin), *not* a query (icon: magnifier), as illustrated here: - Web service: Places API Place Details service
With the web API and services, the Place Details SKU is charged whether a session token is provided or not.
A Place Details call or request also generates Data SKUs ( Basic , Contact , and/or Atmosphere ), depending on the fields that are specified in the call or request. If NO fields are specified in the Place Details call or request, ALL Data SKUs are triggered, and you are charged for the Places Details call or request plus the cost of all the data.
نمونه ها
- Make one of these calls or requests:
- Mobile: call
fetchPlace()
on Android orfetchPlaceFromPlaceID:
on iOS, and specify just theADDRESS
field - Web API or service: make a Place Details request and specify just the address field:
getPlaceDetails(fields: formatted_address)
- Place Details (price starting at 0.017 USD per session)
- Basic Data (billed at 0.00 USD)
- Mobile: call
- Make one of these calls or requests:
- Mobile: call
fetchPlace()
on Android orfetchPlaceFromPlaceID:
on iOS, and specify just thePHONE_NUMBER
field - Web API or service: make a Place Details request and specify the phone number field:
getPlaceDetails(fields: formatted_phone_number)
- Place Details (price starting at 0.017 USD per session)
- Contact Data (price starting at 0.003 USD per request)
- Mobile: call
- Make one of these calls or requests:
- Mobile: call
fetchPlace()
on Android orfetchPlaceFromPlaceID:
on iOS, and specify all the fields - Web API or service: make a Place Details request and specify all the fields (this type of request is the default if you do not specify any fields):
getPlaceDetails()
.
- Place Details (price starting at 0.017 USD per session)
- Basic Data (billed at 0.00 USD)
- Contact Data (price starting at 0.003 USD per request)
- Atmosphere Data (price starting at 0.005 USD per request)
- Mobile: call
SKU: Place Details – ID Refresh
Use the Place Details request to refresh stale place IDs . These types of requests are available at no charge.
MONTHLY VOLUME RANGE (Price per CALL) | ||
---|---|---|
| | |
0.00 USD | 0.00 USD | 0.00 USD |
مثال
Make a Place Details request specifying just the place id field: getPlaceDetails(fields: place_id)
. On your bill, you will see this SKU listed (when viewing your bill by SKU ):
- Place Details – ID Refresh (billed at 0.00 USD)
SKU: Find Place
Find Place is charged for a Find Place request.
MONTHLY VOLUME RANGE (Price per CALL) | ||
---|---|---|
| | |
0.017 USD per each (17.00 USD per 1000) | 0.0136 USD per each (13.60 USD per 1000) | Contact Sales for volume pricing |
Find Place requests also generate Data SKUs ( Basic , Contact , and/or Atmosphere ), depending on the fields that are specified in the request. Like Place Details requests, you can use the fields parameter in your Find Place request to limit the response to only those fields specified. You are billed for the Find Place request as well as the data requested. By default, if NO fields are requested, only the place id is returned, so no additional data charges are incurred.
نمونه ها
- You make a Find Place request and specify just the address field:
FindPlace(fields: formatted_address)
. On your bill, you will see these SKUs listed (when viewing your bill by SKU ):- Find Place (price starting at 0.017 USD per call)
- Basic Data (billed at 0.00 USD)
- You make a Find Place request and specify the phone number field:
FindPlace(fields: formatted_phone_number)
. On your bill, you will see these SKUs listed (when viewing your bill by SKU ):- Find Place (price starting at 0.017 USD per call)
- Contact Data (price starting at 0.003 USD per request)
- You make a Find Place request and specify fields from all three data-type buckets:
FindPlace(fields: formatted_address, opening_hours, price_level)
. On your bill, you will see these SKUs listed (when viewing your bill by SKU ):- Find Place (price starting at 0.017 USD per call)
- Basic Data (billed at 0.00 USD)
- Contact Data (price starting at 0.003 USD per request)
- Atmosphere Data (price starting at 0.005 USD per request)
SKU: Find Place – ID only
Find Place – ID only is charged for Find Place requests that only specify the Place ID to be returned. By default, if no fields are specified in the Find Place request, only the place id is returned.
MONTHLY VOLUME RANGE (Price per CALL) | ||
---|---|---|
| | |
0.00 USD | 0.00 USD | 0.00 USD |
مثال
You make a Find Place request and only specify the place_id
field: FindPlace(fields: place_id)
. On your bill, you will see this SKU listed (when viewing your bill by SKU ):
- Find Place – ID only (billed at 0.00 USD)
SKU: Find Current Place
Find Current Place is charged for calls to findCurrentPlace()
(Android) or findPlaceLikelihoodsFromCurrentLocationWithPlaceFields:
(iOS).
MONTHLY VOLUME RANGE (Price per CALL) | ||
---|---|---|
| | |
0.030 USD per each (30.00 USD per 1000) | 0.024 USD per each (24.00 USD per 1000) | Contact Sales for volume pricing |
Calls to findCurrentPlace()
(Android) or findPlaceLikelihoodsFromCurrentLocationWithPlaceFields:
(iOS) also generate Data SKUs ( Basic , Contact , and/or Atmosphere ), depending on the fields that are specified in the call. Specify data fields to limit the response to only those fields. You are billed for the Find Current Place call as well as the data requested.
نمونه ها
- You call
findCurrentPlace()
(Android) orfindPlaceLikelihoodsFromCurrentLocationWithPlaceFields:
(iOS) and specify just theADDRESS
field. On your bill, you will see these SKUs listed (when viewing your bill by SKU ):- Find Current Place (price starting at 0.030 USD per request)
- Basic Data (billed at 0.00 USD)
- You call
findCurrentPlace()
(Android) orfindPlaceLikelihoodsFromCurrentLocationWithPlaceFields:
(iOS) and specify thePHONE_NUMBER
field. On your bill, you will see these SKUs listed (when viewing your bill by SKU ):- Find Current Place (price starting at 0.030 USD per request)
- Contact Data (price starting at 0.003 USD per request)
- You call
findCurrentPlace()
(Android) orfindPlaceLikelihoodsFromCurrentLocationWithPlaceFields:
(iOS) and specify fields from all three data-type buckets. On your bill, you will see these SKUs listed (when viewing your bill by SKU ):- Find Current Place (price starting at 0.030 USD per request)
- Basic Data (billed at 0.00 USD)
- Contact Data (price starting at 0.003 USD per request)
- Atmosphere Data (price starting at 0.005 USD per request)
SKU: Place – Nearby Search
Place – Nearby Search is charged for requests to the Maps JavaScript API's Place Nearby Search service ( nearbySearch()
), or to the Places API Nearby Search service
MONTHLY VOLUME RANGE (Price per CALL) | ||
---|---|---|
| | |
0.032 USD per each (32.00 USD per 1000) | 0.0256 USD per each (25.60 USD per 1000) | Contact Sales for volume pricing |
Nearby Search requests return a list of places, but do not support specifying which fields are returned. Nearby Search requests return a subset of the supported data fields . You are charged for the Nearby Search request starting at 0.032 USD per each, as well as all of the data-type SKUs ( Basic Data , Contact Data , and Atmosphere Data ).
مثال
You make a Nearby Search request, such as NearbySearch (San Francisco, 100 meters)
. On your bill, you will see these SKUs listed (when viewing your bill by SKU ):
- Place - Nearby Search (price starting at 0.032 USD per call)
- Basic Data (billed at 0.00 USD)
- Contact Data (price starting at 0.003 USD per request)
- Atmosphere Data (price starting at 0.005 USD per request)
SKU: Place – Text Search
Place – Text Search is charged for requests to the Maps JavaScript API's Place Text Search service ( textSearch()
), or to the Places API Text Search service .
MONTHLY VOLUME RANGE (Price per CALL) | ||
---|---|---|
| | |
0.032 USD per each (32.00 USD per 1000) | 0.0256 USD per each (25.60 USD per 1000) | Contact Sales for volume pricing |
Text Search requests return a list of places, but do not support specifying which fields are returned. Text Search requests return a subset of the supported data fields . You are charged for the Text Search request starting at 0.032 USD per each, as well as all of the data-type SKUs ( Basic Data , Contact Data , and Atmosphere Data ).
The Place – Text Search SKU is also generated by the Maps JavaScript API's Place SearchBox widget : getPlaces()
method after the user selects a place query (icon: magnifier), not a result (icon: pin), as illustrated here:
مثال
You make a Text Search request, such as TextSearch(123 Main Street)
. On your bill, you will see these SKUs listed (when viewing your bill by SKU ):
- Place - Text Search (price starting at 0.032 USD per call)
- Basic Data (billed at 0.00 USD)
- Contact Data (price starting at 0.003 USD per request)
- Atmosphere Data (price starting at 0.005 USD per request)
SKU: Place Photo
A Place Photo SKU is charged for:
- Android: calls to
fetchPhoto()
- iOS: calls to
loadPlacePhoto:
- JavaScript: to Places Library, Maps JavaScript API's Place Photos service when requesting data from the URLs returned by
PlacePhoto.getUrl()
to load image pixel data - Web service: requests to the Places API Place Photos service
For the JavaScript service, invoking the PlacePhoto.getUrl()
method does not cause billing until the URL is actually used to obtain pixel data.
MONTHLY VOLUME RANGE (Price per CALL) | ||
---|---|---|
| | |
0.007 USD per each (7.00 USD per 1000) | 0.0056 USD per each (5.60 USD per 1000) | Contact Sales for volume pricing |
SKU: Geocoding
A Geocoding SKU is charged for requests to the Maps JavaScript API's Geocoding service or to the Geocoding API . In JavaScript , the method Geocoder.geocode()
initiates the request to the Geocoding Service.
MONTHLY VOLUME RANGE (Price per REQUEST) | ||
---|---|---|
| | |
0.005 USD per each (5.00 USD per 1000) | 0.004 USD per each (4.00 USD per 1000) | Contact Sales for volume pricing |
SKU: Geolocation
A Geolocation SKU is charged for requests to the Geolocation API .
MONTHLY VOLUME RANGE (Price per REQUEST) | ||
---|---|---|
| | |
0.005 USD per each (5.00 USD per 1000) | 0.004 USD per each (4.00 USD per 1000) | Contact Sales for volume pricing |
SKU: Map Tiles API: 2D Map Tiles
A request to Map Tiles API retrieving Roadmap , Satellite , or Terrain Tiles. Note that Session Token and Viewport information requests aren't billed.
MONTHLY VOLUME RANGE (Price per REQUEST) | |||||
---|---|---|---|---|---|
0 - 1,000,000 | 1,000,001 - 5,000,000 | 5,000,001+ | |||
0.0006 USD per each (0.60 USD per 1000) | 0.00048 USD per each (0.48 USD per 1000) | Contact Sales for volume pricing |
SKU: Map Tiles API: Street View Tiles
A request to Map Tiles API retrieving Street View Tiles, Street View Thumbnails, or Street View PanoIDs. Note that Session Token and Street View Metadata requests aren't billed.
MONTHLY VOLUME RANGE (Price per REQUEST) | |||||
---|---|---|---|---|---|
0 - 1,000,000 | 1,000,001 - 5,000,000 | 5,000,001+ | |||
0.002 USD per each (2.00 USD per 1000) | 0.0016 USD per each (1.60 USD per 1000) | Contact Sales for volume pricing |
SKU: Map Tiles API: Photorealistic 3D Tiles
A request to Map Tiles API retrieving 3D Root Tiles.
MONTHLY VOLUME RANGE (Price per REQUEST) | |||||
---|---|---|---|---|---|
| | | |||
0.006 USD per each (6.00 USD per 1000) | 0.0051 USD per each (5.10 USD per 1000) | Contact Sales for volume pricing |
SKU: Time Zone
A Time Zone SKU is charged for requests to the Time Zone API .
MONTHLY VOLUME RANGE (Price per REQUEST) | ||
---|---|---|
| | |
0.005 USD per each (5.00 USD per 1000) | 0.004 USD per each (4.00 USD per 1000) | Contact Sales for volume pricing |
SKU: Elevation
An Elevation SKU is charged for requests to the Maps JavaScript API ’s Elevation service or to the Elevation API .
MONTHLY VOLUME RANGE (Price per REQUEST) | ||
---|---|---|
| | |
0.005 USD per each (5.00 USD per 1000) | 0.004 USD per each (4.00 USD per 1000) | Contact Sales for volume pricing |
SKU: Address Validation
A request to the validateAddress method (REST) and ValidateAddress method (gRPC) of the Address Validation API .
MONTHLY VOLUME RANGE (Price per REQUEST) | ||
---|---|---|
| | |
0.017 USD per each (17.00 USD per 1000) | 0.0136 USD per each (13.60 USD per 1000) | Contact Sales for volume pricing |
SKU: Address Validation Preferred
Address Validation Preferred works with the Autocomplete (New) endpoint of the Places API when you use it with sessions that terminate with a call to the Address Validation API. Specifically, sessions that use Autocomplete (New) and terminate in either a request to validateAddress (REST) or ValidateAddress (gRPC) fall under this pricing model.
For details about both pricing and using Autocomplete (New) sessions with Places API, see the following guides in the Places API documentation:
When using Address Validation Preferred at the end of an Autocomplete (New) session, you are billed as follows:
MONTHLY VOLUME RANGE (Price per REQUEST) | ||
---|---|---|
| | |
0.025 USD per each (25.00 USD per 1000) | 0.020 USD per each (20.00 USD per 1000) | Contact Sales for volume pricing |
Environment product SKUs
APIs in Environment include: Air Quality API , Pollen API , and Solar API .
SKU: Air Quality
This SKU applies for the following endpoints and methods:
MONTHLY VOLUME RANGE (Price per REQUEST) | |||||
---|---|---|---|---|---|
| | | |||
0.005 USD per each (5.00 USD per 1000) | 0.004 USD per each (4.00 USD per 1000) | Contact Sales for volume pricing |
SKU: Pollen
This SKU applies for the following endpoints/methods:
MONTHLY VOLUME RANGE (Price per REQUEST) | |||||
---|---|---|---|---|---|
| | | |||
0.01 USD per each (10.00 USD per 1000) | 0.008 USD per each (8.00 USD per 1000) | Contact Sales for volume pricing |
SKU: Solar Building Insights
A request to buildingInsights .
MONTHLY VOLUME RANGE (Price per REQUEST) | |||||
---|---|---|---|---|---|
| | | |||
0.01 USD per each (10.00 USD per 1000) | 0.005 USD per each (5.00 USD per 1000) | Contact Sales for volume pricing |
SKU: Solar Data Layers
A request to dataLayers .
Accessing multiple imagery URLs from the same request does not generate additional charged queries. MONTHLY VOLUME RANGE (Price per REQUEST) | |||||
---|---|---|---|---|---|
| | | |||
0.075 USD per each (75.00 USD per 1000) | 0.0375 USD per each (37.50 USD per 1000) | Contact Sales for volume pricing |
Navigation SKU
Navigation SDKs include: Navigation SDK for Android and Navigation SDK for iOS .
SKU: Navigation Request
Each destination requested using the Navigation SDK is billed as a Navigation Request SKU unit. The price per SKU unit is determined by your total monthly call volume for the SKU:
MONTHLY VOLUME RANGE (Price per destination) | ||
---|---|---|
1–1,000 | 1,001–4,200,000 | 4,200,000+ |
بدون هزینه | 0.05 USD | 0.0395 USD |
Route request methods
Route generation requests to the Navigation SDK can be made by calling the following methods:
اندروید
- setDestination (Waypoint destination)
- setDestination (Waypoint destination, RoutingOptions options)
- setDestination (Waypoint destination, RoutingOptions routingOptions, DisplayOptions displayOptions)
- setDestinations (List<Waypoint> destinations)
- setDestinations (List<Waypoint> destinations, RoutingOptions options)
- setDestinations (List<Waypoint> destinations, CustomRoutesOptions customRoutesOptions)
- setDestinations (List<Waypoint> destinations, RoutingOptions routingOptions, DisplayOptions displayOptions)
- setDestinations (List<Waypoint> destinations, CustomRoutesOptions customRoutesOptions, DisplayOptions displayOptions)
- simulateLocationsAlongNewRoute(List<Waypoint> waypoints)
- simulateLocationsAlongNewRoute(List<Waypoint> waypoints, RoutingOptions routingOptions)
- simulateLocationsAlongNewRoute(List<Waypoint> waypoints, RoutingOptions routingOptions, SimulationOptions simulationOptions)
- [Deprecated] setDestinations (List<Waypoint> destinations, String routeToken)
iOS
Keep in mind that a single method call can contain up to 25 destinations, and the cost for each call is calculated by multiplying the number of destinations by the price per SKU unit .
،This section lists the SKUs defined for the core Google Maps Platform products. The core products are pay as you go and you only pay for the SKUs you use.
For each SKU listed you'll see:
- The SKU name as it appears on your billing report.
- Details describing the type of use that triggers the SKU (billable events).
- The price per each use for the volume-based tiers.
- Any additional SKU-specific pricing notes.
Look up individual product SKUs here, or use our Pricing and Usage calculator to estimate your usage versus total cost per API.
GMP Product / SKU table
Maps product SKUs
APIs in Maps include: Maps SDK for Android ; Maps SDK for iOS ; Maps JavaScript API ; Maps Static API ; Street View Static API ; and Maps Embed API .
SKU: Mobile Native Static Maps
Includes a Google map object in lite mode, not loaded with a map ID, in an Maps SDK for Android mobile application.
MONTHLY VOLUME RANGE (Price per MAP LOAD) | ||
---|---|---|
| | |
0.00 USD | 0.00 USD | 0.00 USD |
A single map load is accrued for each instantiation of a Google map object in lite mode, in a Maps SDK for Android mobile application. Maps are created with instances of MapFragment
, SupportMapFragment
, or MapView
classes. A map load is counted each time the related onCreate()
method is called.
SKU: Mobile Native Dynamic Maps
A Google map object, not loaded with a map ID, in a Maps SDK for Android or Maps SDK for iOS mobile application.
MONTHLY VOLUME RANGE (Price per MAP LOAD) | ||
---|---|---|
| | |
0.00 USD | 0.00 USD | 0.00 USD |
A single map load is accrued for each instantiation of a Google map object in a Maps SDK for Android or Maps SDK for iOS mobile application:
- One of
MapFragment
,SupportMapFragment
, orMapView
classes on Android. A map load is counted each time the relatedonCreate()
method is called. - A
GMSMapView
object on iOS.
User interactions with the map, such as panning, zooming, or switching map layers, do not generate additional map loads. With the pay-as-you-go pricing model, the creation of a Street View panorama is no longer charged as a Mobile Native map load. It is charged as a Dynamic Street View .
SKU: Embed and SKU: Embed Advanced
همه درخواستهای Maps Embed API بدون هزینه و با استفاده نامحدود در دسترس هستند.
SKU: Static Maps
A request to the Maps Static API .
MONTHLY VOLUME RANGE (Price per MAP LOAD) | ||
---|---|---|
| | |
0.002 USD per each (2.00 USD per 1000) | 0.0016 USD per each (1.60 USD per 1000) | Contact Sales for volume pricing |
SKU: Dynamic Maps
An application that displays either a map loaded with or without a map ID using Maps JavaScript API , or a map loaded with a map ID and using either the Maps SDK for Android or Maps SDK for iOS .
MONTHLY VOLUME RANGE (Price per MAP LOAD) | ||
---|---|---|
| | |
0.007 USD per each (7.00 USD per 1000) | 0.0056 USD per each (5.60 USD per 1000) | Contact Sales for volume pricing |
User interactions with the map, such as panning, zooming, or switching map layers, do not generate additional map loads.
SKU: Static Street View
Street View panoramas and map loads are now charged separately. A static Street View panorama is charged for each request to the Street View Static API to embed a static (non-interactive) Street View panorama. Usage of the Street View Image Metadata endpoint is not charged.
MONTHLY VOLUME RANGE (Price per PANORAMA) | ||
---|---|---|
| | |
0.007 USD per each (7.00 USD per 1000) | 0.0056 USD per each (5.60 USD per 1000) | Contact Sales for volume pricing |
SKU: Dynamic Street View
Street View panoramas and map loads are now charged separately. A dynamic Street View panorama is charged for each instantiation of a panorama object in a Maps JavaScript API , Maps SDK for Android , Maps SDK for iOS application.
MONTHLY VOLUME RANGE (Price per PANORAMA) | ||
---|---|---|
| | |
0.014 USD per each (14.00 USD per 1000) | 0.0112 USD per each (11.20 USD per 1000) | Contact Sales for volume pricing |
An instantiation of a panorama object occurs:
- In JavaScript , with the
google.maps.StreetViewPanorama()
class orMap.getStreetView()
method. Neither the built-in Street View experience based on the Street View Pegman control nor usage of theStreetViewService()
class is charged. - On Android , with one of
StreetViewPanoramaFragment
,SupportStreetViewPanoramaFragment
, orStreetViewPanoramaView
classes. A panorama is counted each time the relatedonCreate()
method is called. - On iOS , with the
GMSPanoramaView
object.
SKU: Aerial View
A request to the Aerial View API that returns an aerial video URL.
MONTHLY VOLUME RANGE (Price per successful lookupVideo request) | ||
---|---|---|
| | |
0.016 USD per each (16.00 USD per 1000) | 0.0128 USD per each (12.80 USD per 1000) | Contact Sales for volume pricing |
Only calls to lookupVideo
that return URLs are billed. A single, successful lookupVideo
response may return multiple URLs, each for a different resolution or orientation, but only constitutes a single billable event. Note that pricing does not depend on actual views of those URLs by end users.
Routes product SKUs
APIs in Routes include: Directions API ; Distance Matrix API ; and Roads API .
SKU: Directions
A request to the Maps JavaScript API's Directions Service (excludes requests triggering the Directions Advanced billing SKU) or the Directions API .
MONTHLY VOLUME RANGE (Price per QUERY) | ||
---|---|---|
| | |
0.005 USD per each (5.00 USD per 1000) | 0.004 USD per each (4.00 USD per 1000) | Contact Sales for volume pricing |
SKU: Directions Advanced
A request to the Maps JavaScript API's Directions Service or the Directions API that uses traffic information, more than 10 waypoints, waypoints optimization, and/or location modifiers.
MONTHLY VOLUME RANGE (Price per QUERY) | ||
---|---|---|
| | |
0.01 USD per each (10.00 USD per 1000) | 0.008 USD per each (8.00 USD per 1000) | Contact Sales for volume pricing |
A Directions Advanced SKU is charged for a Maps JavaScript API's Directions Service or a Directions API request that uses one or more of the following:
- Traffic information. Traffic information is used when all the following apply (these are the conditions required to receive the
duration_in_traffic
field in the Directions response):- The travel
mode
parameter isdriving
, or is not specified (driving
is the default travel mode). - The request includes a valid
departure_time
parameter . Thedeparture_time
can be set to the current time or some time in the future. It cannot be in the past. - The request does not include stopover waypoints . If the request includes waypoints, prefix each waypoint with
via:
to influence the route but avoid stopovers. به عنوان مثال،&waypoints=via:San Francisco|via:Mountain View|...
- The travel
- More than 10 waypoints (between 11 and 25).
- Waypoints optimization. The
optimize
parameter is set totrue
for waypoints. به عنوان مثال،&waypoints=optimize:true|San Francisco|Mountain View|...
- Location modifiers. When you use the following location modifiers to indicate how drivers should approach a particular location:
-
side_of_road
-
heading
-
SKU: Distance Matrix
A request to the Distance Matrix API or the Maps JavaScript API's Distance Matrix Service (excludes requests triggering the Distance Matrix Advanced billing SKU billing SKU).
MONTHLY VOLUME RANGE (Price per ELEMENT) | ||
---|---|---|
| | |
0.005 USD per each (5.00 USD per 1000) | 0.004 USD per each (4.00 USD per 1000) | Contact Sales for volume pricing |
Each query sent to the Distance Matrix API generates elements, where the number of origins
times the number of destinations
equals the number of elements.
SKU: Distance Matrix Advanced
A request to the Distance Matrix API or the Maps JavaScript API's Distance Matrix Service that uses traffic information and/or location modifiers.
MONTHLY VOLUME RANGE (Price per ELEMENT) | ||
---|---|---|
| | |
0.01 USD per each (10.00 USD per 1000) | 0.008 USD per each (8.00 USD per 1000) | Contact Sales for volume pricing |
Each query sent to the Distance Matrix API generates elements, where the number of origins
times the number of destinations
equals the number of elements.
A Distance Matrix Advanced SKU is charged for a Distance Matrix API or a Maps JavaScript API's Distance Matrix Service that uses one or more of the following:
- Traffic information. Traffic information is used when all the following apply (these are the conditions required to receive the
duration_in_traffic
field in the Distance Matrix response):- The travel
mode
parameter isdriving
, or is not specified (driving
is the default travel mode). - The request includes a valid
departure_time
parameter . Thedeparture_time
can be set to the current time or some time in the future. It cannot be in the past.
- The travel
- Location modifiers. When you use the following location modifiers to indicate how drivers should approach a particular location:
-
side_of_road
-
heading
-
SKU: Roads – Route Traveled
A request to the Roads API's Snap to Roads service .
MONTHLY VOLUME RANGE (Price per QUERY) | ||
---|---|---|
| | |
0.01 USD per each (10.00 USD per 1000) | 0.008 USD per each (8.00 USD per 1000) | Contact Sales for volume pricing |
SKU: Roads – Nearest Road
A request to the Roads API's Nearest Roads service .
MONTHLY VOLUME RANGE (Price per QUERY) | ||
---|---|---|
| | |
0.01 USD per each (10.00 USD per 1000) | 0.008 USD per each (8.00 USD per 1000) | Contact Sales for volume pricing |
SKU: Roads – Speed Limits
A request to the Roads API's Speed Limits service . MONTHLY VOLUME RANGE (Price per ELEMENT) | ||
---|---|---|
| | |
0.02 USD per each (20.00 USD per 1000) | 0.016 USD per each (16.00 USD per 1000) | Contact Sales for volume pricing |
Speed Limit requests are billed per speed limit element returned in the API response. This amount will always be equal to or less than the number of points passed in the original request.
SKU: Routes: Compute Routes - Basic
A request to Compute Routes .
MONTHLY VOLUME RANGE Price per QUERY | ||
---|---|---|
| | |
0.005 USD per each (5.00 USD per 1000) | 0.004 USD per each (4.00 USD per 1000) | Contact Sales for volume pricing |
SKU: Routes: Compute Routes - Advanced
A request to Compute Routes that uses advanced features.
MONTHLY VOLUME RANGE Price per QUERY | ||
---|---|---|
| | |
0.01 USD per each (10.00 USD per 1000) | 0.008 USD per each (8.00 USD per 1000) | Contact Sales for volume pricing |
The Advanced SKU is charged for a Compute Routes request that uses one or more of the following features:
- Between 11 and 25 intermediate waypoints
- Traffic aware or traffic aware optimal routing. These routing options correspond to setting the
routingPreference
property in the request toTRAFFIC_AWARE
orTRAFFIC_AWARE_OPTIMAL
. - Location modifiers. When you use the following options to indicate how drivers should approach a particular location:
SKU: Routes: Compute Routes - Preferred
A request to Compute Routes that uses preferred features.
MONTHLY VOLUME RANGE Price per QUERY | ||
---|---|---|
| | |
0.015 USD per each (15.00 USD per 1000) | 0.012 USD per each (12.00 USD per 1000) | Contact Sales for volume pricing |
The Preferred SKU is charged for a Compute Routes request that uses one or more of the following features:
SKU: Routes: Compute Route Matrix - Basic
A request to Compute Route Matrix .
MONTHLY VOLUME RANGE Price per ELEMENT | ||
---|---|---|
| | |
0.005 USD per each (5.00 USD per 1000) | 0.004 USD per each (4.00 USD per 1000) | Contact Sales for volume pricing |
SKU: Routes: Compute Route Matrix - Advanced
A request to Compute Route Matrix that uses advanced features.
MONTHLY VOLUME RANGE Price per ELEMENT | ||
---|---|---|
| | |
0.01 USD per each (10.00 USD per 1000) | 0.008 USD per each (8.00 USD per 1000) | Contact Sales for volume pricing |
The Advanced SKU is charged for a Compute Route Matrix request that uses one or more of the following features:
- Traffic aware or traffic aware optimal routing. These routing options correspond to setting the
routingPreference
property in the request toTRAFFIC_AWARE
orTRAFFIC_AWARE_OPTIMAL
. - Location modifiers. When you use the following options to indicate how drivers should approach a particular location:
SKU: Routes: Compute Route Matrix - Preferred
A request to Compute Route Matrix that uses preferred features.
MONTHLY VOLUME RANGE Price per ELEMENT | ||
---|---|---|
| | |
0.015 USD per each (15.00 USD per 1000) | 0.012 USD per each (12.00 USD per 1000) | Contact Sales for volume pricing |
The Preferred SKU is charged for a Compute Route Matrix request that uses one or more of the following features:
SKU: Route Optimization: Single Vehicle Routing
A request to the Route Optimization API that specifies exactly one vehicle.
MONTHLY VOLUME RANGE (Price per SHIPMENT) | ||
---|---|---|
| | |
0.01 USD per each (10.00 USD per 1000) | 0.004 USD per each (4.00 USD per 1000) | Contact Sales for volume pricing |
SKU: Route Optimization: Fleet Routing
A request to the Route Optimization API that specifies more than one vehicle.
MONTHLY VOLUME RANGE (Price per SHIPMENT) | ||
---|---|---|
| | |
0.03 USD per each (30.00 USD per 1000) | 0.014 USD per each (14.00 USD per 1000) | Contact Sales for volume pricing |
Places (New) product SKUs
About field masks
Use field masks, also called field lists , in your requests to specify the list of fields to return in the response. You are then billed at the highest SKU applicable to your request. That means if you select fields in both the (Basic) SKU and the (Advanced) SKU, you are billed based on the (Advanced) SKU.
Using a field mask is a good design practice to ensure that you don't request unnecessary data, which helps to avoid unnecessary processing time and billing charges.
About Autocomplete (New) sessions
An Autocomplete (New) session includes one or more Autocomplete (New) requests, and a Place Details (New) request or Address Validation request. The same session token is passed to the Autocomplete (New) request and to the subsequent Place Details (New) request or Address Validation request.
A session starts with the first Autocomplete (New) request. A Place Details (New) request or Address Validation request is then made when the user has selected one of the Autocomplete (New) suggestions. If a session is abandoned, meaning no Place Details (New) request or Address Validation request is made, Autocomplete (New) requests are charged as if no session token was provided.
After a user has selected a place (meaning a Place Details (New) request or Address Validation request is made), you must start a new session using a new session token.
A session token is good for one session and cannot be used for more than one session. If you reuse a session token, the session is considered invalid and the requests are charged as if no session token was provided.
SKU: Autocomplete Requests
An Autocomplete Requests SKU is charged for each request to the Autocomplete (New) API that does not include a session token.
It is also charged if you use session tokens and either:
- Terminate the sessions by a single request to Place Details (New) that requests any fields defined by the SKU: Place Details (Location Only) .
- Each Autocomplete (New) request, up to 12 requests, is billed using the SKU: Autocomplete Requests .
- Each subsequent Autocomplete (New) request is billed using the SKU: Autocomplete Session Usage .
- Abandon the session or end the session by making a call to the SKU: Place Details (IDs Only) . All Autocomplete (New) requests are then billed using the SKU: Autocomplete Requests .
MONTHLY VOLUME RANGE (Price per CALL) | ||
---|---|---|
| | |
0.00283 USD per each (2.83 USD per 1000) | 0.00227 USD per each (2.27 USD per 1000) | Contact Sales for volume pricing |
SKU: Autocomplete Session Usage
An Autocomplete Session Usage SKU is charged for each request to the Autocomplete (New) API that includes a session token.
This SKU is charged in these scenarios:
Autocomplete session terminated by a call to SKU: Place Details (Location Only) :
- Each Autocomplete (New) request, up to 12 requests, is billed using the SKU: Autocomplete Requests .
- Each subsequent Autocomplete (New) request is billed using the SKU: Autocomplete Session Usage .
Autocomplete session terminated with a call to SKU: Place Details (Basic, Advanced, or Preferred) .
A Place Details call that requests any field from the SKU: Place Details (Basic, Advanced, or Preferred) is billed at the SKU: Place Details (Preferred) .
Autocomplete session terminated with a call to SKU: Address Validation Preferred .
For more information, see Autocomplete (New) and session pricing .
MONTHLY VOLUME RANGE (Price per CALL) | ||
---|---|---|
| | |
0.00 USD per each (0.00 USD per 1000) | 0.00 USD per each (0.00 USD per 1000) | 0.00 USD per each (0.00 USD per 1000) |
SKU: Place Details (IDs Only)
Using a field mask or field list in your Place Details (New) request, you can limit the response to only those fields specified. This SKU is triggered when you only request the following fields:
Android : Place.Field.DISPLAY_NAME
, Place.Field.ID
, Place.Field.PHOTO_METADATAS
, Place.Field.RESOURCE_NAME
Places Library, Maps JavaScript API : id
, photos
iOS : GMSPlacePropertyPlaceID
, GMSPlacePropertyName
, GMSPlacePropertyPhotos
Web service : attributions
, id
, name
* , photos
* The name
field contains the place resource name in the form: places/ PLACE_ID
. Use displayName
to access the text name of the place.
MONTHLY VOLUME RANGE (Price per CALL) | ||
---|---|---|
| | |
0.0 USD per each (0.00 USD per 1000) | 0.0 USD per each (0.00 USD per 1000) | 0.0 USD per each (0.00 USD per 1000) |
SKU: Place Details (Location Only)
Using a field mask or field list in your Place Details (New) request, you can limit the response to only those fields specified. This SKU is triggered when you only request the following fields:
Android : Place.Field.ADDRESS_COMPONENTS
, ADR_FORMAT_ADDRESS
, Place.Field.FORMATTED_ADDRESS
, Place.Field.LOCATION
, Place.Field.PLUS_CODE
, Place.Field.SHORT_FORMATTED_ADDRESS
, Place.Field.TYPES
, Place.Field.VIEWPORT
Places Library, Maps JavaScript API : addressComponents
, adrFormatAddress
, formattedAddress
, location
, plusCode
, types
, viewport
iOS : GMSPlacePropertyAddressComponents
, GMSPlacePropertyFormattedAddress
, GMSPlacePropertyCoordinate
, GMSPlacePropertyPlusCode
, GMSPlacePropertyTypes
, GMSPlacePropertyViewport
Web service : addressComponents
, adrFormatAddress
, formattedAddress
, location
, plusCode
, shortFormattedAddress
, types
, viewport
MONTHLY VOLUME RANGE (Price per CALL) | ||
---|---|---|
| | |
0.005 USD per each (5.00 USD per 1000) | 0.004 USD per each (4.00 USD per 1000) | Contact Sales for volume pricing |
SKU: Place Details (Basic)
Using a field mask or field list in your Place Details (New) request, you can limit the response to only those fields specified. This SKU is triggered when you only request the following fields:
Android : Place.Field.ACCESSIBILITY_OPTIONS
, Place.Field.BUSINESS_STATUS
, Place.Field.GOOGLE_MAPS_URI
, Place.Field.ICON_BACKGROUND_COLOR
, Place.Field.ICON_MASK_URL
, Place.Field.PRIMARY_TYPE_DISPLAY_NAME
, Place.Field.SUB_DESTINATIONS
, Place.Field.UTC_OFFSET
Places Library, Maps JavaScript API : accessibilityOptions
, businessStatus
, displayName
, googleMapsUri
, iconBackgroundColor
, primaryTypeDisplayName
, svgIconMaskURI
, types
, utcOffsetMinutes
iOS : GMSPlacePropertyBusinessStatus
, GMSPlacePropertyIconBackgroundColor
, GMSPlacePropertyIconImageURL
, GMSPlacePropertyUTCOffsetMinutes
, GMSPlacePropertyWheelchairAccessibleEntrance
Web service : accessibilityOptions
, businessStatus
, displayName
, googleMapsUri
, iconBackgroundColor
, iconMaskBaseUri
, primaryType
, primaryTypeDisplayName
, subDestinations
, utcOffsetMinutes
If an Autocomplete session is terminated by a Place Details call that requests any field from the SKU: Place Details (Basic, Advanced, or Preferred) , then the call is billed at SKU: Place Details (Preferred) . For more information, see SKU: Autocomplete Session Usage .
MONTHLY VOLUME RANGE (Price per CALL) | ||
---|---|---|
| | |
0.0170 USD per each (17.00 USD per 1000) | 0.0136 USD per each (13.60 USD per 1000) | Contact Sales for volume pricing |
SKU: Place Details (Advanced)
Using a field mask or field list in your Place Details (New) request, you can limit the response to only those fields specified. This SKU is triggered when you only request the following fields:
Android : Place.Field.CURRENT_OPENING_HOURS
, Place.Field.CURRENT_SECONDARY_OPENING_HOURS
Place.Field.INTERNATIONAL_PHONE_NUMBER
, Place.Field.NATIONAL_PHONE_NUMBER
Place.Field.OPENING_HOURS
, Place.Field.PRICE_LEVEL
, Place.Field.RATING
, Place.Field.SECONDARY_OPENING_HOURS
, Place.Field.USER_RATING_COUNT
Place.Field.WEBSITE_URI
Places Library, Maps JavaScript API : internationalPhoneNumber
, nationalPhoneNumber
, priceLevel
, rating
, regularOpeningHours
, userRatingCount
, websiteUri
iOS : GMSPlacePropertyCurrentOpeningHours
, GMSPlacePropertySecondaryOpeningHours
, GMSPlacePropertyPhoneNumber
, GMSPlacePropertyPriceLevel
, GMSPlacePropertyRating
, GMSPlacePropertyOpeningHours
, GMSPlacePropertyUserRatingsTotal
, GMSPlacePropertyWebsite
Web service : currentOpeningHours
, currentSecondaryOpeningHours
, internationalPhoneNumber
, nationalPhoneNumber
, priceLevel
, rating
, regularOpeningHours
, regularSecondaryOpeningHours
, userRatingCount
, websiteUri
If an Autocomplete session is terminated by a Place Details call that requests any field from the SKU: Place Details (Basic, Advanced, or Preferred) , then the call is billed at SKU: Place Details (Preferred) . For more information, see SKU: Autocomplete Session Usage .
MONTHLY VOLUME RANGE (Price per CALL) | ||
---|---|---|
| | |
0.020 USD per each (20.00 USD per 1000) | 0.016 USD per each (16.00 USD per 1000) | Contact Sales for volume pricing |
SKU: Place Details (Preferred)
Using a field mask or field list in your Place Details (New) request, you can limit the response to only those fields specified. This SKU is triggered when you only request the following fields:
Android : Place.Field.ALLOWS_DOGS
, Place.Field.CURBSIDE_PICKUP
, Place.Field.DELIVERY
, Place.Field.DINE_IN
, Place.Field.EDITORIAL_SUMMARY
, Place.Field.EV_CHARGE_OPTIONS
, Place.Field.FUEL_OPTIONS
, Place.Field.GOOD_FOR_CHILDREN
, Place.Field.GOOD_FOR_GROUPS
, Place.Field.GOOD_FOR_WATCHING_SPORTS
, Place.Field.LIVE_MUSIC
, Place.Field.MENU_FOR_CHILDREN
, Place.Field.OUTDOOR_SEATING
, Place.Field.PARKING_OPTIONS
, Place.Field.PAYMENT_OPTIONS
, Place.Field.RESERVABLE
, Place.Field.RESTROOM
, Place.Field.REVIEWS
, Place.Field.SERVES_BEER
, Place.Field.SERVES_BREAKFAST
, Place.Field.SERVES_BRUNCH
, Place.Field.SERVES_COCKTAILS
, Place.Field.SERVES_COFFEE
, Place.Field.SERVES_DESSERT
, Place.Field.SERVES_DINNER
, Place.Field.SERVES_LUNCH
, Place.Field.SERVES_VEGETARIAN_FOOD
, Place.Field.SERVES_WINE
, Place.Field.TAKEOUT
Places Library, Maps JavaScript API : allowsDogs
, editorialSummary
, evChargeOptions
, fuelOptions
, hasCurbsidePickup
, hasDelivery
, hasDineIn
, hasLiveMusic
, hasMenuForChildren
, hasOutdoorSeating
, hasRestroom
, hasTakeout
, hasWifi
, isGoodForChildren
, isGoodForGroups
, isGoodForWatchingSports
, isReservable
, parkingOptions
, paymentOptions
, priceLevel
, reviews
, servesBeer
, servesBreakfast
, servesBrunch
, servesCocktails
, servesCoffee
, servesDessert
, servesDinner
, servesLunch
, servesVegetarianFood
, servesWine
iOS : GMSPlacePropertyCurbsidePickup
, GMSPlacePropertyDelivery
, GMSPlacePropertyDineIn
, GMSPlacePropertyEditorialSummary
, GMSPlacePropertyReservable
, GMSPlacePropertyReviews
, GMSPlacePropertyServesBeer
, GMSPlacePropertyServesBreakfast
, GMSPlacePropertyServesBrunch
, GMSPlacePropertyServesDinner
, GMSPlacePropertyServesLunch
, GMSPlacePropertyServesVegetarianFood
, GMSPlacePropertyServesWine
, GMSPlacePropertyTakeout
Web service : allowsDogs
, curbsidePickup
, delivery
, dineIn
, editorialSummary
, evChargeOptions
, fuelOptions
, goodForChildren
, goodForGroups
, goodForWatchingSports
, liveMusic
, menuForChildren
, parkingOptions
, paymentOptions
, outdoorSeating
, reservable
, restroom
, reviews
, routingSummaries
, * servesBeer
, servesBreakfast
, servesBrunch
, servesCocktails
, servesCoffee
, servesDessert
, servesDinner
, servesLunch
, servesVegetarianFood
, servesWine
, takeout
* Text Search and Nearby Search only
If an Autocomplete session is terminated by a Place Details call that requests any field from the SKU: Place Details (Basic, Advanced, or Preferred) , then the call is billed at SKU: Place Details (Preferred) . For more information, see SKU: Autocomplete Session Usage .
MONTHLY VOLUME RANGE (Price per CALL) | ||
---|---|---|
| | |
0.025 USD per each (25.00 USD per 1000) | 0.020 USD per each (20.00 USD per 1000) | Contact Sales for volume pricing |
SKU: Nearby Search (Basic)
Using a field mask or field list in your Nearby Search (New) request, you can limit the response to only those fields specified. This SKU is triggered when you only request the following fields:
Android : Place.Field.ADDRESS_COMPONENTS
, Place.Field.BUSINESS_STATUS
, Place.Field.ADDRESS
, Place.Field.ICON_BACKGROUND_COLOR
, Place.Field.ICON_URL
, Place.Field.LAT_LNG
, Place.Field.PHOTO_METADATAS
, Place.Field.PLUS_CODE
, Place.Field.ID
, Place.Field.NAME
, Place.Field.TYPES
, Place.Field.UTC_OFFSET
, Place.Field.VIEWPORT
, Place.Field.WHEELCHAIR_ACCESSIBLE_ENTRANCE
Places Library, Maps JavaScript API : accessibilityOptions
, addressComponents
, adrFormatAddress
, businessStatus
, displayName
, formattedAddress
, googleMapsUri
, iconBackgroundColor
, id
, location
, photos
, plusCode
, svgIconMaskURI
, types
, utcOffsetMinutes
, viewport
iOS : GMSPlacePropertyAddressComponents
, GMSPlacePropertyBusinessStatus
, GMSPlacePropertyCoordinate
, GMSPlacePropertyFormattedAddress
, GMSPlacePropertyName
, GMSPlacePropertyIconBackgroundColor
, GMSPlacePropertyIconImageURL
, GMSPlacePropertyPhotos
, GMSPlacePropertyPlaceID
, GMSPlacePropertyPlusCode
, GMSPlacePropertyTypes
, GMSPlacePropertyUTCOffsetMinutes
, GMSPlacePropertyViewport
, GMSPlacePropertyWheelchairAccessibleEntrance
Web service : places.accessibilityOptions
, 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
, places.primaryType
, places.primaryTypeDisplayName
, places.shortFormattedAddress
, places.subDestinations
, places.types
, places.utcOffsetMinutes
, places.viewport
* The places.name
field contains the place resource name in the form: places/ PLACE_ID
. Use places.displayName
to access the text name of the place.
MONTHLY VOLUME RANGE (Price per CALL) | ||
---|---|---|
| | |
0.032 USD per each (32.00 USD per 1000) | 0.0256 USD per each (25.60 USD per 1000) | Contact Sales for volume pricing |
SKU: Nearby Search (Advanced)
Using a field mask or field list in your Nearby Search (New) request, you can limit the response to only those fields specified. This SKU is triggered when you only request the following fields:
Android : Place.Field.CURRENT_OPENING_HOURS
, Place.Field.CURRENT_SECONDARY_OPENING_HOURS
Place.Field.INTERNATIONAL_PHONE_NUMBER
, Place.Field.NATIONAL_PHONE_NUMBER
Place.Field.OPENING_HOURS
, Place.Field.PRICE_LEVEL
, Place.Field.RATING
, Place.Field.SECONDARY_OPENING_HOURS
, Place.Field.USER_RATING_COUNT
Place.Field.WEBSITE_URI
Places Library, Maps JavaScript API : internationalPhoneNumber
, nationalPhoneNumber
, priceLevel
, rating
, regularOpeningHours
, userRatingCount
, websiteUri
iOS : GMSPlacePropertyCurrentOpeningHours
, GMSPlacePropertySecondaryOpeningHours
, GMSPlacePropertyPhoneNumber
, GMSPlacePropertyPriceLevel
, GMSPlacePropertyRating
, GMSPlacePropertyOpeningHours
, GMSPlacePropertyUserRatingsTotal
, GMSPlacePropertyWebsite
Web service : places.currentOpeningHours
, places.currentSecondaryOpeningHours
, places.internationalPhoneNumber
, places.nationalPhoneNumber
, places.priceLevel
, places.rating
, places.regularOpeningHours
, places.regularSecondaryOpeningHours
, places.userRatingCount
, places.websiteUri
MONTHLY VOLUME RANGE (Price per CALL) | ||
---|---|---|
| | |
0.035 USD per each (35.00 USD per 1000) | 0.028 USD per each (28.00 USD per 1000) | Contact Sales for volume pricing |
SKU: Nearby Search (Preferred)
Using a field mask or field list in your Nearby Search (New) request, you can limit the response to only those fields specified. This SKU is triggered when you only request the following fields:
Android : Place.Field.ALLOWS_DOGS
, Place.Field.CURBSIDE_PICKUP
, Place.Field.DELIVERY
, Place.Field.DINE_IN
, Place.Field.EDITORIAL_SUMMARY
, Place.Field.EV_CHARGE_OPTIONS
, Place.Field.FUEL_OPTIONS
, Place.Field.GOOD_FOR_CHILDREN
, Place.Field.GOOD_FOR_GROUPS
, Place.Field.GOOD_FOR_WATCHING_SPORTS
, Place.Field.LIVE_MUSIC
, Place.Field.MENU_FOR_CHILDREN
, Place.Field.OUTDOOR_SEATING
, Place.Field.PARKING_OPTIONS
, Place.Field.PAYMENT_OPTIONS
, Place.Field.RESERVABLE
, Place.Field.RESTROOM
, Place.Field.REVIEWS
, Place.Field.SERVES_BEER
, Place.Field.SERVES_BREAKFAST
, Place.Field.SERVES_BRUNCH
, Place.Field.SERVES_COCKTAILS
, Place.Field.SERVES_COFFEE
, Place.Field.SERVES_DESSERT
, Place.Field.SERVES_DINNER
, Place.Field.SERVES_LUNCH
, Place.Field.SERVES_VEGETARIAN_FOOD
, Place.Field.SERVES_WINE
, Place.Field.TAKEOUT
Places Library, Maps JavaScript API : allowsDogs
, editorialSummary
, evChargeOptions
, fuelOptions
, hasCurbsidePickup
, hasDelivery
, hasDineIn
, hasLiveMusic
, hasMenuForChildren
, hasOutdoorSeating
, hasRestroom
, hasTakeout
, hasWifi
, isGoodForChildren
, isGoodForGroups
, isGoodForWatchingSports
, isReservable
, parkingOptions
, paymentOptions
, priceLevel
, reviews
, servesBeer
, servesBreakfast
, servesBrunch
, servesCocktails
, servesCoffee
, servesDessert
, servesDinner
, servesLunch
, servesVegetarianFood
, servesWine
iOS : GMSPlacePropertyCurbsidePickup
, GMSPlacePropertyDelivery
, GMSPlacePropertyDineIn
, GMSPlacePropertyEditorialSummary
, GMSPlacePropertyReservable
, GMSPlacePropertyReviews
, GMSPlacePropertyServesBeer
, GMSPlacePropertyServesBreakfast
, GMSPlacePropertyServesBrunch
, GMSPlacePropertyServesDinner
, GMSPlacePropertyServesLunch
, GMSPlacePropertyServesVegetarianFood
, GMSPlacePropertyServesWine
, GMSPlacePropertyTakeout
Web service : 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
, places.restroom
, places.reviews
, places.routingSummaries
, * places.servesBeer
, places.servesBreakfast
, places.servesBrunch
, places.servesCocktails
, places.servesCoffee
, places.servesDessert
, places.servesDinner
, places.servesLunch
, places.servesVegetarianFood
, places.servesWine
, places.takeout
* Text Search and Nearby Search only
MONTHLY VOLUME RANGE (Price per CALL) | ||
---|---|---|
| | |
0.040 USD per each (40.00 USD per 1000) | 0.032 USD per each (32.00 USD per 1000) | Contact Sales for volume pricing |
SKU: Text Search (ID Only)
Using a field mask or field list in your Text Search (New) request, you can limit the response to only those fields specified. This SKU is triggered when you only request the following fields:
Android : Place.Field.DISPLAY_NAME
, Place.Field.ID
, Place.Field.RESOURCE_NAME
iOS : GMSPlacePropertyPlaceID
, GMSPlacePropertyName
Places Library, Maps JavaScript API : id
Web service : places.attributions
, places.id
, places.name
* , nextPageToken
* The places.name
field contains the place resource name in the form: places/ PLACE_ID
. Use places.displayName
to access the text name of the place.
MONTHLY VOLUME RANGE (Price per CALL) | ||
---|---|---|
| | |
0.0 USD per each (0.00 USD per 1000) | 0.0 USD per each (0.00 USD per 1000) | 0.0 USD per each (0.00 USD per 1000) |
SKU: Text Search (Basic)
Using a field mask or field list in your Text Search (New) request, you can limit the response to only those fields specified. This SKU is triggered when you only request the following fields:
Android : Place.Field.ACCESSIBILITY_OPTIONS
, Place.Field.ADDRESS_COMPONENTS
, Place.Field.ADR_FORMAT_ADDRESS
, Place.Field.BUSINESS_STATUS
, Place.Field.FORMATTED_ADDRESS
, Place.Field.GOOGLE_MAPS_URI
, Place.Field.ICON_BACKGROUND_COLOR
, Place.Field.ICON_MASK_URL
, Place.Field.LOCATION
, Place.Field.PHOTO_METADATAS
, Place.Field.PLUS_CODE
, Place.Field.PRIMARY_TYPE_DISPLAY_NAME
, Place.Field.SHORT_FORMATTED_ADDRESS
, Place.Field.SUB_DESTINATIONS
, Place.Field.TYPES
, Place.Field.UTC_OFFSET
, Place.Field.VIEWPORT
iOS : GMSPlacePropertyAddressComponents
, GMSPlacePropertyBusinessStatus
, GMSPlacePropertyFormattedAddress
, GMSPlacePropertyIconBackgroundColor
, GMSPlacePropertyIconImageURL
, GMSPlacePropertyCoordinate
, GMSPlacePropertyPhotos
, GMSPlacePropertyPlusCode
, GMSPlacePropertyTypes
, GMSPlacePropertyUTCOffsetMinutes
, GMSPlacePropertyViewport
, GMSPlacePropertyWheelchairAccessibleEntrance
Places Library, Maps JavaScript API : accessibilityOptions
, addressComponents
, adrFormatAddress
, businessStatus
, displayName
, formattedAddress
, googleMapsUri
, iconBackgroundColor
, location
, photos
, plusCode
, svgIconMaskURI
, types
, utcOffsetMinutes
, viewport
Web service : 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.types
, places.utcOffsetMinutes
, places.viewport
MONTHLY VOLUME RANGE (Price per CALL) | ||
---|---|---|
| | |
0.032 USD per each (32.00 USD per 1000) | 0.0256 USD per each (25.60 USD per 1000) | Contact Sales for volume pricing |
SKU: Text Search (Advanced)
Using a field mask or field list in your Text Search (New) request, you can limit the response to only those fields specified. This SKU is triggered when you only request the following fields:
Android : Place.Field.CURRENT_OPENING_HOURS
, Place.Field.CURRENT_SECONDARY_OPENING_HOURS
Place.Field.INTERNATIONAL_PHONE_NUMBER
, Place.Field.NATIONAL_PHONE_NUMBER
Place.Field.OPENING_HOURS
, Place.Field.PRICE_LEVEL
, Place.Field.RATING
, Place.Field.SECONDARY_OPENING_HOURS
, Place.Field.USER_RATING_COUNT
Place.Field.WEBSITE_URI
iOS : GMSPlacePropertyCurrentOpeningHours
, GMSPlacePropertySecondaryOpeningHours
, GMSPlacePropertyPhoneNumber
, GMSPlacePropertyPriceLevel
, GMSPlacePropertyRating
, GMSPlacePropertyOpeningHours
, GMSPlacePropertyUserRatingsTotal
, GMSPlacePropertyWebsite
Web service : places.currentOpeningHours
, places.currentSecondaryOpeningHours
, places.internationalPhoneNumber
, places.nationalPhoneNumber
, places.priceLevel
, places.rating
, places.regularOpeningHours
, places.regularSecondaryOpeningHours
, places.userRatingCount
, places.websiteUri
Places Library, Maps JavaScript API : internationalPhoneNumber
, nationalPhoneNumber
, priceLevel
, rating
, regularOpeningHours
, userRatingCount
, websiteUri
MONTHLY VOLUME RANGE (Price per CALL) | ||
---|---|---|
| | |
0.035 USD per each (35.00 USD per 1000) | 0.028 USD per each (28.00 USD per 1000) | Contact Sales for volume pricing |
SKU: Text Search (Preferred)
Using a field mask or field list in your Text Search (New) request, you can limit the response to only those fields specified. This SKU is triggered when you only request the following fields:
Android : Place.Field.ALLOWS_DOGS
, Place.Field.CURBSIDE_PICKUP
, Place.Field.DELIVERY
, Place.Field.DINE_IN
, Place.Field.EDITORIAL_SUMMARY
, Place.Field.EV_CHARGE_OPTIONS
, Place.Field.FUEL_OPTIONS
, Place.Field.GOOD_FOR_CHILDREN
, Place.Field.GOOD_FOR_GROUPS
, Place.Field.GOOD_FOR_WATCHING_SPORTS
, Place.Field.LIVE_MUSIC
, Place.Field.MENU_FOR_CHILDREN
, Place.Field.OUTDOOR_SEATING
, Place.Field.PARKING_OPTIONS
, Place.Field.PAYMENT_OPTIONS
, Place.Field.RESERVABLE
, Place.Field.RESTROOM
, Place.Field.REVIEWS
, Place.Field.SERVES_BEER
, Place.Field.SERVES_BREAKFAST
, Place.Field.SERVES_BRUNCH
, Place.Field.SERVES_COCKTAILS
, Place.Field.SERVES_COFFEE
, Place.Field.SERVES_DESSERT
, Place.Field.SERVES_DINNER
, Place.Field.SERVES_LUNCH
, Place.Field.SERVES_VEGETARIAN_FOOD
, Place.Field.SERVES_WINE
, Place.Field.TAKEOUT
iOS : GMSPlacePropertyCurbsidePickup
, GMSPlacePropertyDelivery
, GMSPlacePropertyDineIn
, GMSPlacePropertyEditorialSummary
, GMSPlacePropertyReservable
, GMSPlacePropertyReviews
, GMSPlacePropertyServesBeer
, GMSPlacePropertyServesBreakfast
, GMSPlacePropertyServesBrunch
, GMSPlacePropertyServesDinner
, GMSPlacePropertyServesLunch
, GMSPlacePropertyServesVegetarianFood
, GMSPlacePropertyServesWine
, GMSPlacePropertyTakeout
Places Library, Maps JavaScript API : allowsDogs
, editorialSummary
, evChargeOptions
, fuelOptions
, hasCurbsidePickup
, hasDelivery
, hasDineIn
, hasLiveMusic
, hasMenuForChildren
, hasOutdoorSeating
, hasRestroom
, hasTakeout
, hasWifi
, isGoodForChildren
, isGoodForGroups
, isGoodForWatchingSports
, isReservable
, parkingOptions
, paymentOptions
, priceLevel
, reviews
, servesBeer
, servesBreakfast
, servesBrunch
, servesCocktails
, servesCoffee
, servesDessert
, servesDinner
, servesLunch
, servesVegetarianFood
, servesWine
Web service : 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
, places.restroom
, places.reviews
, places.routingSummaries
, * places.servesBeer
, places.servesBreakfast
, places.servesBrunch
, places.servesCocktails
, places.servesCoffee
, places.servesDessert
, places.servesDinner
, places.servesLunch
, places.servesVegetarianFood
, places.servesWine
, places.takeout
* Text Search and Nearby Search only
MONTHLY VOLUME RANGE (Price per CALL) | ||
---|---|---|
| | |
0.040 USD per each (40.00 USD per 1000) | 0.032 USD per each (32.00 USD per 1000) | Contact Sales for volume pricing |
SKU: Place Photo
A Place Photo SKU is charged for each request to the API.
MONTHLY VOLUME RANGE (Price per CALL) | ||
---|---|---|
| | |
0.007 USD per each (7.00 USD per 1000) | 0.0056 USD per each (5.60 USD per 1000) | Contact Sales for volume pricing |
Places product SKUs
APIs in Places include Places API , Places SDK for Android ; Places SDK for iOS ; Places Library, Maps JavaScript API ; Geocoding API ; Geolocation API ; Time Zone API ; and Elevation API .
About Autocomplete sessions
An Autocomplete session includes some Autocomplete requests (to retrieve suggestions on a place as the user types), and at most one Places Details request (to retrieve details about the place selected by the user). The same session token is passed to the Autocomplete and the subsequent Place Detail request. A session starts with the first Autocomplete request (which typically happens when the user starts typing). A Places Details call is made when the user has selected one of the Autocomplete suggestions. If a user does not select a suggestion, no Places Details call is made.
After a user has selected a place (ie, a Places Details call is made), you must start a new session using a new session token.
Autocomplete sessions can be generated from the following APIs:
- The Places API Place Autocomplete service or the Maps JavaScript API's Places Autocomplete service . You need to design your application to provide session tokens (you may need to change your existing code).
- The Maps JavaScript API's Autocomplete widget . Session-based billing is automatically enabled on those widgets, without any code change required.
A session token is good for one user session and should not be used for more than one user session. If you reuse a session token, the session is considered invalid and the requests are charged as if no session token was provided.
The Autocomplete requests and the Places Details requests using sessions are billed on different SKUs.
About Places Data SKUs
The three Places Data SKUs are: Basic Data , Contact Data , and Atmosphere Data .One or more Data SKUs are triggered for:
- Android: each request to
fetchPlace()
orfindCurrentPlace()
- iOS: each call to
fetchPlaceFromPlaceID:
orfindPlaceLikelihoodsFromCurrentLocationWithPlaceFields:
- Web service: each Places request depending on the fields specified in the request
Data SKUs are always charged in addition to the base SKU for the request triggering them. For example, a Place Details request including Basic Data fields will be charged both under the Basic Data SKU and the Place Details SKU.
For the web service, these Places APIs calls support specifying the data fields to return:
For the web service, these Places APIs calls DO NOT support specifying the returned fields. These calls always return all the Places data, charging the three Places Data SKUs in addition to the charge for each API request:
SKU: Basic Data
Using the fields parameter in your Place Details or Find Place request, you can limit the response to only those fields specified. Fields in the Basic category are included in the base cost of the Places request and do not result in any additional charge. The Basic Data SKU is triggered when any of these fields are requested:
- Android:
Place.Field.ACCESSIBILITY_OPTIONS
,Place.Field.ADDRESS_COMPONENTS
,Place.Field.BUSINESS_STATUS
,Place.Field.DISPLAY_NAME
,Place.Field.FORMATTED_ADDRESS
,Place.Field.ICON_BACKGROUND_COLOR
,Place.Field.ICON_MASK_URL
,Place.Field.ID
,Place.Field.LOCATION
,Place.Field.PHOTO_METADATAS
,Place.Field.PLUS_CODE
,Place.Field.TYPES
,Place.Field.VIEWPORT
, orPlace.Field.UTC_OFFSET
. - iOS:
GMSPlaceFieldFormattedAddress
,GMSPlaceFieldBusinessStatus
,GMSPlaceFieldID
,GMSPlaceFieldCoordinate
,GMSPlaceFieldName
,GMSPlaceFieldPhotos
,GMSPlaceFieldPlusCode
,GMSPlaceFieldTypes
, orGMSPlaceFieldViewport
- Web service:
address_component
,adr_address
,business_status
,formatted_address
,geometry
,icon
,name
,permanently_closed
,photo
,place_id
,plus_code
,type
,url
,utc_offset
,vicinity
, orwheelchair_accessible_entrance
MONTHLY VOLUME RANGE (Price per CALL) | ||
---|---|---|
| | |
Places request cost + 0.00 USD | Places request cost + 0.00 USD | Places request cost + 0.00 USD |
SKU: Contact Data
Using the fields parameter in your Place Details or Find Place request for web services, or an array of Place.Field
s for Android or iOS, you can limit the response to only those fields specified. Fields in the Contact category result in an additional charge. The Contact Data SKU is triggered when any of these fields are requested:
- Android:
Place.Field.CURRENT_OPENING_HOURS
,Place.Field.INTERNATIONAL_PHONE_NUMBER
,Place.Field.OPENING_HOURS
,Place.Field.SECONDARY_OPENING_HOURS
, orPlace.Field.WEBSITE_URI
- iOS:
GMSPlaceFieldOpeningHours
,GMSPlaceFieldPhoneNumber
, orGMSPlaceFieldWebsite
- Web service:
formatted_phone_number
,international_phone_number
,opening_hours
,current_opening_hours
,secondary_opening_hours
, orwebsite
MONTHLY VOLUME RANGE (Price per CALL) | ||
---|---|---|
| | |
Places request cost + 0.003 USD per each (+ 3.00 USD per 1000) | Places request cost + 0.0024 USD per each (+ 2.40 USD per 1000) | Contact Sales for volume pricing |
SKU: Atmosphere Data
Using the fields parameter in your Place Details or Find Place request, you can limit the response to only those fields specified. Fields in the Atmosphere category result in an additional charge. The Atmosphere Data SKU is triggered when any of these fields are requested:
- 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
, orPlace.Field.USER_RATING_COUNT
- iOS:
GMSPlaceFieldPriceLevel
,GMSPlaceFieldRating
,GMSPlaceFieldUserRatingsTotal
,GMSPlaceFieldTakeout
,GMSPlaceFieldDelivery
,GMSPlaceFieldDineIn
,GMSPlaceFieldCurbsidePickup
,GMSPlaceFieldReservable
,GMSPlaceFieldServesBreakfast
,GMSPlaceFieldServesLunch
,GMSPlaceFieldServesDinner
,GMSPlaceFieldServesBeer
,GMSPlaceFieldServesWine
,GMSPlaceFieldServesBrunch
orGMSPlaceFieldServesVegetarianFood
. - JavaScript : See Fields (Place details)
- Web service :
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
, oruser_ratings_total
.
MONTHLY VOLUME RANGE (Price per CALL) | ||
---|---|---|
| | |
Places request cost + 0.005 USD per each (+ 5.00 USD per 1000) | Places request cost + 0.004 USD per each (+ 4.00 USD per 1000) | Contact Sales for volume pricing |
SKU: Autocomplete – Per Request
The Autocomplete – Per Request SKU is charged for any of these calls or requests that do not include a session token:
- Android:
findAutocompletePredictions()
- iOS:
findAutocompletePredictionsFromQuery:
- JavaScript: the Maps JavaScript API's Place Autocomplete service
- Web service: the Places API Place Autocomplete service
Calls made from an invalid Autocomplete session (for example, a session that reuses a session token) are also charged an Autocomplete – Per Request SKU.
Autocomplete requests from the Maps JavaScript API's Place Autocomplete Widget may be charged an Autocomplete – Per Request SKU in case calls are made from an invalid Autocomplete session. This may happen when a user is typing multiple different addresses or copy/pasting different addresses into the widget and not always selects an autocomplete prediction.
MONTHLY VOLUME RANGE (Price per REQUEST) | ||
---|---|---|
| | |
0.00283 USD per each (2.83 USD per 1000) | 0.00227 USD per each (2.27 USD per 1000) | Contact Sales for volume pricing |
SKU: Autocomplete without Place Details – Per Session
The Autocomplete without Place Details – Per Session SKU is charged for an Autocomplete session that does not include a Place Details request (within a few minutes of the beginning of the session).
MONTHLY VOLUME RANGE (Price per SESSION) | ||
---|---|---|
| | |
0.017 USD per each (17.00 USD per 1000) | 0.0136 USD per each (13.60 USD per 1000) | Contact Sales for volume pricing |
مثال
If your application issues these two calls in a single session:
اندروید
- findAutocompletePredictions() (.setQuery(”par”), .setSessionToken(XYZ))
- findAutocompletePredictions() (.setQuery(”paris”), .setSessionToken(XYZ))
iOS
- placesClient?.findAutocompletePredictions(fromQuery: "par" ...
- placesClient?.findAutocompletePredictions(fromQuery: "paris" ...
وب سرویس
- Place Autocomplete Request (input=”par”, session_token: XYZ)
- Place Autocomplete Request (input=”paris”, session_token: XYZ)
On your bill, you will see this SKU listed (when viewing your bill by SKU ):
- Autocomplete without Place Details – Per Session (price starting at 0.017 USD per session)
SKU: Autocomplete (included with Place Details) – Per Session
The Autocomplete (included with Place Details) – Per Session SKU is charged for an Autocomplete session that includes any of:
- Android: a call to
fetchPlace()
- iOS: a call to
fetchPlaceFromPlaceID:
- Web service: a Place Details request
The autocomplete request is available at no charge, and the subsequent Place Details call gets charged based on regular Place Details pricing .
A Place Details request generates Data SKUs ( Basic , Contact , and/or Atmosphere ) – depending on the fields that are specified in the request.
If you do not specify fields in the Place Details request, all Data SKUs are triggered (Basic, Contact, and Atmosphere).
Place Details ID refresh requests (requests that specify only the place_id
field) during an autocomplete session are billed as SKU: Autocomplete without Place Details – Per Session .
MONTHLY VOLUME RANGE (Price per SESSION) | ||
---|---|---|
| | |
0.00 USD | 0.00 USD | 0.00 USD |
مثال
If your application issues the following three calls in a single session:
اندروید
- findAutocompletePredictions() (.setQuery(”par”), .setSessionToken(XYZ))
- findAutocompletePredictions() (.setQuery(”paris”), .setSessionToken(XYZ))
- fetchPlace() (with a
FetchPlaceRequest
including the Place ID, and the ADDRESS field)
iOS
- placesClient?.findAutocompletePredictions(fromQuery: "par" ...
- placesClient?.findAutocompletePredictions(fromQuery: "paris" ...
- fetchPlaceFromPlaceID: (including the Place ID, and the
GMSPlaceFieldFormattedAddress
field)
وب سرویس
- Places Autocomplete Request (input=”par”, session_token: XYZ)
- Places Autocomplete Request (input=”paris”, session_token: XYZ)
- Places Details (place_id, session_token: XYZ, fields:formatted_address)
On your bill, you will see these SKUs listed (when viewing your bill by SKU ):
- Autocomplete (included with Place Details) – Per Session (billed at 0.00 USD)
- Place Details (price starting at 0.017 USD per session)
- Basic Data (billed at 0.00 USD)
SKU: Query Autocomplete – Per Request
A Query Autocomplete – Per Request SKU is charged for each request to:
- JavaScript: the Maps JavaScript API's Places Autocomplete Service (
getQueryPredictions()
) and the use of the Maps JavaScript API's SearchBox widget (Query Autocomplete requests are generated as the user types). - Web service: the Places API Query Autocomplete service
MONTHLY VOLUME RANGE (Price per REQUEST) | ||
---|---|---|
| | |
0.00283 USD per each (2.83 USD per 1000) | 0.00227 USD per each (2.27 USD per 1000) | Contact Sales for volume pricing |
Pricing by Autocomplete session is not supported using Query Autocomplete. Subsequent Places Details calls get charged based on regular Places Details pricing .
SKU: Place Details
Place Details calls are charged as follows:
MONTHLY VOLUME RANGE (Price per CALL) | ||
---|---|---|
| | |
0.017 USD per each (17.00 USD per 1000) | 0.0136 USD per each (13.60 USD per 1000) | Contact Sales for volume pricing |
The Place Details SKU is generated from these APIs:
- Android: Places SDK for Android (
fetchPlace()
) - iOS: Places SDK for iOS (
fetchPlaceFromPlaceID:
) - JavaScript: Maps JavaScript API's Place Details service (
getDetails
) - JavaScript: Maps JavaScript API's Place Autocomplete widget (
getPlace
) - JavaScript: Maps JavaScript API's Place SearchBox widget :
getPlaces()
method after the user selects a place result (icon: pin), *not* a query (icon: magnifier), as illustrated here: - Web service: Places API Place Details service
With the web API and services, the Place Details SKU is charged whether a session token is provided or not.
A Place Details call or request also generates Data SKUs ( Basic , Contact , and/or Atmosphere ), depending on the fields that are specified in the call or request. If NO fields are specified in the Place Details call or request, ALL Data SKUs are triggered, and you are charged for the Places Details call or request plus the cost of all the data.
نمونه ها
- Make one of these calls or requests:
- Mobile: call
fetchPlace()
on Android orfetchPlaceFromPlaceID:
on iOS, and specify just theADDRESS
field - Web API or service: make a Place Details request and specify just the address field:
getPlaceDetails(fields: formatted_address)
- Place Details (price starting at 0.017 USD per session)
- Basic Data (billed at 0.00 USD)
- Mobile: call
- Make one of these calls or requests:
- Mobile: call
fetchPlace()
on Android orfetchPlaceFromPlaceID:
on iOS, and specify just thePHONE_NUMBER
field - Web API or service: make a Place Details request and specify the phone number field:
getPlaceDetails(fields: formatted_phone_number)
- Place Details (price starting at 0.017 USD per session)
- Contact Data (price starting at 0.003 USD per request)
- Mobile: call
- Make one of these calls or requests:
- Mobile: call
fetchPlace()
on Android orfetchPlaceFromPlaceID:
on iOS, and specify all the fields - Web API or service: make a Place Details request and specify all the fields (this type of request is the default if you do not specify any fields):
getPlaceDetails()
.
- Place Details (price starting at 0.017 USD per session)
- Basic Data (billed at 0.00 USD)
- Contact Data (price starting at 0.003 USD per request)
- Atmosphere Data (price starting at 0.005 USD per request)
- Mobile: call
SKU: Place Details – ID Refresh
Use the Place Details request to refresh stale place IDs . These types of requests are available at no charge.
MONTHLY VOLUME RANGE (Price per CALL) | ||
---|---|---|
| | |
0.00 USD | 0.00 USD | 0.00 USD |
مثال
Make a Place Details request specifying just the place id field: getPlaceDetails(fields: place_id)
. On your bill, you will see this SKU listed (when viewing your bill by SKU ):
- Place Details – ID Refresh (billed at 0.00 USD)
SKU: Find Place
Find Place is charged for a Find Place request.
MONTHLY VOLUME RANGE (Price per CALL) | ||
---|---|---|
| | |
0.017 USD per each (17.00 USD per 1000) | 0.0136 USD per each (13.60 USD per 1000) | Contact Sales for volume pricing |
Find Place requests also generate Data SKUs ( Basic , Contact , and/or Atmosphere ), depending on the fields that are specified in the request. Like Place Details requests, you can use the fields parameter in your Find Place request to limit the response to only those fields specified. You are billed for the Find Place request as well as the data requested. By default, if NO fields are requested, only the place id is returned, so no additional data charges are incurred.
نمونه ها
- You make a Find Place request and specify just the address field:
FindPlace(fields: formatted_address)
. On your bill, you will see these SKUs listed (when viewing your bill by SKU ):- Find Place (price starting at 0.017 USD per call)
- Basic Data (billed at 0.00 USD)
- You make a Find Place request and specify the phone number field:
FindPlace(fields: formatted_phone_number)
. On your bill, you will see these SKUs listed (when viewing your bill by SKU ):- Find Place (price starting at 0.017 USD per call)
- Contact Data (price starting at 0.003 USD per request)
- You make a Find Place request and specify fields from all three data-type buckets:
FindPlace(fields: formatted_address, opening_hours, price_level)
. On your bill, you will see these SKUs listed (when viewing your bill by SKU ):- Find Place (price starting at 0.017 USD per call)
- Basic Data (billed at 0.00 USD)
- Contact Data (price starting at 0.003 USD per request)
- Atmosphere Data (price starting at 0.005 USD per request)
SKU: Find Place – ID only
Find Place – ID only is charged for Find Place requests that only specify the Place ID to be returned. By default, if no fields are specified in the Find Place request, only the place id is returned.
MONTHLY VOLUME RANGE (Price per CALL) | ||
---|---|---|
| | |
0.00 USD | 0.00 USD | 0.00 USD |
مثال
You make a Find Place request and only specify the place_id
field: FindPlace(fields: place_id)
. On your bill, you will see this SKU listed (when viewing your bill by SKU ):
- Find Place – ID only (billed at 0.00 USD)
SKU: Find Current Place
Find Current Place is charged for calls to findCurrentPlace()
(Android) or findPlaceLikelihoodsFromCurrentLocationWithPlaceFields:
(iOS).
MONTHLY VOLUME RANGE (Price per CALL) | ||
---|---|---|
| | |
0.030 USD per each (30.00 USD per 1000) | 0.024 USD per each (24.00 USD per 1000) | Contact Sales for volume pricing |
Calls to findCurrentPlace()
(Android) or findPlaceLikelihoodsFromCurrentLocationWithPlaceFields:
(iOS) also generate Data SKUs ( Basic , Contact , and/or Atmosphere ), depending on the fields that are specified in the call. Specify data fields to limit the response to only those fields. You are billed for the Find Current Place call as well as the data requested.
نمونه ها
- You call
findCurrentPlace()
(Android) orfindPlaceLikelihoodsFromCurrentLocationWithPlaceFields:
(iOS) and specify just theADDRESS
field. On your bill, you will see these SKUs listed (when viewing your bill by SKU ):- Find Current Place (price starting at 0.030 USD per request)
- Basic Data (billed at 0.00 USD)
- You call
findCurrentPlace()
(Android) orfindPlaceLikelihoodsFromCurrentLocationWithPlaceFields:
(iOS) and specify thePHONE_NUMBER
field. On your bill, you will see these SKUs listed (when viewing your bill by SKU ):- Find Current Place (price starting at 0.030 USD per request)
- Contact Data (price starting at 0.003 USD per request)
- You call
findCurrentPlace()
(Android) orfindPlaceLikelihoodsFromCurrentLocationWithPlaceFields:
(iOS) and specify fields from all three data-type buckets. On your bill, you will see these SKUs listed (when viewing your bill by SKU ):- Find Current Place (price starting at 0.030 USD per request)
- Basic Data (billed at 0.00 USD)
- Contact Data (price starting at 0.003 USD per request)
- Atmosphere Data (price starting at 0.005 USD per request)
SKU: Place – Nearby Search
Place – Nearby Search is charged for requests to the Maps JavaScript API's Place Nearby Search service ( nearbySearch()
), or to the Places API Nearby Search service
MONTHLY VOLUME RANGE (Price per CALL) | ||
---|---|---|
| | |
0.032 USD per each (32.00 USD per 1000) | 0.0256 USD per each (25.60 USD per 1000) | Contact Sales for volume pricing |
Nearby Search requests return a list of places, but do not support specifying which fields are returned. Nearby Search requests return a subset of the supported data fields . You are charged for the Nearby Search request starting at 0.032 USD per each, as well as all of the data-type SKUs ( Basic Data , Contact Data , and Atmosphere Data ).
مثال
You make a Nearby Search request, such as NearbySearch (San Francisco, 100 meters)
. On your bill, you will see these SKUs listed (when viewing your bill by SKU ):
- Place - Nearby Search (price starting at 0.032 USD per call)
- Basic Data (billed at 0.00 USD)
- Contact Data (price starting at 0.003 USD per request)
- Atmosphere Data (price starting at 0.005 USD per request)
SKU: Place – Text Search
Place – Text Search is charged for requests to the Maps JavaScript API's Place Text Search service ( textSearch()
), or to the Places API Text Search service .
MONTHLY VOLUME RANGE (Price per CALL) | ||
---|---|---|
| | |
0.032 USD per each (32.00 USD per 1000) | 0.0256 USD per each (25.60 USD per 1000) | Contact Sales for volume pricing |
Text Search requests return a list of places, but do not support specifying which fields are returned. Text Search requests return a subset of the supported data fields . You are charged for the Text Search request starting at 0.032 USD per each, as well as all of the data-type SKUs ( Basic Data , Contact Data , and Atmosphere Data ).
The Place – Text Search SKU is also generated by the Maps JavaScript API's Place SearchBox widget : getPlaces()
method after the user selects a place query (icon: magnifier), not a result (icon: pin), as illustrated here:
مثال
You make a Text Search request, such as TextSearch(123 Main Street)
. On your bill, you will see these SKUs listed (when viewing your bill by SKU ):
- Place - Text Search (price starting at 0.032 USD per call)
- Basic Data (billed at 0.00 USD)
- Contact Data (price starting at 0.003 USD per request)
- Atmosphere Data (price starting at 0.005 USD per request)
SKU: Place Photo
A Place Photo SKU is charged for:
- Android: calls to
fetchPhoto()
- iOS: calls to
loadPlacePhoto:
- JavaScript: to Places Library, Maps JavaScript API's Place Photos service when requesting data from the URLs returned by
PlacePhoto.getUrl()
to load image pixel data - Web service: requests to the Places API Place Photos service
For the JavaScript service, invoking the PlacePhoto.getUrl()
method does not cause billing until the URL is actually used to obtain pixel data.
MONTHLY VOLUME RANGE (Price per CALL) | ||
---|---|---|
| | |
0.007 USD per each (7.00 USD per 1000) | 0.0056 USD per each (5.60 USD per 1000) | Contact Sales for volume pricing |
SKU: Geocoding
A Geocoding SKU is charged for requests to the Maps JavaScript API's Geocoding service or to the Geocoding API . In JavaScript , the method Geocoder.geocode()
initiates the request to the Geocoding Service.
MONTHLY VOLUME RANGE (Price per REQUEST) | ||
---|---|---|
| | |
0.005 USD per each (5.00 USD per 1000) | 0.004 USD per each (4.00 USD per 1000) | Contact Sales for volume pricing |
SKU: Geolocation
A Geolocation SKU is charged for requests to the Geolocation API .
MONTHLY VOLUME RANGE (Price per REQUEST) | ||
---|---|---|
| | |
0.005 USD per each (5.00 USD per 1000) | 0.004 USD per each (4.00 USD per 1000) | Contact Sales for volume pricing |
SKU: Map Tiles API: 2D Map Tiles
A request to Map Tiles API retrieving Roadmap , Satellite , or Terrain Tiles. Note that Session Token and Viewport information requests aren't billed.
MONTHLY VOLUME RANGE (Price per REQUEST) | |||||
---|---|---|---|---|---|
0 - 1,000,000 | 1,000,001 - 5,000,000 | 5,000,001+ | |||
0.0006 USD per each (0.60 USD per 1000) | 0.00048 USD per each (0.48 USD per 1000) | Contact Sales for volume pricing |
SKU: Map Tiles API: Street View Tiles
A request to Map Tiles API retrieving Street View Tiles, Street View Thumbnails, or Street View PanoIDs. Note that Session Token and Street View Metadata requests aren't billed.
MONTHLY VOLUME RANGE (Price per REQUEST) | |||||
---|---|---|---|---|---|
0 - 1,000,000 | 1,000,001 - 5,000,000 | 5,000,001+ | |||
0.002 USD per each (2.00 USD per 1000) | 0.0016 USD per each (1.60 USD per 1000) | Contact Sales for volume pricing |
SKU: Map Tiles API: Photorealistic 3D Tiles
A request to Map Tiles API retrieving 3D Root Tiles.
MONTHLY VOLUME RANGE (Price per REQUEST) | |||||
---|---|---|---|---|---|
| | | |||
0.006 USD per each (6.00 USD per 1000) | 0.0051 USD per each (5.10 USD per 1000) | Contact Sales for volume pricing |
SKU: Time Zone
A Time Zone SKU is charged for requests to the Time Zone API .
MONTHLY VOLUME RANGE (Price per REQUEST) | ||
---|---|---|
| | |
0.005 USD per each (5.00 USD per 1000) | 0.004 USD per each (4.00 USD per 1000) | Contact Sales for volume pricing |
SKU: Elevation
An Elevation SKU is charged for requests to the Maps JavaScript API ’s Elevation service or to the Elevation API .
MONTHLY VOLUME RANGE (Price per REQUEST) | ||
---|---|---|
| | |
0.005 USD per each (5.00 USD per 1000) | 0.004 USD per each (4.00 USD per 1000) | Contact Sales for volume pricing |
SKU: Address Validation
A request to the validateAddress method (REST) and ValidateAddress method (gRPC) of the Address Validation API .
MONTHLY VOLUME RANGE (Price per REQUEST) | ||
---|---|---|
| | |
0.017 USD per each (17.00 USD per 1000) | 0.0136 USD per each (13.60 USD per 1000) | Contact Sales for volume pricing |
SKU: Address Validation Preferred
Address Validation Preferred works with the Autocomplete (New) endpoint of the Places API when you use it with sessions that terminate with a call to the Address Validation API. Specifically, sessions that use Autocomplete (New) and terminate in either a request to validateAddress (REST) or ValidateAddress (gRPC) fall under this pricing model.
For details about both pricing and using Autocomplete (New) sessions with Places API, see the following guides in the Places API documentation:
When using Address Validation Preferred at the end of an Autocomplete (New) session, you are billed as follows:
MONTHLY VOLUME RANGE (Price per REQUEST) | ||
---|---|---|
| | |
0.025 USD per each (25.00 USD per 1000) | 0.020 USD per each (20.00 USD per 1000) | Contact Sales for volume pricing |
Environment product SKUs
APIs in Environment include: Air Quality API , Pollen API , and Solar API .
SKU: Air Quality
This SKU applies for the following endpoints and methods:
MONTHLY VOLUME RANGE (Price per REQUEST) | |||||
---|---|---|---|---|---|
| | | |||
0.005 USD per each (5.00 USD per 1000) | 0.004 USD per each (4.00 USD per 1000) | Contact Sales for volume pricing |
SKU: Pollen
This SKU applies for the following endpoints/methods:
MONTHLY VOLUME RANGE (Price per REQUEST) | |||||
---|---|---|---|---|---|
| | | |||
0.01 USD per each (10.00 USD per 1000) | 0.008 USD per each (8.00 USD per 1000) | Contact Sales for volume pricing |
SKU: Solar Building Insights
A request to buildingInsights .
MONTHLY VOLUME RANGE (Price per REQUEST) | |||||
---|---|---|---|---|---|
| | | |||
0.01 USD per each (10.00 USD per 1000) | 0.005 USD per each (5.00 USD per 1000) | Contact Sales for volume pricing |
SKU: Solar Data Layers
A request to dataLayers .
Accessing multiple imagery URLs from the same request does not generate additional charged queries. MONTHLY VOLUME RANGE (Price per REQUEST) | |||||
---|---|---|---|---|---|
| | | |||
0.075 USD per each (75.00 USD per 1000) | 0.0375 USD per each (37.50 USD per 1000) | Contact Sales for volume pricing |
Navigation SKU
Navigation SDKs include: Navigation SDK for Android and Navigation SDK for iOS .
SKU: Navigation Request
Each destination requested using the Navigation SDK is billed as a Navigation Request SKU unit. The price per SKU unit is determined by your total monthly call volume for the SKU:
MONTHLY VOLUME RANGE (Price per destination) | ||
---|---|---|
1–1,000 | 1,001–4,200,000 | 4,200,000+ |
بدون هزینه | 0.05 USD | 0.0395 USD |
Route request methods
Route generation requests to the Navigation SDK can be made by calling the following methods:
اندروید
- setDestination (Waypoint destination)
- setDestination (Waypoint destination, RoutingOptions options)
- setDestination (Waypoint destination, RoutingOptions routingOptions, DisplayOptions displayOptions)
- setDestinations (List<Waypoint> destinations)
- setDestinations (List<Waypoint> destinations, RoutingOptions options)
- setDestinations (List<Waypoint> destinations, CustomRoutesOptions customRoutesOptions)
- setDestinations (List<Waypoint> destinations, RoutingOptions routingOptions, DisplayOptions displayOptions)
- setDestinations (List<Waypoint> destinations, CustomRoutesOptions customRoutesOptions, DisplayOptions displayOptions)
- simulateLocationsAlongNewRoute(List<Waypoint> waypoints)
- simulateLocationsAlongNewRoute(List<Waypoint> waypoints, RoutingOptions routingOptions)
- simulateLocationsAlongNewRoute(List<Waypoint> waypoints, RoutingOptions routingOptions, SimulationOptions simulationOptions)
- [Deprecated] setDestinations (List<Waypoint> destinations, String routeToken)
iOS
Keep in mind that a single method call can contain up to 25 destinations, and the cost for each call is calculated by multiplying the number of destinations by the price per SKU unit .
،This section lists the SKUs defined for the core Google Maps Platform products. The core products are pay as you go and you only pay for the SKUs you use.
For each SKU listed you'll see:
- The SKU name as it appears on your billing report.
- Details describing the type of use that triggers the SKU (billable events).
- The price per each use for the volume-based tiers.
- Any additional SKU-specific pricing notes.
Look up individual product SKUs here, or use our Pricing and Usage calculator to estimate your usage versus total cost per API.
GMP Product / SKU table
Maps product SKUs
APIs in Maps include: Maps SDK for Android ; Maps SDK for iOS ; Maps JavaScript API ; Maps Static API ; Street View Static API ; and Maps Embed API .
SKU: Mobile Native Static Maps
Includes a Google map object in lite mode, not loaded with a map ID, in an Maps SDK for Android mobile application.
MONTHLY VOLUME RANGE (Price per MAP LOAD) | ||
---|---|---|
| | |
0.00 USD | 0.00 USD | 0.00 USD |
A single map load is accrued for each instantiation of a Google map object in lite mode, in a Maps SDK for Android mobile application. Maps are created with instances of MapFragment
, SupportMapFragment
, or MapView
classes. A map load is counted each time the related onCreate()
method is called.
SKU: Mobile Native Dynamic Maps
A Google map object, not loaded with a map ID, in a Maps SDK for Android or Maps SDK for iOS mobile application.
MONTHLY VOLUME RANGE (Price per MAP LOAD) | ||
---|---|---|
| | |
0.00 USD | 0.00 USD | 0.00 USD |
A single map load is accrued for each instantiation of a Google map object in a Maps SDK for Android or Maps SDK for iOS mobile application:
- One of
MapFragment
,SupportMapFragment
, orMapView
classes on Android. A map load is counted each time the relatedonCreate()
method is called. - A
GMSMapView
object on iOS.
User interactions with the map, such as panning, zooming, or switching map layers, do not generate additional map loads. With the pay-as-you-go pricing model, the creation of a Street View panorama is no longer charged as a Mobile Native map load. It is charged as a Dynamic Street View .
SKU: Embed and SKU: Embed Advanced
همه درخواستهای Maps Embed API بدون هزینه و با استفاده نامحدود در دسترس هستند.
SKU: Static Maps
A request to the Maps Static API .
MONTHLY VOLUME RANGE (Price per MAP LOAD) | ||
---|---|---|
| | |
0.002 USD per each (2.00 USD per 1000) | 0.0016 USD per each (1.60 USD per 1000) | Contact Sales for volume pricing |
SKU: Dynamic Maps
An application that displays either a map loaded with or without a map ID using Maps JavaScript API , or a map loaded with a map ID and using either the Maps SDK for Android or Maps SDK for iOS .
MONTHLY VOLUME RANGE (Price per MAP LOAD) | ||
---|---|---|
| | |
0.007 USD per each (7.00 USD per 1000) | 0.0056 USD per each (5.60 USD per 1000) | Contact Sales for volume pricing |
User interactions with the map, such as panning, zooming, or switching map layers, do not generate additional map loads.
SKU: Static Street View
Street View panoramas and map loads are now charged separately. A static Street View panorama is charged for each request to the Street View Static API to embed a static (non-interactive) Street View panorama. Usage of the Street View Image Metadata endpoint is not charged.
MONTHLY VOLUME RANGE (Price per PANORAMA) | ||
---|---|---|
| | |
0.007 USD per each (7.00 USD per 1000) | 0.0056 USD per each (5.60 USD per 1000) | Contact Sales for volume pricing |
SKU: Dynamic Street View
Street View panoramas and map loads are now charged separately. A dynamic Street View panorama is charged for each instantiation of a panorama object in a Maps JavaScript API , Maps SDK for Android , Maps SDK for iOS application.
MONTHLY VOLUME RANGE (Price per PANORAMA) | ||
---|---|---|
| | |
0.014 USD per each (14.00 USD per 1000) | 0.0112 USD per each (11.20 USD per 1000) | Contact Sales for volume pricing |
An instantiation of a panorama object occurs:
- In JavaScript , with the
google.maps.StreetViewPanorama()
class orMap.getStreetView()
method. Neither the built-in Street View experience based on the Street View Pegman control nor usage of theStreetViewService()
class is charged. - On Android , with one of
StreetViewPanoramaFragment
,SupportStreetViewPanoramaFragment
, orStreetViewPanoramaView
classes. A panorama is counted each time the relatedonCreate()
method is called. - On iOS , with the
GMSPanoramaView
object.
SKU: Aerial View
A request to the Aerial View API that returns an aerial video URL.
MONTHLY VOLUME RANGE (Price per successful lookupVideo request) | ||
---|---|---|
| | |
0.016 USD per each (16.00 USD per 1000) | 0.0128 USD per each (12.80 USD per 1000) | Contact Sales for volume pricing |
Only calls to lookupVideo
that return URLs are billed. A single, successful lookupVideo
response may return multiple URLs, each for a different resolution or orientation, but only constitutes a single billable event. Note that pricing does not depend on actual views of those URLs by end users.
Routes product SKUs
APIs in Routes include: Directions API ; Distance Matrix API ; and Roads API .
SKU: Directions
A request to the Maps JavaScript API's Directions Service (excludes requests triggering the Directions Advanced billing SKU) or the Directions API .
MONTHLY VOLUME RANGE (Price per QUERY) | ||
---|---|---|
| | |
0.005 USD per each (5.00 USD per 1000) | 0.004 USD per each (4.00 USD per 1000) | Contact Sales for volume pricing |
SKU: Directions Advanced
A request to the Maps JavaScript API's Directions Service or the Directions API that uses traffic information, more than 10 waypoints, waypoints optimization, and/or location modifiers.
MONTHLY VOLUME RANGE (Price per QUERY) | ||
---|---|---|
| | |
0.01 USD per each (10.00 USD per 1000) | 0.008 USD per each (8.00 USD per 1000) | Contact Sales for volume pricing |
A Directions Advanced SKU is charged for a Maps JavaScript API's Directions Service or a Directions API request that uses one or more of the following:
- Traffic information. Traffic information is used when all the following apply (these are the conditions required to receive the
duration_in_traffic
field in the Directions response):- The travel
mode
parameter isdriving
, or is not specified (driving
is the default travel mode). - The request includes a valid
departure_time
parameter . Thedeparture_time
can be set to the current time or some time in the future. It cannot be in the past. - The request does not include stopover waypoints . If the request includes waypoints, prefix each waypoint with
via:
to influence the route but avoid stopovers. به عنوان مثال،&waypoints=via:San Francisco|via:Mountain View|...
- The travel
- More than 10 waypoints (between 11 and 25).
- Waypoints optimization. The
optimize
parameter is set totrue
for waypoints. به عنوان مثال،&waypoints=optimize:true|San Francisco|Mountain View|...
- Location modifiers. When you use the following location modifiers to indicate how drivers should approach a particular location:
-
side_of_road
-
heading
-
SKU: Distance Matrix
A request to the Distance Matrix API or the Maps JavaScript API's Distance Matrix Service (excludes requests triggering the Distance Matrix Advanced billing SKU billing SKU).
MONTHLY VOLUME RANGE (Price per ELEMENT) | ||
---|---|---|
| | |
0.005 USD per each (5.00 USD per 1000) | 0.004 USD per each (4.00 USD per 1000) | Contact Sales for volume pricing |
Each query sent to the Distance Matrix API generates elements, where the number of origins
times the number of destinations
equals the number of elements.
SKU: Distance Matrix Advanced
A request to the Distance Matrix API or the Maps JavaScript API's Distance Matrix Service that uses traffic information and/or location modifiers.
MONTHLY VOLUME RANGE (Price per ELEMENT) | ||
---|---|---|
| | |
0.01 USD per each (10.00 USD per 1000) | 0.008 USD per each (8.00 USD per 1000) | Contact Sales for volume pricing |
Each query sent to the Distance Matrix API generates elements, where the number of origins
times the number of destinations
equals the number of elements.
A Distance Matrix Advanced SKU is charged for a Distance Matrix API or a Maps JavaScript API's Distance Matrix Service that uses one or more of the following:
- Traffic information. Traffic information is used when all the following apply (these are the conditions required to receive the
duration_in_traffic
field in the Distance Matrix response):- The travel
mode
parameter isdriving
, or is not specified (driving
is the default travel mode). - The request includes a valid
departure_time
parameter . Thedeparture_time
can be set to the current time or some time in the future. It cannot be in the past.
- The travel
- Location modifiers. When you use the following location modifiers to indicate how drivers should approach a particular location:
-
side_of_road
-
heading
-
SKU: Roads – Route Traveled
A request to the Roads API's Snap to Roads service .
MONTHLY VOLUME RANGE (Price per QUERY) | ||
---|---|---|
| | |
0.01 USD per each (10.00 USD per 1000) | 0.008 USD per each (8.00 USD per 1000) | Contact Sales for volume pricing |
SKU: Roads – Nearest Road
A request to the Roads API's Nearest Roads service .
MONTHLY VOLUME RANGE (Price per QUERY) | ||
---|---|---|
| | |
0.01 USD per each (10.00 USD per 1000) | 0.008 USD per each (8.00 USD per 1000) | Contact Sales for volume pricing |
SKU: Roads – Speed Limits
A request to the Roads API's Speed Limits service . MONTHLY VOLUME RANGE (Price per ELEMENT) | ||
---|---|---|
| | |
0.02 USD per each (20.00 USD per 1000) | 0.016 USD per each (16.00 USD per 1000) | Contact Sales for volume pricing |
Speed Limit requests are billed per speed limit element returned in the API response. This amount will always be equal to or less than the number of points passed in the original request.
SKU: Routes: Compute Routes - Basic
A request to Compute Routes .
MONTHLY VOLUME RANGE Price per QUERY | ||
---|---|---|
| | |
0.005 USD per each (5.00 USD per 1000) | 0.004 USD per each (4.00 USD per 1000) | Contact Sales for volume pricing |
SKU: Routes: Compute Routes - Advanced
A request to Compute Routes that uses advanced features.
MONTHLY VOLUME RANGE Price per QUERY | ||
---|---|---|
| | |
0.01 USD per each (10.00 USD per 1000) | 0.008 USD per each (8.00 USD per 1000) | Contact Sales for volume pricing |
The Advanced SKU is charged for a Compute Routes request that uses one or more of the following features:
- Between 11 and 25 intermediate waypoints
- Traffic aware or traffic aware optimal routing. These routing options correspond to setting the
routingPreference
property in the request toTRAFFIC_AWARE
orTRAFFIC_AWARE_OPTIMAL
. - Location modifiers. When you use the following options to indicate how drivers should approach a particular location:
SKU: Routes: Compute Routes - Preferred
A request to Compute Routes that uses preferred features.
MONTHLY VOLUME RANGE Price per QUERY | ||
---|---|---|
| | |
0.015 USD per each (15.00 USD per 1000) | 0.012 USD per each (12.00 USD per 1000) | Contact Sales for volume pricing |
The Preferred SKU is charged for a Compute Routes request that uses one or more of the following features:
SKU: Routes: Compute Route Matrix - Basic
A request to Compute Route Matrix .
MONTHLY VOLUME RANGE Price per ELEMENT | ||
---|---|---|
| | |
0.005 USD per each (5.00 USD per 1000) | 0.004 USD per each (4.00 USD per 1000) | Contact Sales for volume pricing |
SKU: Routes: Compute Route Matrix - Advanced
A request to Compute Route Matrix that uses advanced features.
MONTHLY VOLUME RANGE Price per ELEMENT | ||
---|---|---|
| | |
0.01 USD per each (10.00 USD per 1000) | 0.008 USD per each (8.00 USD per 1000) | Contact Sales for volume pricing |
The Advanced SKU is charged for a Compute Route Matrix request that uses one or more of the following features:
- Traffic aware or traffic aware optimal routing. These routing options correspond to setting the
routingPreference
property in the request toTRAFFIC_AWARE
orTRAFFIC_AWARE_OPTIMAL
. - Location modifiers. When you use the following options to indicate how drivers should approach a particular location:
SKU: Routes: Compute Route Matrix - Preferred
A request to Compute Route Matrix that uses preferred features.
MONTHLY VOLUME RANGE Price per ELEMENT | ||
---|---|---|
| | |
0.015 USD per each (15.00 USD per 1000) | 0.012 USD per each (12.00 USD per 1000) | Contact Sales for volume pricing |
The Preferred SKU is charged for a Compute Route Matrix request that uses one or more of the following features:
SKU: Route Optimization: Single Vehicle Routing
A request to the Route Optimization API that specifies exactly one vehicle.
MONTHLY VOLUME RANGE (Price per SHIPMENT) | ||
---|---|---|
| | |
0.01 USD per each (10.00 USD per 1000) | 0.004 USD per each (4.00 USD per 1000) | Contact Sales for volume pricing |
SKU: Route Optimization: Fleet Routing
A request to the Route Optimization API that specifies more than one vehicle.
MONTHLY VOLUME RANGE (Price per SHIPMENT) | ||
---|---|---|
| | |
0.03 USD per each (30.00 USD per 1000) | 0.014 USD per each (14.00 USD per 1000) | Contact Sales for volume pricing |
Places (New) product SKUs
About field masks
Use field masks, also called field lists , in your requests to specify the list of fields to return in the response. You are then billed at the highest SKU applicable to your request. That means if you select fields in both the (Basic) SKU and the (Advanced) SKU, you are billed based on the (Advanced) SKU.
Using a field mask is a good design practice to ensure that you don't request unnecessary data, which helps to avoid unnecessary processing time and billing charges.
About Autocomplete (New) sessions
An Autocomplete (New) session includes one or more Autocomplete (New) requests, and a Place Details (New) request or Address Validation request. The same session token is passed to the Autocomplete (New) request and to the subsequent Place Details (New) request or Address Validation request.
A session starts with the first Autocomplete (New) request. A Place Details (New) request or Address Validation request is then made when the user has selected one of the Autocomplete (New) suggestions. If a session is abandoned, meaning no Place Details (New) request or Address Validation request is made, Autocomplete (New) requests are charged as if no session token was provided.
After a user has selected a place (meaning a Place Details (New) request or Address Validation request is made), you must start a new session using a new session token.
A session token is good for one session and cannot be used for more than one session. If you reuse a session token, the session is considered invalid and the requests are charged as if no session token was provided.
SKU: Autocomplete Requests
An Autocomplete Requests SKU is charged for each request to the Autocomplete (New) API that does not include a session token.
It is also charged if you use session tokens and either:
- Terminate the sessions by a single request to Place Details (New) that requests any fields defined by the SKU: Place Details (Location Only) .
- Each Autocomplete (New) request, up to 12 requests, is billed using the SKU: Autocomplete Requests .
- Each subsequent Autocomplete (New) request is billed using the SKU: Autocomplete Session Usage .
- Abandon the session or end the session by making a call to the SKU: Place Details (IDs Only) . All Autocomplete (New) requests are then billed using the SKU: Autocomplete Requests .
MONTHLY VOLUME RANGE (Price per CALL) | ||
---|---|---|
| | |
0.00283 USD per each (2.83 USD per 1000) | 0.00227 USD per each (2.27 USD per 1000) | Contact Sales for volume pricing |
SKU: Autocomplete Session Usage
An Autocomplete Session Usage SKU is charged for each request to the Autocomplete (New) API that includes a session token.
This SKU is charged in these scenarios:
Autocomplete session terminated by a call to SKU: Place Details (Location Only) :
- Each Autocomplete (New) request, up to 12 requests, is billed using the SKU: Autocomplete Requests .
- Each subsequent Autocomplete (New) request is billed using the SKU: Autocomplete Session Usage .
Autocomplete session terminated with a call to SKU: Place Details (Basic, Advanced, or Preferred) .
A Place Details call that requests any field from the SKU: Place Details (Basic, Advanced, or Preferred) is billed at the SKU: Place Details (Preferred) .
Autocomplete session terminated with a call to SKU: Address Validation Preferred .
For more information, see Autocomplete (New) and session pricing .
MONTHLY VOLUME RANGE (Price per CALL) | ||
---|---|---|
| | |
0.00 USD per each (0.00 USD per 1000) | 0.00 USD per each (0.00 USD per 1000) | 0.00 USD per each (0.00 USD per 1000) |
SKU: Place Details (IDs Only)
Using a field mask or field list in your Place Details (New) request, you can limit the response to only those fields specified. This SKU is triggered when you only request the following fields:
Android : Place.Field.DISPLAY_NAME
, Place.Field.ID
, Place.Field.PHOTO_METADATAS
, Place.Field.RESOURCE_NAME
Places Library, Maps JavaScript API : id
, photos
iOS : GMSPlacePropertyPlaceID
, GMSPlacePropertyName
, GMSPlacePropertyPhotos
Web service : attributions
, id
, name
* , photos
* The name
field contains the place resource name in the form: places/ PLACE_ID
. Use displayName
to access the text name of the place.
MONTHLY VOLUME RANGE (Price per CALL) | ||
---|---|---|
| | |
0.0 USD per each (0.00 USD per 1000) | 0.0 USD per each (0.00 USD per 1000) | 0.0 USD per each (0.00 USD per 1000) |
SKU: Place Details (Location Only)
Using a field mask or field list in your Place Details (New) request, you can limit the response to only those fields specified. This SKU is triggered when you only request the following fields:
Android : Place.Field.ADDRESS_COMPONENTS
, ADR_FORMAT_ADDRESS
, Place.Field.FORMATTED_ADDRESS
, Place.Field.LOCATION
, Place.Field.PLUS_CODE
, Place.Field.SHORT_FORMATTED_ADDRESS
, Place.Field.TYPES
, Place.Field.VIEWPORT
Places Library, Maps JavaScript API : addressComponents
, adrFormatAddress
, formattedAddress
, location
, plusCode
, types
, viewport
iOS : GMSPlacePropertyAddressComponents
, GMSPlacePropertyFormattedAddress
, GMSPlacePropertyCoordinate
, GMSPlacePropertyPlusCode
, GMSPlacePropertyTypes
, GMSPlacePropertyViewport
Web service : addressComponents
, adrFormatAddress
, formattedAddress
, location
, plusCode
, shortFormattedAddress
, types
, viewport
MONTHLY VOLUME RANGE (Price per CALL) | ||
---|---|---|
| | |
0.005 USD per each (5.00 USD per 1000) | 0.004 USD per each (4.00 USD per 1000) | Contact Sales for volume pricing |
SKU: Place Details (Basic)
Using a field mask or field list in your Place Details (New) request, you can limit the response to only those fields specified. This SKU is triggered when you only request the following fields:
Android : Place.Field.ACCESSIBILITY_OPTIONS
, Place.Field.BUSINESS_STATUS
, Place.Field.GOOGLE_MAPS_URI
, Place.Field.ICON_BACKGROUND_COLOR
, Place.Field.ICON_MASK_URL
, Place.Field.PRIMARY_TYPE_DISPLAY_NAME
, Place.Field.SUB_DESTINATIONS
, Place.Field.UTC_OFFSET
Places Library, Maps JavaScript API : accessibilityOptions
, businessStatus
, displayName
, googleMapsUri
, iconBackgroundColor
, primaryTypeDisplayName
, svgIconMaskURI
, types
, utcOffsetMinutes
iOS : GMSPlacePropertyBusinessStatus
, GMSPlacePropertyIconBackgroundColor
, GMSPlacePropertyIconImageURL
, GMSPlacePropertyUTCOffsetMinutes
, GMSPlacePropertyWheelchairAccessibleEntrance
Web service : accessibilityOptions
, businessStatus
, displayName
, googleMapsUri
, iconBackgroundColor
, iconMaskBaseUri
, primaryType
, primaryTypeDisplayName
, subDestinations
, utcOffsetMinutes
If an Autocomplete session is terminated by a Place Details call that requests any field from the SKU: Place Details (Basic, Advanced, or Preferred) , then the call is billed at SKU: Place Details (Preferred) . For more information, see SKU: Autocomplete Session Usage .
MONTHLY VOLUME RANGE (Price per CALL) | ||
---|---|---|
| | |
0.0170 USD per each (17.00 USD per 1000) | 0.0136 USD per each (13.60 USD per 1000) | Contact Sales for volume pricing |
SKU: Place Details (Advanced)
Using a field mask or field list in your Place Details (New) request, you can limit the response to only those fields specified. This SKU is triggered when you only request the following fields:
Android : Place.Field.CURRENT_OPENING_HOURS
, Place.Field.CURRENT_SECONDARY_OPENING_HOURS
Place.Field.INTERNATIONAL_PHONE_NUMBER
, Place.Field.NATIONAL_PHONE_NUMBER
Place.Field.OPENING_HOURS
, Place.Field.PRICE_LEVEL
, Place.Field.RATING
, Place.Field.SECONDARY_OPENING_HOURS
, Place.Field.USER_RATING_COUNT
Place.Field.WEBSITE_URI
Places Library, Maps JavaScript API : internationalPhoneNumber
, nationalPhoneNumber
, priceLevel
, rating
, regularOpeningHours
, userRatingCount
, websiteUri
iOS : GMSPlacePropertyCurrentOpeningHours
, GMSPlacePropertySecondaryOpeningHours
, GMSPlacePropertyPhoneNumber
, GMSPlacePropertyPriceLevel
, GMSPlacePropertyRating
, GMSPlacePropertyOpeningHours
, GMSPlacePropertyUserRatingsTotal
, GMSPlacePropertyWebsite
Web service : currentOpeningHours
, currentSecondaryOpeningHours
, internationalPhoneNumber
, nationalPhoneNumber
, priceLevel
, rating
, regularOpeningHours
, regularSecondaryOpeningHours
, userRatingCount
, websiteUri
If an Autocomplete session is terminated by a Place Details call that requests any field from the SKU: Place Details (Basic, Advanced, or Preferred) , then the call is billed at SKU: Place Details (Preferred) . For more information, see SKU: Autocomplete Session Usage .
MONTHLY VOLUME RANGE (Price per CALL) | ||
---|---|---|
| | |
0.020 USD per each (20.00 USD per 1000) | 0.016 USD per each (16.00 USD per 1000) | Contact Sales for volume pricing |
SKU: Place Details (Preferred)
Using a field mask or field list in your Place Details (New) request, you can limit the response to only those fields specified. This SKU is triggered when you only request the following fields:
Android : Place.Field.ALLOWS_DOGS
, Place.Field.CURBSIDE_PICKUP
, Place.Field.DELIVERY
, Place.Field.DINE_IN
, Place.Field.EDITORIAL_SUMMARY
, Place.Field.EV_CHARGE_OPTIONS
, Place.Field.FUEL_OPTIONS
, Place.Field.GOOD_FOR_CHILDREN
, Place.Field.GOOD_FOR_GROUPS
, Place.Field.GOOD_FOR_WATCHING_SPORTS
, Place.Field.LIVE_MUSIC
, Place.Field.MENU_FOR_CHILDREN
, Place.Field.OUTDOOR_SEATING
, Place.Field.PARKING_OPTIONS
, Place.Field.PAYMENT_OPTIONS
, Place.Field.RESERVABLE
, Place.Field.RESTROOM
, Place.Field.REVIEWS
, Place.Field.SERVES_BEER
, Place.Field.SERVES_BREAKFAST
, Place.Field.SERVES_BRUNCH
, Place.Field.SERVES_COCKTAILS
, Place.Field.SERVES_COFFEE
, Place.Field.SERVES_DESSERT
, Place.Field.SERVES_DINNER
, Place.Field.SERVES_LUNCH
, Place.Field.SERVES_VEGETARIAN_FOOD
, Place.Field.SERVES_WINE
, Place.Field.TAKEOUT
Places Library, Maps JavaScript API : allowsDogs
, editorialSummary
, evChargeOptions
, fuelOptions
, hasCurbsidePickup
, hasDelivery
, hasDineIn
, hasLiveMusic
, hasMenuForChildren
, hasOutdoorSeating
, hasRestroom
, hasTakeout
, hasWifi
, isGoodForChildren
, isGoodForGroups
, isGoodForWatchingSports
, isReservable
, parkingOptions
, paymentOptions
, priceLevel
, reviews
, servesBeer
, servesBreakfast
, servesBrunch
, servesCocktails
, servesCoffee
, servesDessert
, servesDinner
, servesLunch
, servesVegetarianFood
, servesWine
iOS : GMSPlacePropertyCurbsidePickup
, GMSPlacePropertyDelivery
, GMSPlacePropertyDineIn
, GMSPlacePropertyEditorialSummary
, GMSPlacePropertyReservable
, GMSPlacePropertyReviews
, GMSPlacePropertyServesBeer
, GMSPlacePropertyServesBreakfast
, GMSPlacePropertyServesBrunch
, GMSPlacePropertyServesDinner
, GMSPlacePropertyServesLunch
, GMSPlacePropertyServesVegetarianFood
, GMSPlacePropertyServesWine
, GMSPlacePropertyTakeout
Web service : allowsDogs
, curbsidePickup
, delivery
, dineIn
, editorialSummary
, evChargeOptions
, fuelOptions
, goodForChildren
, goodForGroups
, goodForWatchingSports
, liveMusic
, menuForChildren
, parkingOptions
, paymentOptions
, outdoorSeating
, reservable
, restroom
, reviews
, routingSummaries
, * servesBeer
, servesBreakfast
, servesBrunch
, servesCocktails
, servesCoffee
, servesDessert
, servesDinner
, servesLunch
, servesVegetarianFood
, servesWine
, takeout
* Text Search and Nearby Search only
If an Autocomplete session is terminated by a Place Details call that requests any field from the SKU: Place Details (Basic, Advanced, or Preferred) , then the call is billed at SKU: Place Details (Preferred) . For more information, see SKU: Autocomplete Session Usage .
MONTHLY VOLUME RANGE (Price per CALL) | ||
---|---|---|
| | |
0.025 USD per each (25.00 USD per 1000) | 0.020 USD per each (20.00 USD per 1000) | Contact Sales for volume pricing |
SKU: Nearby Search (Basic)
Using a field mask or field list in your Nearby Search (New) request, you can limit the response to only those fields specified. This SKU is triggered when you only request the following fields:
Android : Place.Field.ADDRESS_COMPONENTS
, Place.Field.BUSINESS_STATUS
, Place.Field.ADDRESS
, Place.Field.ICON_BACKGROUND_COLOR
, Place.Field.ICON_URL
, Place.Field.LAT_LNG
, Place.Field.PHOTO_METADATAS
, Place.Field.PLUS_CODE
, Place.Field.ID
, Place.Field.NAME
, Place.Field.TYPES
, Place.Field.UTC_OFFSET
, Place.Field.VIEWPORT
, Place.Field.WHEELCHAIR_ACCESSIBLE_ENTRANCE
Places Library, Maps JavaScript API : accessibilityOptions
, addressComponents
, adrFormatAddress
, businessStatus
, displayName
, formattedAddress
, googleMapsUri
, iconBackgroundColor
, id
, location
, photos
, plusCode
, svgIconMaskURI
, types
, utcOffsetMinutes
, viewport
iOS : GMSPlacePropertyAddressComponents
, GMSPlacePropertyBusinessStatus
, GMSPlacePropertyCoordinate
, GMSPlacePropertyFormattedAddress
, GMSPlacePropertyName
, GMSPlacePropertyIconBackgroundColor
, GMSPlacePropertyIconImageURL
, GMSPlacePropertyPhotos
, GMSPlacePropertyPlaceID
, GMSPlacePropertyPlusCode
, GMSPlacePropertyTypes
, GMSPlacePropertyUTCOffsetMinutes
, GMSPlacePropertyViewport
, GMSPlacePropertyWheelchairAccessibleEntrance
Web service : places.accessibilityOptions
, 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
, places.primaryType
, places.primaryTypeDisplayName
, places.shortFormattedAddress
, places.subDestinations
, places.types
, places.utcOffsetMinutes
, places.viewport
* The places.name
field contains the place resource name in the form: places/ PLACE_ID
. Use places.displayName
to access the text name of the place.
MONTHLY VOLUME RANGE (Price per CALL) | ||
---|---|---|
| | |
0.032 USD per each (32.00 USD per 1000) | 0.0256 USD per each (25.60 USD per 1000) | Contact Sales for volume pricing |
SKU: Nearby Search (Advanced)
Using a field mask or field list in your Nearby Search (New) request, you can limit the response to only those fields specified. This SKU is triggered when you only request the following fields:
Android : Place.Field.CURRENT_OPENING_HOURS
, Place.Field.CURRENT_SECONDARY_OPENING_HOURS
Place.Field.INTERNATIONAL_PHONE_NUMBER
, Place.Field.NATIONAL_PHONE_NUMBER
Place.Field.OPENING_HOURS
, Place.Field.PRICE_LEVEL
, Place.Field.RATING
, Place.Field.SECONDARY_OPENING_HOURS
, Place.Field.USER_RATING_COUNT
Place.Field.WEBSITE_URI
Places Library, Maps JavaScript API : internationalPhoneNumber
, nationalPhoneNumber
, priceLevel
, rating
, regularOpeningHours
, userRatingCount
, websiteUri
iOS : GMSPlacePropertyCurrentOpeningHours
, GMSPlacePropertySecondaryOpeningHours
, GMSPlacePropertyPhoneNumber
, GMSPlacePropertyPriceLevel
, GMSPlacePropertyRating
, GMSPlacePropertyOpeningHours
, GMSPlacePropertyUserRatingsTotal
, GMSPlacePropertyWebsite
Web service : places.currentOpeningHours
, places.currentSecondaryOpeningHours
, places.internationalPhoneNumber
, places.nationalPhoneNumber
, places.priceLevel
, places.rating
, places.regularOpeningHours
, places.regularSecondaryOpeningHours
, places.userRatingCount
, places.websiteUri
MONTHLY VOLUME RANGE (Price per CALL) | ||
---|---|---|
| | |
0.035 USD per each (35.00 USD per 1000) | 0.028 USD per each (28.00 USD per 1000) | Contact Sales for volume pricing |
SKU: Nearby Search (Preferred)
Using a field mask or field list in your Nearby Search (New) request, you can limit the response to only those fields specified. This SKU is triggered when you only request the following fields:
Android : Place.Field.ALLOWS_DOGS
, Place.Field.CURBSIDE_PICKUP
, Place.Field.DELIVERY
, Place.Field.DINE_IN
, Place.Field.EDITORIAL_SUMMARY
, Place.Field.EV_CHARGE_OPTIONS
, Place.Field.FUEL_OPTIONS
, Place.Field.GOOD_FOR_CHILDREN
, Place.Field.GOOD_FOR_GROUPS
, Place.Field.GOOD_FOR_WATCHING_SPORTS
, Place.Field.LIVE_MUSIC
, Place.Field.MENU_FOR_CHILDREN
, Place.Field.OUTDOOR_SEATING
, Place.Field.PARKING_OPTIONS
, Place.Field.PAYMENT_OPTIONS
, Place.Field.RESERVABLE
, Place.Field.RESTROOM
, Place.Field.REVIEWS
, Place.Field.SERVES_BEER
, Place.Field.SERVES_BREAKFAST
, Place.Field.SERVES_BRUNCH
, Place.Field.SERVES_COCKTAILS
, Place.Field.SERVES_COFFEE
, Place.Field.SERVES_DESSERT
, Place.Field.SERVES_DINNER
, Place.Field.SERVES_LUNCH
, Place.Field.SERVES_VEGETARIAN_FOOD
, Place.Field.SERVES_WINE
, Place.Field.TAKEOUT
Places Library, Maps JavaScript API : allowsDogs
, editorialSummary
, evChargeOptions
, fuelOptions
, hasCurbsidePickup
, hasDelivery
, hasDineIn
, hasLiveMusic
, hasMenuForChildren
, hasOutdoorSeating
, hasRestroom
, hasTakeout
, hasWifi
, isGoodForChildren
, isGoodForGroups
, isGoodForWatchingSports
, isReservable
, parkingOptions
, paymentOptions
, priceLevel
, reviews
, servesBeer
, servesBreakfast
, servesBrunch
, servesCocktails
, servesCoffee
, servesDessert
, servesDinner
, servesLunch
, servesVegetarianFood
, servesWine
iOS : GMSPlacePropertyCurbsidePickup
, GMSPlacePropertyDelivery
, GMSPlacePropertyDineIn
, GMSPlacePropertyEditorialSummary
, GMSPlacePropertyReservable
, GMSPlacePropertyReviews
, GMSPlacePropertyServesBeer
, GMSPlacePropertyServesBreakfast
, GMSPlacePropertyServesBrunch
, GMSPlacePropertyServesDinner
, GMSPlacePropertyServesLunch
, GMSPlacePropertyServesVegetarianFood
, GMSPlacePropertyServesWine
, GMSPlacePropertyTakeout
Web service : 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
, places.restroom
, places.reviews
, places.routingSummaries
, * places.servesBeer
, places.servesBreakfast
, places.servesBrunch
, places.servesCocktails
, places.servesCoffee
, places.servesDessert
, places.servesDinner
, places.servesLunch
, places.servesVegetarianFood
, places.servesWine
, places.takeout
* Text Search and Nearby Search only
MONTHLY VOLUME RANGE (Price per CALL) | ||
---|---|---|
| | |
0.040 USD per each (40.00 USD per 1000) | 0.032 USD per each (32.00 USD per 1000) | Contact Sales for volume pricing |
SKU: Text Search (ID Only)
Using a field mask or field list in your Text Search (New) request, you can limit the response to only those fields specified. This SKU is triggered when you only request the following fields:
Android : Place.Field.DISPLAY_NAME
, Place.Field.ID
, Place.Field.RESOURCE_NAME
iOS : GMSPlacePropertyPlaceID
, GMSPlacePropertyName
Places Library, Maps JavaScript API : id
Web service : places.attributions
, places.id
, places.name
* , nextPageToken
* The places.name
field contains the place resource name in the form: places/ PLACE_ID
. Use places.displayName
to access the text name of the place.
MONTHLY VOLUME RANGE (Price per CALL) | ||
---|---|---|
| | |
0.0 USD per each (0.00 USD per 1000) | 0.0 USD per each (0.00 USD per 1000) | 0.0 USD per each (0.00 USD per 1000) |
SKU: Text Search (Basic)
Using a field mask or field list in your Text Search (New) request, you can limit the response to only those fields specified. This SKU is triggered when you only request the following fields:
Android : Place.Field.ACCESSIBILITY_OPTIONS
, Place.Field.ADDRESS_COMPONENTS
, Place.Field.ADR_FORMAT_ADDRESS
, Place.Field.BUSINESS_STATUS
, Place.Field.FORMATTED_ADDRESS
, Place.Field.GOOGLE_MAPS_URI
, Place.Field.ICON_BACKGROUND_COLOR
, Place.Field.ICON_MASK_URL
, Place.Field.LOCATION
, Place.Field.PHOTO_METADATAS
, Place.Field.PLUS_CODE
, Place.Field.PRIMARY_TYPE_DISPLAY_NAME
, Place.Field.SHORT_FORMATTED_ADDRESS
, Place.Field.SUB_DESTINATIONS
, Place.Field.TYPES
, Place.Field.UTC_OFFSET
, Place.Field.VIEWPORT
iOS : GMSPlacePropertyAddressComponents
, GMSPlacePropertyBusinessStatus
, GMSPlacePropertyFormattedAddress
, GMSPlacePropertyIconBackgroundColor
, GMSPlacePropertyIconImageURL
, GMSPlacePropertyCoordinate
, GMSPlacePropertyPhotos
, GMSPlacePropertyPlusCode
, GMSPlacePropertyTypes
, GMSPlacePropertyUTCOffsetMinutes
, GMSPlacePropertyViewport
, GMSPlacePropertyWheelchairAccessibleEntrance
Places Library, Maps JavaScript API : accessibilityOptions
, addressComponents
, adrFormatAddress
, businessStatus
, displayName
, formattedAddress
, googleMapsUri
, iconBackgroundColor
, location
, photos
, plusCode
, svgIconMaskURI
, types
, utcOffsetMinutes
, viewport
Web service : 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.types
, places.utcOffsetMinutes
, places.viewport
MONTHLY VOLUME RANGE (Price per CALL) | ||
---|---|---|
| | |
0.032 USD per each (32.00 USD per 1000) | 0.0256 USD per each (25.60 USD per 1000) | Contact Sales for volume pricing |
SKU: Text Search (Advanced)
Using a field mask or field list in your Text Search (New) request, you can limit the response to only those fields specified. This SKU is triggered when you only request the following fields:
Android : Place.Field.CURRENT_OPENING_HOURS
, Place.Field.CURRENT_SECONDARY_OPENING_HOURS
Place.Field.INTERNATIONAL_PHONE_NUMBER
, Place.Field.NATIONAL_PHONE_NUMBER
Place.Field.OPENING_HOURS
, Place.Field.PRICE_LEVEL
, Place.Field.RATING
, Place.Field.SECONDARY_OPENING_HOURS
, Place.Field.USER_RATING_COUNT
Place.Field.WEBSITE_URI
iOS : GMSPlacePropertyCurrentOpeningHours
, GMSPlacePropertySecondaryOpeningHours
, GMSPlacePropertyPhoneNumber
, GMSPlacePropertyPriceLevel
, GMSPlacePropertyRating
, GMSPlacePropertyOpeningHours
, GMSPlacePropertyUserRatingsTotal
, GMSPlacePropertyWebsite
Web service : places.currentOpeningHours
, places.currentSecondaryOpeningHours
, places.internationalPhoneNumber
, places.nationalPhoneNumber
, places.priceLevel
, places.rating
, places.regularOpeningHours
, places.regularSecondaryOpeningHours
, places.userRatingCount
, places.websiteUri
Places Library, Maps JavaScript API : internationalPhoneNumber
, nationalPhoneNumber
, priceLevel
, rating
, regularOpeningHours
, userRatingCount
, websiteUri
MONTHLY VOLUME RANGE (Price per CALL) | ||
---|---|---|
| | |
0.035 USD per each (35.00 USD per 1000) | 0.028 USD per each (28.00 USD per 1000) | Contact Sales for volume pricing |
SKU: Text Search (Preferred)
Using a field mask or field list in your Text Search (New) request, you can limit the response to only those fields specified. This SKU is triggered when you only request the following fields:
Android : Place.Field.ALLOWS_DOGS
, Place.Field.CURBSIDE_PICKUP
, Place.Field.DELIVERY
, Place.Field.DINE_IN
, Place.Field.EDITORIAL_SUMMARY
, Place.Field.EV_CHARGE_OPTIONS
, Place.Field.FUEL_OPTIONS
, Place.Field.GOOD_FOR_CHILDREN
, Place.Field.GOOD_FOR_GROUPS
, Place.Field.GOOD_FOR_WATCHING_SPORTS
, Place.Field.LIVE_MUSIC
, Place.Field.MENU_FOR_CHILDREN
, Place.Field.OUTDOOR_SEATING
, Place.Field.PARKING_OPTIONS
, Place.Field.PAYMENT_OPTIONS
, Place.Field.RESERVABLE
, Place.Field.RESTROOM
, Place.Field.REVIEWS
, Place.Field.SERVES_BEER
, Place.Field.SERVES_BREAKFAST
, Place.Field.SERVES_BRUNCH
, Place.Field.SERVES_COCKTAILS
, Place.Field.SERVES_COFFEE
, Place.Field.SERVES_DESSERT
, Place.Field.SERVES_DINNER
, Place.Field.SERVES_LUNCH
, Place.Field.SERVES_VEGETARIAN_FOOD
, Place.Field.SERVES_WINE
, Place.Field.TAKEOUT
iOS : GMSPlacePropertyCurbsidePickup
, GMSPlacePropertyDelivery
, GMSPlacePropertyDineIn
, GMSPlacePropertyEditorialSummary
, GMSPlacePropertyReservable
, GMSPlacePropertyReviews
, GMSPlacePropertyServesBeer
, GMSPlacePropertyServesBreakfast
, GMSPlacePropertyServesBrunch
, GMSPlacePropertyServesDinner
, GMSPlacePropertyServesLunch
, GMSPlacePropertyServesVegetarianFood
, GMSPlacePropertyServesWine
, GMSPlacePropertyTakeout
Places Library, Maps JavaScript API : allowsDogs
, editorialSummary
, evChargeOptions
, fuelOptions
, hasCurbsidePickup
, hasDelivery
, hasDineIn
, hasLiveMusic
, hasMenuForChildren
, hasOutdoorSeating
, hasRestroom
, hasTakeout
, hasWifi
, isGoodForChildren
, isGoodForGroups
, isGoodForWatchingSports
, isReservable
, parkingOptions
, paymentOptions
, priceLevel
, reviews
, servesBeer
, servesBreakfast
, servesBrunch
, servesCocktails
, servesCoffee
, servesDessert
, servesDinner
, servesLunch
, servesVegetarianFood
, servesWine
Web service : 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
, places.restroom
, places.reviews
, places.routingSummaries
, * places.servesBeer
, places.servesBreakfast
, places.servesBrunch
, places.servesCocktails
, places.servesCoffee
, places.servesDessert
, places.servesDinner
, places.servesLunch
, places.servesVegetarianFood
, places.servesWine
, places.takeout
* Text Search and Nearby Search only
MONTHLY VOLUME RANGE (Price per CALL) | ||
---|---|---|
| | |
0.040 USD per each (40.00 USD per 1000) | 0.032 USD per each (32.00 USD per 1000) | Contact Sales for volume pricing |
SKU: Place Photo
A Place Photo SKU is charged for each request to the API.
MONTHLY VOLUME RANGE (Price per CALL) | ||
---|---|---|
| | |
0.007 USD per each (7.00 USD per 1000) | 0.0056 USD per each (5.60 USD per 1000) | Contact Sales for volume pricing |
Places product SKUs
APIs in Places include Places API , Places SDK for Android ; Places SDK for iOS ; Places Library, Maps JavaScript API ; Geocoding API ; Geolocation API ; Time Zone API ; and Elevation API .
About Autocomplete sessions
An Autocomplete session includes some Autocomplete requests (to retrieve suggestions on a place as the user types), and at most one Places Details request (to retrieve details about the place selected by the user). The same session token is passed to the Autocomplete and the subsequent Place Detail request. A session starts with the first Autocomplete request (which typically happens when the user starts typing). A Places Details call is made when the user has selected one of the Autocomplete suggestions. If a user does not select a suggestion, no Places Details call is made.
After a user has selected a place (ie, a Places Details call is made), you must start a new session using a new session token.
Autocomplete sessions can be generated from the following APIs:
- The Places API Place Autocomplete service or the Maps JavaScript API's Places Autocomplete service . You need to design your application to provide session tokens (you may need to change your existing code).
- The Maps JavaScript API's Autocomplete widget . Session-based billing is automatically enabled on those widgets, without any code change required.
A session token is good for one user session and should not be used for more than one user session. If you reuse a session token, the session is considered invalid and the requests are charged as if no session token was provided.
The Autocomplete requests and the Places Details requests using sessions are billed on different SKUs.
About Places Data SKUs
The three Places Data SKUs are: Basic Data , Contact Data , and Atmosphere Data .One or more Data SKUs are triggered for:
- Android: each request to
fetchPlace()
orfindCurrentPlace()
- iOS: each call to
fetchPlaceFromPlaceID:
orfindPlaceLikelihoodsFromCurrentLocationWithPlaceFields:
- Web service: each Places request depending on the fields specified in the request
Data SKUs are always charged in addition to the base SKU for the request triggering them. For example, a Place Details request including Basic Data fields will be charged both under the Basic Data SKU and the Place Details SKU.
For the web service, these Places APIs calls support specifying the data fields to return:
For the web service, these Places APIs calls DO NOT support specifying the returned fields. These calls always return all the Places data, charging the three Places Data SKUs in addition to the charge for each API request:
SKU: Basic Data
Using the fields parameter in your Place Details or Find Place request, you can limit the response to only those fields specified. Fields in the Basic category are included in the base cost of the Places request and do not result in any additional charge. The Basic Data SKU is triggered when any of these fields are requested:
- Android:
Place.Field.ACCESSIBILITY_OPTIONS
,Place.Field.ADDRESS_COMPONENTS
,Place.Field.BUSINESS_STATUS
,Place.Field.DISPLAY_NAME
,Place.Field.FORMATTED_ADDRESS
,Place.Field.ICON_BACKGROUND_COLOR
,Place.Field.ICON_MASK_URL
,Place.Field.ID
,Place.Field.LOCATION
,Place.Field.PHOTO_METADATAS
,Place.Field.PLUS_CODE
,Place.Field.TYPES
,Place.Field.VIEWPORT
, orPlace.Field.UTC_OFFSET
. - iOS:
GMSPlaceFieldFormattedAddress
,GMSPlaceFieldBusinessStatus
,GMSPlaceFieldID
,GMSPlaceFieldCoordinate
,GMSPlaceFieldName
,GMSPlaceFieldPhotos
,GMSPlaceFieldPlusCode
,GMSPlaceFieldTypes
, orGMSPlaceFieldViewport
- Web service:
address_component
,adr_address
,business_status
,formatted_address
,geometry
,icon
,name
,permanently_closed
,photo
,place_id
,plus_code
,type
,url
,utc_offset
,vicinity
, orwheelchair_accessible_entrance
MONTHLY VOLUME RANGE (Price per CALL) | ||
---|---|---|
| | |
Places request cost + 0.00 USD | Places request cost + 0.00 USD | Places request cost + 0.00 USD |
SKU: Contact Data
Using the fields parameter in your Place Details or Find Place request for web services, or an array of Place.Field
s for Android or iOS, you can limit the response to only those fields specified. Fields in the Contact category result in an additional charge. The Contact Data SKU is triggered when any of these fields are requested:
- Android:
Place.Field.CURRENT_OPENING_HOURS
,Place.Field.INTERNATIONAL_PHONE_NUMBER
,Place.Field.OPENING_HOURS
,Place.Field.SECONDARY_OPENING_HOURS
, orPlace.Field.WEBSITE_URI
- iOS:
GMSPlaceFieldOpeningHours
,GMSPlaceFieldPhoneNumber
, orGMSPlaceFieldWebsite
- Web service:
formatted_phone_number
,international_phone_number
,opening_hours
,current_opening_hours
,secondary_opening_hours
, orwebsite
MONTHLY VOLUME RANGE (Price per CALL) | ||
---|---|---|
| | |
Places request cost + 0.003 USD per each (+ 3.00 USD per 1000) | Places request cost + 0.0024 USD per each (+ 2.40 USD per 1000) | Contact Sales for volume pricing |
SKU: Atmosphere Data
Using the fields parameter in your Place Details or Find Place request, you can limit the response to only those fields specified. Fields in the Atmosphere category result in an additional charge. The Atmosphere Data SKU is triggered when any of these fields are requested:
- 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
, orPlace.Field.USER_RATING_COUNT
- iOS:
GMSPlaceFieldPriceLevel
,GMSPlaceFieldRating
,GMSPlaceFieldUserRatingsTotal
,GMSPlaceFieldTakeout
,GMSPlaceFieldDelivery
,GMSPlaceFieldDineIn
,GMSPlaceFieldCurbsidePickup
,GMSPlaceFieldReservable
,GMSPlaceFieldServesBreakfast
,GMSPlaceFieldServesLunch
,GMSPlaceFieldServesDinner
,GMSPlaceFieldServesBeer
,GMSPlaceFieldServesWine
,GMSPlaceFieldServesBrunch
orGMSPlaceFieldServesVegetarianFood
. - JavaScript : See Fields (Place details)
- Web service :
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
, oruser_ratings_total
.
MONTHLY VOLUME RANGE (Price per CALL) | ||
---|---|---|
| | |
Places request cost + 0.005 USD per each (+ 5.00 USD per 1000) | Places request cost + 0.004 USD per each (+ 4.00 USD per 1000) | Contact Sales for volume pricing |
SKU: Autocomplete – Per Request
The Autocomplete – Per Request SKU is charged for any of these calls or requests that do not include a session token:
- Android:
findAutocompletePredictions()
- iOS:
findAutocompletePredictionsFromQuery:
- JavaScript: the Maps JavaScript API's Place Autocomplete service
- Web service: the Places API Place Autocomplete service
Calls made from an invalid Autocomplete session (for example, a session that reuses a session token) are also charged an Autocomplete – Per Request SKU.
Autocomplete requests from the Maps JavaScript API's Place Autocomplete Widget may be charged an Autocomplete – Per Request SKU in case calls are made from an invalid Autocomplete session. This may happen when a user is typing multiple different addresses or copy/pasting different addresses into the widget and not always selects an autocomplete prediction.
MONTHLY VOLUME RANGE (Price per REQUEST) | ||
---|---|---|
| | |
0.00283 USD per each (2.83 USD per 1000) | 0.00227 USD per each (2.27 USD per 1000) | Contact Sales for volume pricing |
SKU: Autocomplete without Place Details – Per Session
The Autocomplete without Place Details – Per Session SKU is charged for an Autocomplete session that does not include a Place Details request (within a few minutes of the beginning of the session).
MONTHLY VOLUME RANGE (Price per SESSION) | ||
---|---|---|
| | |
0.017 USD per each (17.00 USD per 1000) | 0.0136 USD per each (13.60 USD per 1000) | Contact Sales for volume pricing |
مثال
If your application issues these two calls in a single session:
اندروید
- findAutocompletePredictions() (.setQuery(”par”), .setSessionToken(XYZ))
- findAutocompletePredictions() (.setQuery(”paris”), .setSessionToken(XYZ))
iOS
- placesClient?.findAutocompletePredictions(fromQuery: "par" ...
- placesClient?.findAutocompletePredictions(fromQuery: "paris" ...
وب سرویس
- Place Autocomplete Request (input=”par”, session_token: XYZ)
- Place Autocomplete Request (input=”paris”, session_token: XYZ)
On your bill, you will see this SKU listed (when viewing your bill by SKU ):
- Autocomplete without Place Details – Per Session (price starting at 0.017 USD per session)
SKU: Autocomplete (included with Place Details) – Per Session
The Autocomplete (included with Place Details) – Per Session SKU is charged for an Autocomplete session that includes any of:
- Android: a call to
fetchPlace()
- iOS: a call to
fetchPlaceFromPlaceID:
- Web service: a Place Details request
The autocomplete request is available at no charge, and the subsequent Place Details call gets charged based on regular Place Details pricing .
A Place Details request generates Data SKUs ( Basic , Contact , and/or Atmosphere ) – depending on the fields that are specified in the request.
If you do not specify fields in the Place Details request, all Data SKUs are triggered (Basic, Contact, and Atmosphere).
Place Details ID refresh requests (requests that specify only the place_id
field) during an autocomplete session are billed as SKU: Autocomplete without Place Details – Per Session .
MONTHLY VOLUME RANGE (Price per SESSION) | ||
---|---|---|
| | |
0.00 USD | 0.00 USD | 0.00 USD |
مثال
If your application issues the following three calls in a single session:
اندروید
- findAutocompletePredictions() (.setQuery(”par”), .setSessionToken(XYZ))
- findAutocompletePredictions() (.setQuery(”paris”), .setSessionToken(XYZ))
- fetchPlace() (with a
FetchPlaceRequest
including the Place ID, and the ADDRESS field)
iOS
- placesClient?.findAutocompletePredictions(fromQuery: "par" ...
- placesClient?.findAutocompletePredictions(fromQuery: "paris" ...
- fetchPlaceFromPlaceID: (including the Place ID, and the
GMSPlaceFieldFormattedAddress
field)
وب سرویس
- Places Autocomplete Request (input=”par”, session_token: XYZ)
- Places Autocomplete Request (input=”paris”, session_token: XYZ)
- Places Details (place_id, session_token: XYZ, fields:formatted_address)
On your bill, you will see these SKUs listed (when viewing your bill by SKU ):
- Autocomplete (included with Place Details) – Per Session (billed at 0.00 USD)
- Place Details (price starting at 0.017 USD per session)
- Basic Data (billed at 0.00 USD)
SKU: Query Autocomplete – Per Request
A Query Autocomplete – Per Request SKU is charged for each request to:
- JavaScript: the Maps JavaScript API's Places Autocomplete Service (
getQueryPredictions()
) and the use of the Maps JavaScript API's SearchBox widget (Query Autocomplete requests are generated as the user types). - Web service: the Places API Query Autocomplete service
MONTHLY VOLUME RANGE (Price per REQUEST) | ||
---|---|---|
| | |
0.00283 USD per each (2.83 USD per 1000) | 0.00227 USD per each (2.27 USD per 1000) | Contact Sales for volume pricing |
Pricing by Autocomplete session is not supported using Query Autocomplete. Subsequent Places Details calls get charged based on regular Places Details pricing .
SKU: Place Details
Place Details calls are charged as follows:
MONTHLY VOLUME RANGE (Price per CALL) | ||
---|---|---|
| | |
0.017 USD per each (17.00 USD per 1000) | 0.0136 USD per each (13.60 USD per 1000) | Contact Sales for volume pricing |
The Place Details SKU is generated from these APIs:
- Android: Places SDK for Android (
fetchPlace()
) - iOS: Places SDK for iOS (
fetchPlaceFromPlaceID:
) - JavaScript: Maps JavaScript API's Place Details service (
getDetails
) - JavaScript: Maps JavaScript API's Place Autocomplete widget (
getPlace
) - JavaScript: Maps JavaScript API's Place SearchBox widget :
getPlaces()
method after the user selects a place result (icon: pin), *not* a query (icon: magnifier), as illustrated here: - Web service: Places API Place Details service
With the web API and services, the Place Details SKU is charged whether a session token is provided or not.
A Place Details call or request also generates Data SKUs ( Basic , Contact , and/or Atmosphere ), depending on the fields that are specified in the call or request. If NO fields are specified in the Place Details call or request, ALL Data SKUs are triggered, and you are charged for the Places Details call or request plus the cost of all the data.
نمونه ها
- Make one of these calls or requests:
- Mobile: call
fetchPlace()
on Android orfetchPlaceFromPlaceID:
on iOS, and specify just theADDRESS
field - Web API or service: make a Place Details request and specify just the address field:
getPlaceDetails(fields: formatted_address)
- Place Details (price starting at 0.017 USD per session)
- Basic Data (billed at 0.00 USD)
- Mobile: call
- Make one of these calls or requests:
- Mobile: call
fetchPlace()
on Android orfetchPlaceFromPlaceID:
on iOS, and specify just thePHONE_NUMBER
field - Web API or service: make a Place Details request and specify the phone number field:
getPlaceDetails(fields: formatted_phone_number)
- Place Details (price starting at 0.017 USD per session)
- Contact Data (price starting at 0.003 USD per request)
- Mobile: call
- Make one of these calls or requests:
- Mobile: call
fetchPlace()
on Android orfetchPlaceFromPlaceID:
on iOS, and specify all the fields - Web API or service: make a Place Details request and specify all the fields (this type of request is the default if you do not specify any fields):
getPlaceDetails()
.
- Place Details (price starting at 0.017 USD per session)
- Basic Data (billed at 0.00 USD)
- Contact Data (price starting at 0.003 USD per request)
- Atmosphere Data (price starting at 0.005 USD per request)
- Mobile: call
SKU: Place Details – ID Refresh
Use the Place Details request to refresh stale place IDs . These types of requests are available at no charge.
MONTHLY VOLUME RANGE (Price per CALL) | ||
---|---|---|
| | |
0.00 USD | 0.00 USD | 0.00 USD |
مثال
Make a Place Details request specifying just the place id field: getPlaceDetails(fields: place_id)
. On your bill, you will see this SKU listed (when viewing your bill by SKU ):
- Place Details – ID Refresh (billed at 0.00 USD)
SKU: Find Place
Find Place is charged for a Find Place request.
MONTHLY VOLUME RANGE (Price per CALL) | ||
---|---|---|
| | |
0.017 USD per each (17.00 USD per 1000) | 0.0136 USD per each (13.60 USD per 1000) | Contact Sales for volume pricing |
Find Place requests also generate Data SKUs ( Basic , Contact , and/or Atmosphere ), depending on the fields that are specified in the request. Like Place Details requests, you can use the fields parameter in your Find Place request to limit the response to only those fields specified. You are billed for the Find Place request as well as the data requested. By default, if NO fields are requested, only the place id is returned, so no additional data charges are incurred.
نمونه ها
- You make a Find Place request and specify just the address field:
FindPlace(fields: formatted_address)
. On your bill, you will see these SKUs listed (when viewing your bill by SKU ):- Find Place (price starting at 0.017 USD per call)
- Basic Data (billed at 0.00 USD)
- You make a Find Place request and specify the phone number field:
FindPlace(fields: formatted_phone_number)
. On your bill, you will see these SKUs listed (when viewing your bill by SKU ):- Find Place (price starting at 0.017 USD per call)
- Contact Data (price starting at 0.003 USD per request)
- You make a Find Place request and specify fields from all three data-type buckets:
FindPlace(fields: formatted_address, opening_hours, price_level)
. On your bill, you will see these SKUs listed (when viewing your bill by SKU ):- Find Place (price starting at 0.017 USD per call)
- Basic Data (billed at 0.00 USD)
- Contact Data (price starting at 0.003 USD per request)
- Atmosphere Data (price starting at 0.005 USD per request)
SKU: Find Place – ID only
Find Place – ID only is charged for Find Place requests that only specify the Place ID to be returned. By default, if no fields are specified in the Find Place request, only the place id is returned.
MONTHLY VOLUME RANGE (Price per CALL) | ||
---|---|---|
| | |
0.00 USD | 0.00 USD | 0.00 USD |
مثال
You make a Find Place request and only specify the place_id
field: FindPlace(fields: place_id)
. On your bill, you will see this SKU listed (when viewing your bill by SKU ):
- Find Place – ID only (billed at 0.00 USD)
SKU: Find Current Place
Find Current Place is charged for calls to findCurrentPlace()
(Android) or findPlaceLikelihoodsFromCurrentLocationWithPlaceFields:
(iOS).
MONTHLY VOLUME RANGE (Price per CALL) | ||
---|---|---|
| | |
0.030 USD per each (30.00 USD per 1000) | 0.024 USD per each (24.00 USD per 1000) | Contact Sales for volume pricing |
Calls to findCurrentPlace()
(Android) or findPlaceLikelihoodsFromCurrentLocationWithPlaceFields:
(iOS) also generate Data SKUs ( Basic , Contact , and/or Atmosphere ), depending on the fields that are specified in the call. Specify data fields to limit the response to only those fields. You are billed for the Find Current Place call as well as the data requested.
نمونه ها
- You call
findCurrentPlace()
(Android) orfindPlaceLikelihoodsFromCurrentLocationWithPlaceFields:
(iOS) and specify just theADDRESS
field. On your bill, you will see these SKUs listed (when viewing your bill by SKU ):- Find Current Place (price starting at 0.030 USD per request)
- Basic Data (billed at 0.00 USD)
- You call
findCurrentPlace()
(Android) orfindPlaceLikelihoodsFromCurrentLocationWithPlaceFields:
(iOS) and specify thePHONE_NUMBER
field. On your bill, you will see these SKUs listed (when viewing your bill by SKU ):- Find Current Place (price starting at 0.030 USD per request)
- Contact Data (price starting at 0.003 USD per request)
- You call
findCurrentPlace()
(Android) orfindPlaceLikelihoodsFromCurrentLocationWithPlaceFields:
(iOS) and specify fields from all three data-type buckets. On your bill, you will see these SKUs listed (when viewing your bill by SKU ):- Find Current Place (price starting at 0.030 USD per request)
- Basic Data (billed at 0.00 USD)
- Contact Data (price starting at 0.003 USD per request)
- Atmosphere Data (price starting at 0.005 USD per request)
SKU: Place – Nearby Search
Place – Nearby Search is charged for requests to the Maps JavaScript API's Place Nearby Search service ( nearbySearch()
), or to the Places API Nearby Search service
MONTHLY VOLUME RANGE (Price per CALL) | ||
---|---|---|
| | |
0.032 USD per each (32.00 USD per 1000) | 0.0256 USD per each (25.60 USD per 1000) | Contact Sales for volume pricing |
Nearby Search requests return a list of places, but do not support specifying which fields are returned. Nearby Search requests return a subset of the supported data fields . You are charged for the Nearby Search request starting at 0.032 USD per each, as well as all of the data-type SKUs ( Basic Data , Contact Data , and Atmosphere Data ).
مثال
You make a Nearby Search request, such as NearbySearch (San Francisco, 100 meters)
. On your bill, you will see these SKUs listed (when viewing your bill by SKU ):
- Place - Nearby Search (price starting at 0.032 USD per call)
- Basic Data (billed at 0.00 USD)
- Contact Data (price starting at 0.003 USD per request)
- Atmosphere Data (price starting at 0.005 USD per request)
SKU: Place – Text Search
Place – Text Search is charged for requests to the Maps JavaScript API's Place Text Search service ( textSearch()
), or to the Places API Text Search service .
MONTHLY VOLUME RANGE (Price per CALL) | ||
---|---|---|
| | |
0.032 USD per each (32.00 USD per 1000) | 0.0256 USD per each (25.60 USD per 1000) | Contact Sales for volume pricing |
Text Search requests return a list of places, but do not support specifying which fields are returned. Text Search requests return a subset of the supported data fields . You are charged for the Text Search request starting at 0.032 USD per each, as well as all of the data-type SKUs ( Basic Data , Contact Data , and Atmosphere Data ).
The Place – Text Search SKU is also generated by the Maps JavaScript API's Place SearchBox widget : getPlaces()
method after the user selects a place query (icon: magnifier), not a result (icon: pin), as illustrated here:
مثال
You make a Text Search request, such as TextSearch(123 Main Street)
. On your bill, you will see these SKUs listed (when viewing your bill by SKU ):
- Place - Text Search (price starting at 0.032 USD per call)
- Basic Data (billed at 0.00 USD)
- Contact Data (price starting at 0.003 USD per request)
- Atmosphere Data (price starting at 0.005 USD per request)
SKU: Place Photo
A Place Photo SKU is charged for:
- Android: calls to
fetchPhoto()
- iOS: calls to
loadPlacePhoto:
- JavaScript: to Places Library, Maps JavaScript API's Place Photos service when requesting data from the URLs returned by
PlacePhoto.getUrl()
to load image pixel data - Web service: requests to the Places API Place Photos service
For the JavaScript service, invoking the PlacePhoto.getUrl()
method does not cause billing until the URL is actually used to obtain pixel data.
MONTHLY VOLUME RANGE (Price per CALL) | ||
---|---|---|
| | |
0.007 USD per each (7.00 USD per 1000) | 0.0056 USD per each (5.60 USD per 1000) | Contact Sales for volume pricing |
SKU: Geocoding
A Geocoding SKU is charged for requests to the Maps JavaScript API's Geocoding service or to the Geocoding API . In JavaScript , the method Geocoder.geocode()
initiates the request to the Geocoding Service.
MONTHLY VOLUME RANGE (Price per REQUEST) | ||
---|---|---|
| | |
0.005 USD per each (5.00 USD per 1000) | 0.004 USD per each (4.00 USD per 1000) | Contact Sales for volume pricing |
SKU: Geolocation
A Geolocation SKU is charged for requests to the Geolocation API .
MONTHLY VOLUME RANGE (Price per REQUEST) | ||
---|---|---|
| | |
0.005 USD per each (5.00 USD per 1000) | 0.004 USD per each (4.00 USD per 1000) | Contact Sales for volume pricing |
SKU: Map Tiles API: 2D Map Tiles
A request to Map Tiles API retrieving Roadmap , Satellite , or Terrain Tiles. Note that Session Token and Viewport information requests aren't billed.
MONTHLY VOLUME RANGE (Price per REQUEST) | |||||
---|---|---|---|---|---|
0 - 1,000,000 | 1,000,001 - 5,000,000 | 5,000,001+ | |||
0.0006 USD per each (0.60 USD per 1000) | 0.00048 USD per each (0.48 USD per 1000) | Contact Sales for volume pricing |
SKU: Map Tiles API: Street View Tiles
A request to Map Tiles API retrieving Street View Tiles, Street View Thumbnails, or Street View PanoIDs. Note that Session Token and Street View Metadata requests aren't billed.
MONTHLY VOLUME RANGE (Price per REQUEST) | |||||
---|---|---|---|---|---|
0 - 1,000,000 | 1,000,001 - 5,000,000 | 5,000,001+ | |||
0.002 USD per each (2.00 USD per 1000) | 0.0016 USD per each (1.60 USD per 1000) | Contact Sales for volume pricing |
SKU: Map Tiles API: Photorealistic 3D Tiles
A request to Map Tiles API retrieving 3D Root Tiles.
MONTHLY VOLUME RANGE (Price per REQUEST) | |||||
---|---|---|---|---|---|
| | | |||
0.006 USD per each (6.00 USD per 1000) | 0.0051 USD per each (5.10 USD per 1000) | Contact Sales for volume pricing |
SKU: Time Zone
A Time Zone SKU is charged for requests to the Time Zone API .
MONTHLY VOLUME RANGE (Price per REQUEST) | ||
---|---|---|
| | |
0.005 USD per each (5.00 USD per 1000) | 0.004 USD per each (4.00 USD per 1000) | Contact Sales for volume pricing |
SKU: Elevation
An Elevation SKU is charged for requests to the Maps JavaScript API ’s Elevation service or to the Elevation API .
MONTHLY VOLUME RANGE (Price per REQUEST) | ||
---|---|---|
| | |
0.005 USD per each (5.00 USD per 1000) | 0.004 USD per each (4.00 USD per 1000) | Contact Sales for volume pricing |
SKU: Address Validation
A request to the validateAddress method (REST) and ValidateAddress method (gRPC) of the Address Validation API .
MONTHLY VOLUME RANGE (Price per REQUEST) | ||
---|---|---|
| | |
0.017 USD per each (17.00 USD per 1000) | 0.0136 USD per each (13.60 USD per 1000) | Contact Sales for volume pricing |
SKU: Address Validation Preferred
Address Validation Preferred works with the Autocomplete (New) endpoint of the Places API when you use it with sessions that terminate with a call to the Address Validation API. Specifically, sessions that use Autocomplete (New) and terminate in either a request to validateAddress (REST) or ValidateAddress (gRPC) fall under this pricing model.
For details about both pricing and using Autocomplete (New) sessions with Places API, see the following guides in the Places API documentation:
When using Address Validation Preferred at the end of an Autocomplete (New) session, you are billed as follows:
MONTHLY VOLUME RANGE (Price per REQUEST) | ||
---|---|---|
| | |
0.025 USD per each (25.00 USD per 1000) | 0.020 USD per each (20.00 USD per 1000) | Contact Sales for volume pricing |
Environment product SKUs
APIs in Environment include: Air Quality API , Pollen API , and Solar API .
SKU: Air Quality
This SKU applies for the following endpoints and methods:
MONTHLY VOLUME RANGE (Price per REQUEST) | |||||
---|---|---|---|---|---|
| | | |||
0.005 USD per each (5.00 USD per 1000) | 0.004 USD per each (4.00 USD per 1000) | Contact Sales for volume pricing |
SKU: Pollen
This SKU applies for the following endpoints/methods:
MONTHLY VOLUME RANGE (Price per REQUEST) | |||||
---|---|---|---|---|---|
| | | |||
0.01 USD per each (10.00 USD per 1000) | 0.008 USD per each (8.00 USD per 1000) | Contact Sales for volume pricing |
SKU: Solar Building Insights
A request to buildingInsights .
MONTHLY VOLUME RANGE (Price per REQUEST) | |||||
---|---|---|---|---|---|
| | | |||
0.01 USD per each (10.00 USD per 1000) | 0.005 USD per each (5.00 USD per 1000) | Contact Sales for volume pricing |
SKU: Solar Data Layers
A request to dataLayers .
Accessing multiple imagery URLs from the same request does not generate additional charged queries. MONTHLY VOLUME RANGE (Price per REQUEST) | |||||
---|---|---|---|---|---|
| | | |||
0.075 USD per each (75.00 USD per 1000) | 0.0375 USD per each (37.50 USD per 1000) | Contact Sales for volume pricing |
Navigation SKU
Navigation SDKs include: Navigation SDK for Android and Navigation SDK for iOS .
SKU: Navigation Request
Each destination requested using the Navigation SDK is billed as a Navigation Request SKU unit. The price per SKU unit is determined by your total monthly call volume for the SKU:
MONTHLY VOLUME RANGE (Price per destination) | ||
---|---|---|
1–1,000 | 1,001–4,200,000 | 4,200,000+ |
بدون هزینه | 0.05 USD | 0.0395 USD |
Route request methods
Route generation requests to the Navigation SDK can be made by calling the following methods:
اندروید
- setDestination (Waypoint destination)
- setDestination (Waypoint destination, RoutingOptions options)
- setDestination (Waypoint destination, RoutingOptions routingOptions, DisplayOptions displayOptions)
- setDestinations (List<Waypoint> destinations)
- setDestinations (List<Waypoint> destinations, RoutingOptions options)
- setDestinations (List<Waypoint> destinations, CustomRoutesOptions customRoutesOptions)
- setDestinations (List<Waypoint> destinations, RoutingOptions routingOptions, DisplayOptions displayOptions)
- setDestinations (List<Waypoint> destinations, CustomRoutesOptions customRoutesOptions, DisplayOptions displayOptions)
- simulateLocationsAlongNewRoute(List<Waypoint> waypoints)
- simulateLocationsAlongNewRoute(List<Waypoint> waypoints, RoutingOptions routingOptions)
- simulateLocationsAlongNewRoute(List<Waypoint> waypoints, RoutingOptions routingOptions, SimulationOptions simulationOptions)
- [Deprecated] setDestinations (List<Waypoint> destinations, String routeToken)
iOS
Keep in mind that a single method call can contain up to 25 destinations, and the cost for each call is calculated by multiplying the number of destinations by the price per SKU unit .