جزئیات شناسه محصول «مکان‌ها و مسیرهای قدیمی»

این صفحه جزئیات SKU، شناسه‌های SKU، رویدادهای قابل‌صورت‌حساب، و راه‌اندازهای صورت‌حساب را برای SKUهای Legacy Places API،‏ Legacy Directions API، و Legacy Distance Matrix API ارائه می‌دهد. برای نسخه‌های فعلی این سرویس‌ها، جزئیات شناسه کالا برای «مکان‌ها (جدید)» و جزئیات شناسه کالا برای «مسیرها و ناوبری» را ببینید. برای مشاهده فهرست همه دسته‌های محصول، به نمای کلی جزئیات استفاده از API مراجعه کنید.

درباره جدول‌های SKU

بخش‌های زیر جزئیات هر SKU را شرح می‌دهد:

دسته اینکه آیا واحد نگهداری موجودی در دسته Essentials،‏ Pro، یا Enterprise قرار می‌گیرد یا نه.
رویداد صورتحساب‌پذیر چه رویدادی برای SKU صورت‌حساب می‌شود.
راه‌اندازها کدام عناصر کد رویدادهای صورتحساب‌پذیر را راه‌اندازی می‌کنند.
قیمت‌گذاری پیوند به جدول قیمت‌گذاری برای گروه آن SKU.

SKU محصول Places قدیمی

برای جدیدترین نسخه‌ها، شناسه‌های محصول Places (New) را ببینید.

درباره شناسه‌های انبارش داده‌های Places

سه شناسه محصول داده‌های مکان‌ها عبارتند از: داده‌های پایه، داده‌های تماس، و داده‌های جو.

یک یا چند شناسه انبارش داده برای این موارد راه‌اندازی شده است:

  • Android: هر درخواست به fetchPlace() یا findCurrentPlace()
  • iOS: هر تماس با fetchPlaceFromPlaceID: یا findPlaceLikelihoodsFromCurrentLocationWithPlaceFields:
  • سرویس وب: هر درخواست «اماکن» بسته به فیلدهای مشخص‌شده در درخواست

هزینه SKU داده همیشه علاوه‌بر SKU پایه برای درخواست راه‌اندازی آن‌ها دریافت می‌شود. برای مثال، درخواست «جزئیات جا» که شامل فیلدهای «داده‌های پایه» باشد، هم تحت شناسه محصول «داده‌های پایه» و هم شناسه محصول «جزئیات جا» هزینه خواهد داشت.

برای سرویس وب، این درخواست‌های Places API به شما امکان می‌دهد فیلدهای داده را برای برگرداندن مشخص کنید:

برای سرویس وب، این فراخوانی‌های Places API از مشخص کردن فیلدهای برگردانده‌شده پشتیبانی نمی‌کنند. این فراخوانی‌ها همیشه همه داده‌های «اماکن» را برمی‌گردانند و علاوه‌بر هزینه هر درخواست API، هزینه سه شناسه محصول داده‌های «اماکن» را نیز دریافت می‌کنند:

[ Essentials: Places Legacy ]

SKU: Autocomplete – Per Request

  دسته Essentials
  شناسه SKU

7384-2DE4-D388 (جهانی)

2164-BC00-53DC (هند)

  میاناهای برنامه‌سازی کاربردی تکمیل خودکار جا (قدیمی) Android،
تکمیل خودکار جا (قدیمی) iOS،
تکمیل خودکار جا (قدیمی) وب
  رویداد صورتحساب‌پذیر درخواستی که حاوی کد جلسه نیست
  راه‌اندازها
  نمونه‌ها

اگر درخواستی از یک جلسه «تکمیل خودکار» نامعتبر (برای مثال، جلسه‌ای که از کد جلسه مجدداً استفاده می‌کند) ارسال کنید، هزینه «تکمیل خودکار» – «واحد نگهداری موجودی» (SKU) به‌ازای هر درخواست نیز از شما کسر می‌شود.

وقتی از جلسه «تکمیل خودکار» نامعتبر درخواست ارسال می‌کنید، ممکن است برای درخواست‌های «تکمیل خودکار» از ابزاره «تکمیل خودکار جا» در Maps JavaScript API، هزینه «تکمیل خودکار – به‌ازای هر شناسه محصول درخواستی» دریافت شود. این وضعیت ممکن است زمانی اتفاق بیفتد که کاربر درحال تایپ کردن یا کپی/جای‌گذاری چندین نشانی مختلف در ابزاره است و همیشه پیش‌بینی تکمیل خودکار را انتخاب نمی‌کند.

  قیمت‌گذاری فهرست قیمت (جهانی)
فهرست قیمت (هند)

SKU: تکمیل خودکار (شامل جزئیات جا) – در هر جلسه

  دسته Essentials
  شناسه SKU

E9C9-934B-DDB1 (جهانی)

  میاناهای برنامه‌سازی کاربردی تکمیل خودکار جا (قدیمی) Android،
تکمیل خودکار جا (قدیمی) iOS،
تکمیل خودکار جا (قدیمی) وب
  رویداد صورتحساب‌پذیر جلسه
  راه‌اندازها
  • Android: تماس با fetchPlace()
  • iOS: تماس با fetchPlaceFromPlaceID:
  • سرویس وب: درخواست «جزئیات جا»

فیلدهای موجود در درخواست:

حتماً فیلدهای موردنیازتان را در درخواست مشخص کنید تا از هزینه‌های غیرضروری جلوگیری شود. بسته به فیلدهایی که مشخص می‌کنید، درخواست «جزئیات جا» این «شناسه‌های یکتای کالا» را نیز تولید می‌کند:

اگر در درخواست «جزئیات جا» فیلدها را مشخص نکنید، همه «شناسه‌های یکتای کالا» داده فعال می‌شوند.

اگر درطول جلسه تکمیل خودکار فقط بازآوری شناسه «جزئیات جا» را درخواست کنید (درخواست شما فقط فیلد place_id را مشخص می‌کند)، جلسه به‌عنوان واحد نگهداری موجودی: تکمیل خودکار بدون جزئیات جا – به‌ازای هر جلسه صورت‌حساب می‌شود.

  نمونه‌ها

درخواست‌های تکمیل خودکار بدون هزینه دردسترس است. این شناسه کالای قدیمی وقتی صورت‌حساب صادر می‌کند که «جزئیات مکان» بعدی را براساس قیمت‌گذاری عادی جزئیات مکان درخواست کنید.

این مثال مجموعه‌ای از درخواست‌ها را براساس پلاتفرم نشان می‌دهد که وقتی صورت‌حسابتان را براساس SKU مشاهده می‌کنید، منجر به SKUهای زیر در صورت‌حسابتان می‌شود:

  • تکمیل خودکار (شامل جزئیات مکان) – در هر جلسه
  • جزئیات جا
  • داده‌های پایه

درخواست نمونه براساس پلاتفرم:

درخواست‌های Android

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: (ازجمله شناسه مکان و فیلد GMSPlaceFieldFormattedAddress)

درخواست‌های سرویس وب

درخواست تکمیل خودکار جاها (ورودی=«par»، کد جلسه: XYZ)
درخواست تکمیل خودکار جاها (ورودی=«paris»، کد جلسه: XYZ)
جزئیات جاها (شناسه جا، کد جلسه: XYZ، فیلدها:formatted_address)

  قیمت‌گذاری فهرست قیمت (جهانی)
فهرست قیمت (هند)

درباره جلسه‌های «تکمیل خودکار»

جلسه «تکمیل خودکار» شامل چند درخواست «تکمیل خودکار» (برای بازیابی پیشنهادهای مربوط به مکان درحین تایپ کردن کاربر) و حداکثر یک درخواست «جزئیات مکان‌ها» (برای بازیابی جزئیات مربوط به مکان انتخاب‌شده توسط کاربر) است. همان کد جلسه به «تکمیل خودکار» و درخواست بعدی «جزئیات مکان» ارسال می‌شود. جلسه با اولین درخواست «تکمیل خودکار» (که معمولاً وقتی کاربر شروع به تایپ می‌کند اتفاق می‌افتد) شروع می‌شود. وقتی کاربر یکی از پیشنهادهای «تکمیل خودکار» را انتخاب می‌کند، یک تماس «جزئیات مکان‌ها» برقرار می‌شود. اگر کاربر پیشنهادی را انتخاب نکند، هیچ تماسی با «جزئیات مکان‌ها» برقرار نمی‌شود.

پس‌از اینکه کاربر مکانی را انتخاب کرد (یعنی پس‌از برقراری تماس «جزئیات مکان‌ها»)، باید جلسه جدیدی را بااستفاده از کد جلسه جدید شروع کنید.

جلسه‌های تکمیل خودکار را می‌توان از میان‌افزارهای برنامه‌سازی کاربردی زیر تولید کرد:

یک کد جلسه برای یک جلسه کاربر مناسب است و نباید برای بیش از یک جلسه کاربر استفاده شود. اگر از کد جلسه مجدداً استفاده کنید، جلسه نامعتبر تلقی می‌شود و درخواست‌ها به‌گونه‌ای محاسبه می‌شوند که گویی هیچ کد جلسه‌ای ارائه نشده است.

درخواست‌های «تکمیل خودکار» و درخواست‌های «جزئیات مکان‌ها» که از جلسه‌ها استفاده می‌کنند، در «واحدهای نگهداری موجودی» (SKU) متفاوتی صورت‌حساب می‌شوند.

واحد نگهداری موجودی: داده‌های اصلی

شناسه کالای داده که برای فیلدهای داده‌های پایه در درخواست جزئیات جاها یا پیدا کردن جا صورت‌حساب صادر می‌کند.

  دسته Essentials
  شناسه SKU

75D4-C522-326B (جهانی)

‫۵D۷B-۱F۷B-۳۹۵E (هند)

  میاناهای برنامه‌سازی کاربردی جزئیات جاها (قدیمی) با فیلدهای پایه
یافتن جا (قدیمی) با فیلدهای پایه
  رویداد صورتحساب‌پذیر درخواست موفق برای فیلدهای «داده‌های پایه»
  راه‌اندازها

فیلدهای کیت توسعه نرم‌افزار Android

Place.Field.ACCESSIBILITY_OPTIONS*
   * به‌جای Place.Field.WHEELCHAIR_ACCESSIBLE_ENTRANCE (منسوخ‌شده)
استفاده کنید Place.Field.ADDRESS_COMPONENTS
Place.Field.BUSINESS_STATUS
Place.Field.DISPLAY_NAME*
   * به‌جای Place.Field.NAME (منسوخ‌شده)
استفاده کنید Place.Field.FORMATTED_ADDRESS*
   * به‌جای Place.Field.ADDRESS (منسوخ‌شده)
استفاده کنید Place.Field.ICON_BACKGROUND_COLOR
Place.Field.ICON_MASK_URL*
   * به‌جای Place.Field.ICON_URL (منسوخ‌شده)
استفاده کنید Place.Field.ID
Place.Field.LOCATION*
   * به‌جای Place.Field.LAT_LNG (منسوخ‌شده)
استفاده کنید Place.Field.PHOTO_METADATAS
Place.Field.PLUS_CODE
Place.Field.TYPES
Place.Field.VIEWPORT
Place.Field.UTC_OFFSET.

فیلدهای iOS

GMSPlaceFieldFormattedAddress
GMSPlaceFieldBusinessStatus
GMSPlaceFieldID
GMSPlaceFieldCoordinate
GMSPlaceFieldName
GMSPlaceFieldPhotos
GMSPlaceFieldPlusCode
GMSPlaceFieldTypes
GMSPlaceFieldViewport

فیلدهای سرویس وب

address_component
adr_address
business_status
formatted_address
geometry
icon
name
permanently_closed
photo
place_id
plus_code
type
url
utc_offset
vicinity
wheelchair_accessible_entrance

  صورت‌حساب پوشش فیلد

درخواست شما براساس فیلدهای ارائه‌شده در ماسک فیلد صورت‌حساب می‌شود. برای مثال:

  • اگر ماسک فیلد شما فقط شامل فیلدهای این SKU باشد: درخواست با نرخ این SKU صورت‌حساب می‌شود.
  • اگر ماسک فیلد شما شامل فیلدهایی از SKUهای دیگر باشد: درخواست با بالاترین نرخ SKU برای فیلدهای درخواست‌شده صورت‌حساب می‌شود. برای مثال، اگر فیلدهایی از هر دو SKU Essentials و SKU Enterprise را اضافه کنید، درخواست با نرخ SKU Enterprise صورت‌حساب می‌شود.
  قیمت‌گذاری فهرست قیمت (جهانی)
فهرست قیمت (هند)

SKU: Find Place – ID only

  دسته Essentials
  شناسه SKU

44A2-D839-A3AC (جهانی)

FE05-60A4-CDDF (هند)

  میاناهای برنامه‌سازی کاربردی Places Web Service Find Place
  رویداد صورتحساب‌پذیر درخواست موفق فقط برای place_id
  راه‌اندازها درخواست پیدا کردن مکان بدون فیلد مشخص‌شده، یا فقط فیلد place_id: FindPlace(fields: place_id).
  قیمت‌گذاری فهرست قیمت (جهانی)
فهرست قیمت (هند)

SKU: Place Details – ID Refresh

  دسته Essentials
  شناسه SKU

2D88-4302-6299 (جهانی)

۴۶۰۴-F۵۶B-۷۰۸۶ (هند)

  میاناهای برنامه‌سازی کاربردی جزئیات جا (قدیمی)
  رویداد صورتحساب‌پذیر درخواست موفقیت‌آمیز فقط برای فیلدهای شناسه
  راه‌اندازها درخواست فقط با فیلد «شناسه مکان»: getPlaceDetails(fields: place_id).
  قیمت‌گذاری فهرست قیمت (جهانی)
فهرست قیمت (هند)

SKU: Query Autocomplete – Per Request

  دسته Essentials
  شناسه SKU

C4B1-8805-63EF (جهانی)

59E9-EB83-5CA3 (هند)

  میاناهای برنامه‌سازی کاربردی سرویس تکمیل خودکار پُرسمان
  رویداد صورتحساب‌پذیر درخواست موفق بود
  راه‌اندازها

قیمت‌گذاری براساس جلسه «تکمیل خودکار» بااستفاده از «تکمیل خودکار پُرسمان» پشتیبانی نمی‌شود. درخواست‌های بعدی «جزئیات مکان» براساس شناسه محصول Place Details Pro هزینه دریافت می‌کنند.

  قیمت‌گذاری فهرست قیمت (جهانی)
فهرست قیمت (هند)

[ Pro: Places Legacy ]

SKU: Autocomplete without Place Details – Per Session

  دسته Pro
  شناسه SKU

B52C-8320-6DC5 (جهانی)

C625-D3CE-DF37 (هند)

  میاناهای برنامه‌سازی کاربردی تکمیل خودکار جا (قدیمی) Android،
تکمیل خودکار جا (قدیمی) iOS،
تکمیل خودکار جا (قدیمی) وب
  رویداد صورتحساب‌پذیر جلسه
  راه‌اندازها
  قیمت‌گذاری فهرست قیمت (جهانی)
فهرست قیمت (هند)

SKU: Find Current Place

  دسته Pro
  شناسه SKU

7218-264C-D1D7 (جهانی)

0862-F46E-1A1A (هند)

  میاناهای برنامه‌سازی کاربردی کیت توسعه نرم‌افزار مکان‌ها، ویژه Android،
کیت توسعه نرم‌افزار مکان‌ها، ویژه iOS
  رویداد صورتحساب‌پذیر درخواست موفق بود
  راه‌اندازها
  نمونه‌ها

مثال‌های زیر نشان می‌دهد که هنگام درخواست «یافتن مکان فعلی» و مشخص کردن فیلدها از SKU داده‌های «پایه»، «مخاطب»، و «جو» برای کدام SKUها صورت‌حساب دریافت می‌کنید. برای دیدن واحدهای نگهداری موجودی در صورت‌حسابتان، صورت‌حسابتان را براساس واحد نگهداری موجودی مشاهده کنید، همان‌طور که در تجزیه‌وتحلیل استفاده و هزینه به‌ازای هر واحد نگهداری موجودی شرح داده شده است.

درخواست «یافتن مکان فعلی» را فقط با فیلد ADDRESS ارسال می‌کنید:

صورت‌حساب شما این شناسه‌های SKU را نشان می‌دهد:

  • پیدا کردن مکان فعلی
  • داده‌های پایه

درخواست «یافتن مکان فعلی» را فقط با فیلد PHONE_NUMBER ارسال می‌کنید:

صورت‌حساب شما این شناسه‌های SKU را نشان می‌دهد:

  • پیدا کردن مکان فعلی
  • داده‌های مخاطب

درخواست «یافتن مکان فعلی» را با هر سه فیلد نوع داده ارسال می‌کنید:

صورت‌حساب شما این شناسه‌های SKU را نشان می‌دهد:

  • پیدا کردن مکان فعلی
  • داده‌های پایه
  • داده‌های مخاطب
  • داده‌های جوی

  قیمت‌گذاری فهرست قیمت (جهانی)
فهرست قیمت (هند)

SKU: Find Place

  دسته Pro
  شناسه SKU

DC67-3188-2294 (جهانی)

ECB4-087C-9A27 (هند)

  میاناهای برنامه‌سازی کاربردی پیدا کردن جا (قدیمی)
  رویداد صورتحساب‌پذیر درخواست موفق برای چیزی بیشتر از فیلد شناسه
  راه‌اندازها درخواست یافتن مکان با چیزی بیشتر از فیلد شناسه مشخص‌شده.
  نمونه‌ها

مثال‌های زیر نشان می‌دهد که هنگام درخواست «یافتن مکان فعلی» و مشخص کردن فیلدها از SKU داده‌های «پایه»، «مخاطب»، و «جو» برای کدام SKUها صورت‌حساب دریافت می‌کنید. برای دیدن واحدهای نگهداری موجودی در صورت‌حسابتان، صورت‌حسابتان را براساس واحد نگهداری موجودی مشاهده کنید، همان‌طور که در تجزیه‌وتحلیل استفاده و هزینه به‌ازای هر واحد نگهداری موجودی شرح داده شده است.

درخواست «یافتن مکان» را فقط با ADDRESS فیلد ایجاد می‌کنید:

صورت‌حسابتان این شناسه‌های SKU را نشان می‌دهد:

  • پیدا کردن مکان فعلی
  • داده‌های پایه

درخواست «یافتن مکان» را فقط با PHONE_NUMBER فیلد ایجاد می‌کنید:

صورت‌حساب شما این شناسه‌های SKU را نشان می‌دهد:

  • پیدا کردن مکان فعلی
  • داده‌های مخاطب

درخواست «پیدا کردن مکان» را با هر سه فیلد نوع داده ایجاد می‌کنید:

صورت‌حساب شما این شناسه‌های SKU را نشان می‌دهد:

  • پیدا کردن مکان فعلی
  • داده‌های پایه
  • داده‌های مخاطب
  • داده‌های جوی

  قیمت‌گذاری فهرست قیمت (جهانی)
فهرست قیمت (هند)

SKU: Places – Nearby Search

  دسته Pro
  شناسه SKU

6B23-8A17-D29D (جهانی)

CC66-BE0E-2477 (هند)

  میاناهای برنامه‌سازی کاربردی جستجوی اطراف (قدیمی)
  رویداد صورتحساب‌پذیر درخواست موفق برای ویژگی‌های Pro
  راه‌اندازها

این درخواست از تعیین فیلدهایی که باید برگردانده شوند پشتیبانی نمی‌کند. پاسخ فهرستی از مکان‌ها و زیرمجموعه‌ای از فیلدهای داده پشتیبانی‌شده را برمی‌گرداند.

  نمونه‌ها

درخواست «جستجوی اطراف» ایجاد می‌کنید، مثلاً NearbySearch (San Francisco, 100 meters). هنگام مشاهده صورت‌حساب براساس SKU، صورت‌حساب شما این SKUها را نشان می‌دهد:

  • جا
  • داده‌های پایه
  • داده‌های مخاطب
  • داده‌های جوی
  قیمت‌گذاری فهرست قیمت (جهانی)
فهرست قیمت (هند)

واحد نگهداری موجودی: مکان‌ها – جستجوی نوشتار

  دسته Pro
  شناسه SKU

E95A-86C7-7F47 (جهانی)

102E-888D-5596 (هند)

  میاناهای برنامه‌سازی کاربردی جستجوی نوشتار (قدیمی)
  رویداد صورتحساب‌پذیر درخواست موفق به جستجوی نوشتار (قدیمی)
  راه‌اندازها

درخواست‌های «جستجوی نوشتار» فهرستی از مکان‌ها را برمی‌گرداند، اما از مشخص کردن اینکه کدام فیلدها برگردانده شوند پشتیبانی نمی‌کند. درخواست‌های «جستجوی نوشتار» زیرمجموعه‌ای از فیلدهای داده پشتیبانی‌شده را برمی‌گرداند. هزینه درخواست «جستجوی نوشتار» و همچنین همه SKUهای نوع داده از شما کسر می‌شود: داده‌های پایه، داده‌های تماس، و داده‌های جو.

SKU: Places – Text Search is also triggered by the Maps JavaScript API Place SearchBox widget: getPlaces() method after the user selects a place query (icon: magnifier), not a result (icon: pin), as illustrated here:

انتخاب پُرسمان ابزاره چارگوش جستجوی جزئیات مکان‌ها
در نتایج ابزارک چارگوش جستجو، پس‌از تایپ کردن «پیتزا» در چارگوش جستجو، توجه کنید که ارسال پیتزا نماد ذره‌بین در کنارش دارد که نشان می‌دهد پرس‌وجوی مکان است (و نه نتیجه).
  نمونه‌ها

اگر درخواست «جستجوی نوشتار (قدیمی)» داشته باشید، هنگام مشاهده صورت‌حساب براساس SKU، این SKUها در صورت‌حساب شما نشان داده می‌شود:

  • جاها - جستجوی نوشتار
  • داده‌های پایه
  • داده‌های مخاطب
  • داده‌های جوی
  قیمت‌گذاری فهرست قیمت (جهانی)
فهرست قیمت (هند)

SKU: Places Details

  دسته Pro
  شناسه SKU

FC5C-DF28-543F (جهانی)

F7AA-FEF9-C90E (هند)

  میاناهای برنامه‌سازی کاربردی جزئیات جا (قدیمی)
  رویداد صورتحساب‌پذیر درخواست موفق برای ویژگی‌های Pro
  راه‌اندازها

با میانای برنامه‌سازی کاربردی و سرویس‌های وب، شناسه کالای «جزئیات جا» چه کد جلسه ارائه دهید چه ندهید، هزینه دارد.

  نمونه‌ها
  1. یکی از این تماس‌ها یا درخواست‌ها را برقرار کنید:
    • تلفن همراه: fetchPlace() را در Android یا fetchPlaceFromPlaceID: را در iOS فراخوانی کنید و فقط فیلد ADDRESS را مشخص کنید
    • میانای برنامه‌سازی کاربردی وب یا سرویس: درخواست «جزئیات جا (قدیمی)» بدهید و فقط فیلد نشانی را مشخص کنید: getPlaceDetails(fields: formatted_address)
    در صورت‌حسابتان، این شناسه‌های SKU را فهرست‌شده خواهید دید (وقتی صورت‌حسابتان را براساس شناسه SKU مشاهده می‌کنید):
    • جزئیات جاها
    • داده‌های پایه
  2. یکی از این تماس‌ها یا درخواست‌ها را برقرار کنید:
    • تلفن همراه: fetchPlace() را در Android یا fetchPlaceFromPlaceID: را در iOS فراخوانی کنید و فقط فیلد PHONE_NUMBER را مشخص کنید
    • میانای برنامه‌سازی کاربردی یا سرویس وب: درخواست «جزئیات مکان (قدیمی)» بدهید و فیلد شماره تلفن را مشخص کنید: getPlaceDetails(fields: formatted_phone_number)
    در صورت‌حسابتان، این شناسه‌های SKU را فهرست‌شده خواهید دید (وقتی صورت‌حسابتان را براساس شناسه SKU مشاهده می‌کنید):
    • جزئیات جاها
    • داده‌های مخاطب
  3. یکی از این تماس‌ها یا درخواست‌ها را برقرار کنید:
    • تلفن همراه: fetchPlace() را در Android یا fetchPlaceFromPlaceID: را در iOS فراخوانی کنید و همه فیلدها را مشخص کنید
    • میانای برنامه‌سازی کاربردی وب یا سرویس: درخواست «جزئیات جا (قدیمی)» بدهید و همه فیلدها را مشخص کنید (اگر فیلدی را مشخص نکنید، این نوع درخواست به‌طور پیش‌فرض انتخاب می‌شود): getPlaceDetails().
    در صورت‌حسابتان، این شناسه‌های SKU را فهرست‌شده خواهید دید (وقتی صورت‌حسابتان را براساس شناسه SKU مشاهده می‌کنید):
    • جزئیات جاها
    • داده‌های پایه
    • داده‌های مخاطب
    • داده‌های جوی
  قیمت‌گذاری فهرست قیمت (جهانی)
فهرست قیمت (هند)

[ Enterprise: Places Legacy ]

واحد نگهداری موجودی: داده‌های جوی

شناسه انبارش داده که برای فیلدهای داده‌های جو در درخواست جزئیات مکان‌ها یا یافتن مکان صورت‌حساب صادر می‌کند.

  دسته Enterprise
  شناسه SKU

D63D-5CC5-302A (جهانی)

0CE0-1963-137E (هند)

  میاناهای برنامه‌سازی کاربردی جزئیات مکان‌ها (قدیمی) با فیلدهای جو
یافتن مکان (قدیمی) با فیلدهای جو
  رویداد صورتحساب‌پذیر درخواست موفق برای فیلدهای داده Atmosphere
  راه‌اندازها
  نمونه‌های صورت‌حساب پوشش فیلد

درخواست شما براساس فیلدهای ارائه‌شده در ماسک فیلد صورت‌حساب می‌شود. برای مثال:

  • اگر ماسک فیلد شما فقط شامل فیلدهای این SKU باشد: درخواست با نرخ این SKU صورت‌حساب می‌شود.
  • اگر ماسک فیلد شما شامل فیلدهایی از SKUهای دیگر باشد: درخواست با بالاترین نرخ SKU برای فیلدهای درخواست‌شده صورت‌حساب می‌شود. برای مثال، اگر فیلدهایی از هر دو SKU Essentials و SKU Enterprise را اضافه کنید، درخواست با نرخ SKU Enterprise صورت‌حساب می‌شود.
  قیمت‌گذاری فهرست قیمت (جهانی)
فهرست قیمت (هند)

واحد نگهداری موجودی: داده‌های مخاطب

شناسه کالای داده که برای فیلدهای داده‌های تماس در درخواست جزئیات مکان‌ها یا یافتن مکان صورت‌حساب صادر می‌کند.

  دسته Enterprise
  شناسه SKU

F095-CD01-81B2 (جهانی)

A03F-5079-C66C (هند)

  میاناهای برنامه‌سازی کاربردی جزئیات مکان‌ها (قدیمی) با فیلدهای تماس
پیدا کردن مکان (قدیمی) با فیلدهای تماس
  رویداد صورتحساب‌پذیر درخواست موفق برای فیلدهای «داده‌های مخاطب»
  راه‌اندازها

فیلدهای کیت توسعه نرم‌افزار Android

Place.Field.CURRENT_OPENING_HOURS
Place.Field.INTERNATIONAL_PHONE_NUMBER*
      * به‌جای Place.Field.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

  صورت‌حساب پوشش فیلد

درخواست شما براساس فیلدهای ارائه‌شده در ماسک فیلد صورت‌حساب می‌شود. برای مثال:

  • اگر ماسک فیلد شما فقط شامل فیلدهای این SKU باشد: درخواست با نرخ این SKU صورت‌حساب می‌شود.
  • اگر ماسک فیلد شما شامل فیلدهایی از SKUهای دیگر باشد: درخواست با بالاترین نرخ SKU برای فیلدهای درخواست‌شده صورت‌حساب می‌شود. برای مثال، اگر فیلدهایی از هر دو SKU Essentials و SKU Enterprise را اضافه کنید، درخواست با نرخ SKU Enterprise صورت‌حساب می‌شود.
  قیمت‌گذاری فهرست قیمت (جهانی)
فهرست قیمت (هند)

واحد نگهداری موجودی: عکس مکان‌ها

  دسته Enterprise
  شناسه SKU

81E7-85D0-58A7 (جهانی)

9F4B-2E19-1B63 (هند)

  میاناهای برنامه‌سازی کاربردی Places Photo (Legacy)
  رویداد صورتحساب‌پذیر درخواست موفق برای عکس
  راه‌اندازها
  • Android: درخواست‌ها به fetchPhoto()
  • iOS: درخواست‌های loadPlacePhoto:
  • جاوا اسکریپت: درخواست‌ها به PlacePhoto.getUrl() برای بار کردن داده‌های پیکسل تصویر.
  • سرویس وب: درخواست‌ها به سرویس عکس‌های مکان Places API.
  قیمت‌گذاری فهرست قیمت (جهانی)
فهرست قیمت (هند)

واحد نگهداری موجودی‌های قدیمی Routes API

[ Essentials: Routes Legacy ]

SKU: Directions

  دسته Essentials
  شناسه SKU

28A8-3EB4-4595 (جهانی)

۴۷۱۴-۲۹۱C-۳۱۹۹ (هند)

  میاناهای برنامه‌سازی کاربردی سرویس مسیرهای Maps JavaScript API،
Directions API (قدیمی)
  رویداد صورتحساب‌پذیر درخواست موفق بدون ویژگی‌های Pro یا Enterprise
  راه‌اندازها پرسمان‌هایی که «واحد نگهداری موجودی» با رتبه‌بندی بالاتر را راه‌اندازی نمی‌کنند
  قیمت‌گذاری فهرست قیمت (جهانی)
فهرست قیمت (هند)

واحد نگهداری موجودی: Distance Matrix

  دسته Essentials
  شناسه SKU

C1B6-FF9D-7700 (جهانی)

558A-4F88-F361 (هند)

  میاناهای برنامه‌سازی کاربردی Distance Matrix API (Legacy)،
Maps JavaScript API Distance Matrix Service
  رویداد صورتحساب‌پذیر هر عنصری که حاوی ویژگی‌های Pro یا Enterprise نباشد. هر درخواستی که به Distance Matrix API ارسال می‌شود، عناصری را تولید می‌کند که در آن تعداد origins ضرب در تعداد destinations برابر با تعداد عناصر است.
  راه‌اندازها درخواست برای عناصری که باعث راه‌اندازی SKU با قیمت بالاتر نمی‌شوند
  قیمت‌گذاری فهرست قیمت (جهانی)
فهرست قیمت (هند)

[ Pro: Routes Legacy ]

SKU: Directions Advanced

  دسته Pro
  شناسه SKU

9407-00C2-CF85 (جهانی)

E27B-BD57-FD7D (هند)

  میاناهای برنامه‌سازی کاربردی سرویس مسیرهای Maps JavaScript API،
Directions API (قدیمی)
  رویداد صورتحساب‌پذیر درخواست موفق با ویژگی‌های Pro
  راه‌اندازها
  قیمت‌گذاری فهرست قیمت (جهانی)
فهرست قیمت (هند)

SKU: Distance Matrix Advanced

  دسته Pro
  شناسه SKU

DFAE-763F-CF6E (جهانی)

C0F4-32AE-F6D1 (هند)

  میاناهای برنامه‌سازی کاربردی Distance Matrix API (Legacy)،
Maps JavaScript API Distance Matrix Service
  رویداد صورتحساب‌پذیر هر عنصر با ویژگی‌های Pro برگردانده شد. هر درخواستی که به Distance Matrix API ارسال می‌شود، عناصری را تولید می‌کند که در آن تعداد origins ضرب در تعداد destinations برابر با تعداد عناصر است.
  راه‌اندازها
  قیمت‌گذاری فهرست قیمت (جهانی)
فهرست قیمت (هند)