حزمة تطوير برامج الأماكن لاستخدام نظام التشغيل iOS والفوترة

يتم تنشيط رمز التخزين التعريفي هذا في الحالات التالية:

• لا يتضمّن طلبك رمز رمز الجلسة.
• يتضمّن طلبك رمزًا مميّزًا للجلسة، ولكنّك تتخلّى عن الجلسة.
• يتضمّن طلبك رمز أمان الجلسة، ولكنّك تُنهي الجلسة في ظلّ ظروف معيّنة. للحصول على معلومات عن "استخدام جلسة الإكمال التلقائي"، يُرجى الاطّلاع على الرموز المميّزة للجلسة أو استخدام جلسة الإكمال التلقائي.

يتم تنشيط رمز التخزين التعريفي هذا عند إرسال طلب إلى واجهة برمجة التطبيقات Autocomplete (New) API يتضمّن رمز موافقة مميزة للجلسة.

يعمل رمز التخزين التعريفي هذا كحزمة لرموز التخزين التعريفية لطلبات "الإكمال التلقائي" (جديد) التي توفّر لك طريقة لتحديد عدد الطلبات التي يتم تحصيل رسومها خلال جلسة واحدة من جلسات "الإكمال التلقائي". للحصول على معلومات عن استخدام جلسة الإكمال التلقائي، يُرجى الاطّلاع على الرموز المميّزة للجلسة.

لمزيد من المعلومات، يُرجى الاطّلاع على الميزة التلقائية (الجديدة) وأسعار الجلسات.

يتم تنشيط رمز التخزين التعريفي هذا عند طلب الحقول التالية:

• iOS:
  GMSPlacePropertyPlaceID
GMSPlacePropertyPhotos

في ما يلي أمثلة على كيفية فوترة الطلب استنادًا إلى الحقول التي تختارها في قناع الحقول.

• إذا كانت قناع حقول الطلب لا تتضمّن سوى حقول من رمز التخزين التعريفي هذا: يتم تحصيل رسوم الطلب وفقًا لرقم التخزين التعريفي هذا. على سبيل المثال، يمكنك طلب حقل واحد أو أكثر من رمز التخزين التعريفي هذا، ويتم تحصيل الرسوم منك وفقًا لرقم التخزين التعريفي هذا.
• إذا كان قناع حقل الطلب يتضمّن حقولًا من رموز تخزين تعريفية أخرى: يتم تحصيل رسوم الطلب وفقًا لأعلى سعر رمز تخزين تعريفي للحقول المطلوبة. على سبيل المثال، إذا أدرجت حقولًا من عدة رموز تخزين تعريفية، مثل رمز تخزين تعريفي لإصدار Essentials ورمز تخزين تعريفي لإصدار Enterprise، يتمّ تحصيل رسوم الطلب وفقًا لرموز التخزين التعريفية لإصدار Enterprise.

يتم تنشيط رمز التخزين التعريفي هذا عند طلب حقول الموقع الجغرافي التالية:

• iOS:
  GMSPlacePropertyAddressComponents
GMSPlacePropertyFormattedAddress
GMSPlacePropertyCoordinate
GMSPlacePropertyPlusCode
GMSPlacePropertyTypes
GMSPlacePropertyViewport

في ما يلي أمثلة على كيفية فوترة الطلب استنادًا إلى الحقول التي تختارها في قناع الحقول.

• إذا كانت قناع حقول الطلب لا تتضمّن سوى حقول من رمز التخزين التعريفي هذا: يتم تحصيل رسوم الطلب وفقًا لرقم التخزين التعريفي هذا. على سبيل المثال، يمكنك طلب حقل واحد أو أكثر من رمز التخزين التعريفي هذا، ويتم تحصيل الرسوم منك وفقًا لرقم التخزين التعريفي هذا.
• إذا كان قناع حقل الطلب يتضمّن حقولًا من رموز تخزين تعريفية أخرى: يتم تحصيل رسوم الطلب وفقًا لأعلى سعر رمز تخزين تعريفي للحقول المطلوبة. على سبيل المثال، إذا أدرجت حقولًا من عدة رموز تخزين تعريفية، مثل رمز تخزين تعريفي لإصدار Essentials ورمز تخزين تعريفي لإصدار Enterprise، يتمّ تحصيل رسوم الطلب وفقًا لرموز التخزين التعريفية لإصدار Enterprise.

• iOS:
  GMSPlacePropertyBusinessStatus
GMSPlacePropertyIconBackgroundColor
GMSPlacePropertyIconImageURL
GMSPlacePropertyName
GMSPlacePropertyUTCOffsetMinutes
GMSPlacePropertyWheelchairAccessibleEntrance

في ما يلي أمثلة على كيفية فوترة الطلب استنادًا إلى الحقول التي تختارها في قناع الحقول.

• إذا كانت قناع حقول الطلب لا تتضمّن سوى حقول من رمز التخزين التعريفي هذا: يتم تحصيل رسوم الطلب وفقًا لرقم التخزين التعريفي هذا. على سبيل المثال، يمكنك طلب حقل واحد أو أكثر من رمز التخزين التعريفي هذا، ويتم تحصيل الرسوم منك وفقًا لرقم التخزين التعريفي هذا.
• إذا كان قناع حقل الطلب يتضمّن حقولًا من رموز تخزين تعريفية أخرى: يتم تحصيل رسوم الطلب وفقًا لأعلى سعر رمز تخزين تعريفي للحقول المطلوبة. على سبيل المثال، إذا أدرجت حقولًا من عدة رموز تخزين تعريفية، مثل رمز تخزين تعريفي لإصدار Essentials ورمز تخزين تعريفي لإصدار Enterprise، يتمّ تحصيل رسوم الطلب وفقًا لرموز التخزين التعريفية لإصدار Enterprise.

• iOS: GMSPlacePropertyCurrentOpeningHours
GMSPlacePropertySecondaryOpeningHours
GMSPlacePropertyPhoneNumber
GMSPlacePropertyPriceLevel
GMSPlacePropertyRating
GMSPlacePropertyOpeningHours
GMSPlacePropertyUserRatingsTotal
GMSPlacePropertyWebsite

إذا أنهيت جلسة "الإكمال التلقائي" من خلال طلب بيانات عن "تفاصيل المكان" يطلب أي حقل من رمز التخزين التعريفي: تفاصيل المكان (أساسي أو متقدّم أو مفضّل)، يتم تحصيل رسوم الطلب وفقًا لرمز التخزين التعريفي: تفاصيل المكان (مفضّل). لمزيد من المعلومات، يُرجى الاطّلاع على رمز التخزين التعريفي: استخدام جلسة الإكمال التلقائي.

في ما يلي أمثلة على كيفية فوترة الطلب استنادًا إلى الحقول التي تختارها في قناع الحقول.

• إذا كانت قناع حقول الطلب لا تتضمّن سوى حقول من رمز التخزين التعريفي هذا: يتم تحصيل رسوم الطلب وفقًا لرقم التخزين التعريفي هذا. على سبيل المثال، يمكنك طلب حقل واحد أو أكثر من رمز التخزين التعريفي هذا، ويتم تحصيل الرسوم منك وفقًا لرقم التخزين التعريفي هذا.
• إذا كان قناع حقل الطلب يتضمّن حقولًا من رموز تخزين تعريفية أخرى: يتم تحصيل رسوم الطلب وفقًا لأعلى سعر رمز تخزين تعريفي للحقول المطلوبة. على سبيل المثال، إذا أدرجت حقولًا من عدة رموز تخزين تعريفية، مثل رمز تخزين تعريفي لإصدار Essentials ورمز تخزين تعريفي لإصدار Enterprise، يتمّ تحصيل رسوم الطلب وفقًا لرموز التخزين التعريفية لإصدار Enterprise.

يتم تنشيط رمز التخزين التعريفي هذا عند طلب الحقول التالية:

• iOS:
  GMSPlacePropertyCurbsidePickup
GMSPlacePropertyDelivery
GMSPlacePropertyDineIn
GMSPlacePropertyEditorialSummary
GMSPlacePropertyReservable
GMSPlacePropertyReviews
GMSPlacePropertyServesBeer
GMSPlacePropertyServesBreakfast
GMSPlacePropertyServesBrunch
GMSPlacePropertyServesDinner
GMSPlacePropertyServesLunch
GMSPlacePropertyServesVegetarianFood
GMSPlacePropertyServesWine
GMSPlacePropertyTakeout

إذا تم إنهاء جلسة "الإكمال التلقائي" من خلال طلب "تفاصيل الأماكن" الذي يطلب أي حقل من SKU: تفاصيل الأماكن (أساسية أو متقدّمة أو مفضّلة)، يتم تحصيل رسوم الطلب من العميل وفقًا لSKU: تفاصيل الأماكن (المفضّلة). لمزيد من المعلومات، يُرجى الاطّلاع على رمز التخزين التعريفي: استخدام جلسة الإكمال التلقائي.

في ما يلي أمثلة على كيفية فوترة الطلب استنادًا إلى الحقول التي تختارها في قناع الحقول.

• إذا كانت قناع حقول الطلب لا تتضمّن سوى حقول من رمز التخزين التعريفي هذا: يتم تحصيل رسوم الطلب وفقًا لرقم التخزين التعريفي هذا. على سبيل المثال، يمكنك طلب حقل واحد أو أكثر من رمز التخزين التعريفي هذا، ويتم تحصيل الرسوم منك وفقًا لرقم التخزين التعريفي هذا.
• إذا كان قناع حقل الطلب يتضمّن حقولًا من رموز تخزين تعريفية أخرى: يتم تحصيل رسوم الطلب وفقًا لأعلى سعر رمز تخزين تعريفي للحقول المطلوبة. على سبيل المثال، إذا أدرجت حقولًا من عدة رموز تخزين تعريفية، مثل رمز تخزين تعريفي لإصدار Essentials ورمز تخزين تعريفي لإصدار Enterprise، يتمّ تحصيل رسوم الطلب وفقًا لرموز التخزين التعريفية لإصدار Enterprise.

• iOS:
  GMSPlacePropertyAddressComponents
GMSPlacePropertyBusinessStatus
GMSPlacePropertyCoordinate
GMSPlacePropertyFormattedAddress
GMSPlacePropertyName
GMSPlacePropertyIconBackgroundColor
GMSPlacePropertyIconImageURL
GMSPlacePropertyPhotos
GMSPlacePropertyPlaceID
GMSPlacePropertyPlusCode
GMSPlacePropertyTypes
GMSPlacePropertyUTCOffsetMinutes
GMSPlacePropertyViewport
GMSPlacePropertyWheelchairAccessibleEntrance

في ما يلي أمثلة على كيفية فوترة الطلب استنادًا إلى الحقول التي تختارها في قناع الحقول.

• إذا كانت قناع حقول الطلب لا تتضمّن سوى حقول من رمز التخزين التعريفي هذا: يتم تحصيل رسوم الطلب وفقًا لرقم التخزين التعريفي هذا. على سبيل المثال، يمكنك طلب حقل واحد أو أكثر من رمز التخزين التعريفي هذا، ويتم تحصيل الرسوم منك وفقًا لرقم التخزين التعريفي هذا.
• إذا كان قناع حقل الطلب يتضمّن حقولًا من رموز تخزين تعريفية أخرى: يتم تحصيل رسوم الطلب وفقًا لأعلى سعر رمز تخزين تعريفي للحقول المطلوبة. على سبيل المثال، إذا أدرجت حقولًا من عدة رموز تخزين تعريفية، مثل رمز تخزين تعريفي لإصدار Essentials ورمز تخزين تعريفي لإصدار Enterprise، يتمّ تحصيل رسوم الطلب وفقًا لرموز التخزين التعريفية لإصدار Enterprise.

يتم تنشيط رمز التخزين التعريفي هذا عند طلب الحقول التالية:

• iOS:
  GMSPlacePropertyCurrentOpeningHours
GMSPlacePropertySecondaryOpeningHours
GMSPlacePropertyPhoneNumber
GMSPlacePropertyPriceLevel
GMSPlacePropertyRating
GMSPlacePropertyOpeningHours
GMSPlacePropertyUserRatingsTotal
GMSPlacePropertyWebsite

في ما يلي أمثلة على كيفية فوترة الطلب استنادًا إلى الحقول التي تختارها في قناع الحقول.

• إذا كانت قناع حقول الطلب لا تتضمّن سوى حقول من رمز التخزين التعريفي هذا: يتم تحصيل رسوم الطلب وفقًا لرقم التخزين التعريفي هذا. على سبيل المثال، يمكنك طلب حقل واحد أو أكثر من رمز التخزين التعريفي هذا، ويتم تحصيل الرسوم منك وفقًا لرقم التخزين التعريفي هذا.
• إذا كان قناع حقل الطلب يتضمّن حقولًا من رموز تخزين تعريفية أخرى: يتم تحصيل رسوم الطلب وفقًا لأعلى سعر رمز تخزين تعريفي للحقول المطلوبة. على سبيل المثال، إذا أدرجت حقولًا من عدة رموز تخزين تعريفية، مثل رمز تخزين تعريفي لإصدار Essentials ورمز تخزين تعريفي لإصدار Enterprise، يتمّ تحصيل رسوم الطلب وفقًا لرموز التخزين التعريفية لإصدار Enterprise.

يتم تنشيط رمز التخزين التعريفي هذا عند طلب الحقول التالية:

• iOS:
  GMSPlacePropertyCurbsidePickup
GMSPlacePropertyDelivery
GMSPlacePropertyDineIn
GMSPlacePropertyEditorialSummary
GMSPlacePropertyReservable
GMSPlacePropertyReviews
GMSPlacePropertyServesBeer
GMSPlacePropertyServesBreakfast
GMSPlacePropertyServesBrunch
GMSPlacePropertyServesDinner
GMSPlacePropertyServesLunch
GMSPlacePropertyServesVegetarianFood
GMSPlacePropertyServesWine
GMSPlacePropertyTakeout

في ما يلي أمثلة على كيفية فوترة الطلب استنادًا إلى الحقول التي تختارها في قناع الحقول.

• إذا كانت قناع حقول الطلب لا تتضمّن سوى حقول من رمز التخزين التعريفي هذا: يتم تحصيل رسوم الطلب وفقًا لرقم التخزين التعريفي هذا. على سبيل المثال، يمكنك طلب حقل واحد أو أكثر من رمز التخزين التعريفي هذا، ويتم تحصيل الرسوم منك وفقًا لرقم التخزين التعريفي هذا.
• إذا كان قناع حقل الطلب يتضمّن حقولًا من رموز تخزين تعريفية أخرى: يتم تحصيل رسوم الطلب وفقًا لأعلى سعر رمز تخزين تعريفي للحقول المطلوبة. على سبيل المثال، إذا أدرجت حقولًا من عدة رموز تخزين تعريفية، مثل رمز تخزين تعريفي لإصدار Essentials ورمز تخزين تعريفي لإصدار Enterprise، يتمّ تحصيل رسوم الطلب وفقًا لرموز التخزين التعريفية لإصدار Enterprise.

يتم تنشيط رمز التخزين التعريفي هذا عند طلب فقط الحقول التالية:

• iOS:
  GMSPlacePropertyPlaceID
GMSPlacePropertyName

في ما يلي أمثلة على كيفية فوترة الطلب استنادًا إلى الحقول التي تختارها في قناع الحقول.

• إذا كانت قناع حقول الطلب لا تتضمّن سوى حقول من رمز التخزين التعريفي هذا: يتم تحصيل رسوم الطلب وفقًا لرقم التخزين التعريفي هذا. على سبيل المثال، يمكنك طلب حقل واحد أو أكثر من رمز التخزين التعريفي هذا، ويتم تحصيل الرسوم منك وفقًا لرقم التخزين التعريفي هذا.
• إذا كان قناع حقل الطلب يتضمّن حقولًا من رموز تخزين تعريفية أخرى: يتم تحصيل رسوم الطلب وفقًا لأعلى سعر رمز تخزين تعريفي للحقول المطلوبة. على سبيل المثال، إذا أدرجت حقولًا من عدة رموز تخزين تعريفية، مثل رمز تخزين تعريفي لإصدار Essentials ورمز تخزين تعريفي لإصدار Enterprise، يتمّ تحصيل رسوم الطلب وفقًا لرموز التخزين التعريفية لإصدار Enterprise.

• iOS:
  GMSPlacePropertyAddressComponents
GMSPlacePropertyBusinessStatus
GMSPlacePropertyFormattedAddress
GMSPlacePropertyIconBackgroundColor
GMSPlacePropertyIconImageURL
GMSPlacePropertyCoordinate
GMSPlacePropertyPhotos
GMSPlacePropertyPlusCode
GMSPlacePropertyTypes
GMSPlacePropertyUTCOffsetMinutes
GMSPlacePropertyViewport
GMSPlacePropertyWheelchairAccessibleEntrance

في ما يلي أمثلة على كيفية فوترة الطلب استنادًا إلى الحقول التي تختارها في قناع الحقول.

• إذا كانت قناع حقول الطلب لا تتضمّن سوى حقول من رمز التخزين التعريفي هذا: يتم تحصيل رسوم الطلب وفقًا لرقم التخزين التعريفي هذا. على سبيل المثال، يمكنك طلب حقل واحد أو أكثر من رمز التخزين التعريفي هذا، ويتم تحصيل الرسوم منك وفقًا لرقم التخزين التعريفي هذا.
• إذا كان قناع حقل الطلب يتضمّن حقولًا من رموز تخزين تعريفية أخرى: يتم تحصيل رسوم الطلب وفقًا لأعلى سعر رمز تخزين تعريفي للحقول المطلوبة. على سبيل المثال، إذا أدرجت حقولًا من عدة رموز تخزين تعريفية، مثل رمز تخزين تعريفي لإصدار Essentials ورمز تخزين تعريفي لإصدار Enterprise، يتمّ تحصيل رسوم الطلب وفقًا لرموز التخزين التعريفية لإصدار Enterprise.

• iOS:
  GMSPlacePropertyCurrentOpeningHours
GMSPlacePropertySecondaryOpeningHours
GMSPlacePropertyPhoneNumber
GMSPlacePropertyPriceLevel
GMSPlacePropertyRating
GMSPlacePropertyOpeningHours
GMSPlacePropertyUserRatingsTotal
GMSPlacePropertyWebsite

في ما يلي أمثلة على كيفية فوترة الطلب استنادًا إلى الحقول التي تختارها في قناع الحقول.

• إذا كانت قناع حقول الطلب لا تتضمّن سوى حقول من رمز التخزين التعريفي هذا: يتم تحصيل رسوم الطلب وفقًا لرقم التخزين التعريفي هذا. على سبيل المثال، يمكنك طلب حقل واحد أو أكثر من رمز التخزين التعريفي هذا، ويتم تحصيل الرسوم منك وفقًا لرقم التخزين التعريفي هذا.
• إذا كان قناع حقل الطلب يتضمّن حقولًا من رموز تخزين تعريفية أخرى: يتم تحصيل رسوم الطلب وفقًا لأعلى سعر رمز تخزين تعريفي للحقول المطلوبة. على سبيل المثال، إذا أدرجت حقولًا من عدة رموز تخزين تعريفية، مثل رمز تخزين تعريفي لإصدار Essentials ورمز تخزين تعريفي لإصدار Enterprise، يتمّ تحصيل رسوم الطلب وفقًا لرموز التخزين التعريفية لإصدار Enterprise.

• iOS:
  GMSPlacePropertyCurbsidePickup
GMSPlacePropertyDelivery
GMSPlacePropertyDineIn
GMSPlacePropertyEditorialSummary
GMSPlacePropertyReservable
GMSPlacePropertyReviews
GMSPlacePropertyServesBeer
GMSPlacePropertyServesBreakfast
GMSPlacePropertyServesBrunch
GMSPlacePropertyServesDinner
GMSPlacePropertyServesLunch
GMSPlacePropertyServesVegetarianFood
GMSPlacePropertyServesWine
GMSPlacePropertyTakeout

في ما يلي أمثلة على كيفية فوترة الطلب استنادًا إلى الحقول التي تختارها في قناع الحقول.

• إذا كانت قناع حقول الطلب لا تتضمّن سوى حقول من رمز التخزين التعريفي هذا: يتم تحصيل رسوم الطلب وفقًا لرقم التخزين التعريفي هذا. على سبيل المثال، يمكنك طلب حقل واحد أو أكثر من رمز التخزين التعريفي هذا، ويتم تحصيل الرسوم منك وفقًا لرقم التخزين التعريفي هذا.
• إذا كان قناع حقل الطلب يتضمّن حقولًا من رموز تخزين تعريفية أخرى: يتم تحصيل رسوم الطلب وفقًا لأعلى سعر رمز تخزين تعريفي للحقول المطلوبة. على سبيل المثال، إذا أدرجت حقولًا من عدة رموز تخزين تعريفية، مثل رمز تخزين تعريفي لإصدار Essentials ورمز تخزين تعريفي لإصدار Enterprise، يتمّ تحصيل رسوم الطلب وفقًا لرموز التخزين التعريفية لإصدار Enterprise.

• 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
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

في ما يلي أمثلة على كيفية فوترة الطلب استنادًا إلى الحقول التي تختارها في قناع الحقول.

• إذا كانت قناع حقول الطلب لا تتضمّن سوى حقول من رمز التخزين التعريفي هذا: يتم تحصيل رسوم الطلب وفقًا لرقم التخزين التعريفي هذا. على سبيل المثال، يمكنك طلب حقل واحد أو أكثر من رمز التخزين التعريفي هذا، ويتم تحصيل الرسوم منك وفقًا لرقم التخزين التعريفي هذا.
• إذا كان قناع حقل الطلب يتضمّن حقولًا من رموز تخزين تعريفية أخرى: يتم تحصيل رسوم الطلب وفقًا لأعلى سعر رمز تخزين تعريفي للحقول المطلوبة. على سبيل المثال، إذا أدرجت حقولًا من عدة رموز تخزين تعريفية، مثل رمز تخزين تعريفي لإصدار Essentials ورمز تخزين تعريفي لإصدار Enterprise، يتمّ تحصيل رسوم الطلب وفقًا لرموز التخزين التعريفية لإصدار Enterprise.

• 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

في ما يلي أمثلة على كيفية فوترة الطلب استنادًا إلى الحقول التي تختارها في قناع الحقول.

• إذا كانت قناع حقول الطلب لا تتضمّن سوى حقول من رمز التخزين التعريفي هذا: يتم تحصيل رسوم الطلب وفقًا لرقم التخزين التعريفي هذا. على سبيل المثال، يمكنك طلب حقل واحد أو أكثر من رمز التخزين التعريفي هذا، ويتم تحصيل الرسوم منك وفقًا لرقم التخزين التعريفي هذا.
• إذا كان قناع حقل الطلب يتضمّن حقولًا من رموز تخزين تعريفية أخرى: يتم تحصيل رسوم الطلب وفقًا لأعلى سعر رمز تخزين تعريفي للحقول المطلوبة. على سبيل المثال، إذا أدرجت حقولًا من عدة رموز تخزين تعريفية، مثل رمز تخزين تعريفي لإصدار Essentials ورمز تخزين تعريفي لإصدار Enterprise، يتمّ تحصيل رسوم الطلب وفقًا لرموز التخزين التعريفية لإصدار Enterprise.

iOS

في ما يلي أمثلة على كيفية فوترة الطلب استنادًا إلى الحقول التي تختارها في قناع الحقول.

• إذا كانت قناع حقول الطلب لا تتضمّن سوى حقول من رمز التخزين التعريفي هذا: يتم تحصيل رسوم الطلب وفقًا لرقم التخزين التعريفي هذا. على سبيل المثال، يمكنك طلب حقل واحد أو أكثر من رمز التخزين التعريفي هذا، ويتم تحصيل الرسوم منك وفقًا لرقم التخزين التعريفي هذا.
• إذا كان قناع حقل الطلب يتضمّن حقولًا من رموز تخزين تعريفية أخرى: يتم تحصيل رسوم الطلب وفقًا لأعلى سعر رمز تخزين تعريفي للحقول المطلوبة. على سبيل المثال، إذا أدرجت حقولًا من عدة رموز تخزين تعريفية، مثل رمز تخزين تعريفي لإصدار Essentials ورمز تخزين تعريفي لإصدار Enterprise، يتمّ تحصيل رسوم الطلب وفقًا لرموز التخزين التعريفية لإصدار Enterprise.

• Android:
  findAutocompletePredictions()
• أجهزة iOS:
  findAutocompletePredictionsFromQuery:
• JavaScript:
  خدمة إكمال الأماكن تلقائيًا في Maps JavaScript API
• خدمة الويب:
  خدمة Places API Place Autocomplete

• Android
  findAutocompletePredictions() (.setQuery("par"), .setSessionToken(XYZ))
  findAutocompletePredictions() (.setQuery("paris"), .setSessionToken(XYZ))
• iOS
  placesClient?.findAutocompletePredictions(fromQuery: "par" ...
  placesClient?.findAutocompletePredictions(fromQuery: "paris" ...
• خدمة الويب
  طلب الإكمال التلقائي للأماكن (input="par", session_token: XYZ)
  طلب الإكمال التلقائي للأماكن (input="paris", session_token: XYZ)

عند عرض فاتورتك حسب رمز التخزين التعريفي، سيظهر لك رمز التخزين التعريفي هذا:

• الإكمال التلقائي بدون تفاصيل الأماكن - لكل جلسة

• Android: مكالمة إلى fetchPlace()
• iOS: طلب إلى fetchPlaceFromPlaceID:
• خدمة الويب: طلب تفاصيل مكان

يؤدي طلب "تفاصيل المكان" إلى إنشاء رموز التخزين التعريفية للبيانات (أساسية، جهة اتصال، و/أو جو المكان) ، وذلك استنادًا إلى الحقول التي تحدّدها في الطلب.

إذا لم تطلب حقولًا معيّنة في طلب "تفاصيل المكان"، سيتم تفعيل جميع رموز التخزين التعريفية للبيانات (Essentials وPro وEnterprise وEnterprise + Atmosphere). حدِّد الحقول التي تحتاج إليها فقط لتجنُّب أي رسوم غير ضرورية.

إذا طلبت فقط إعادة تحميل معرّف تفاصيل المكان (يحدّد طلبك حقل place_id فقط) أثناء جلسة إكمال تلقائي، يتم تحصيل رسوم الجلسة على أنّها رمز التخزين التعريفي: الإكمال التلقائي بدون تفاصيل المكان – لكل جلسة.

إذا أصدر تطبيقك المكالمات الثلاث التالية في جلسة واحدة:

• Android
  findAutocompletePredictions() (.setQuery("par"), .setSessionToken(XYZ))
  findAutocompletePredictions() (.setQuery("paris"), .setSessionToken(XYZ))
  fetchPlace() (مع FetchPlaceRequest بما في ذلك رقم تعريف المكان وحقل ADDRESS)

• iOS
  placesClient?.findAutocompletePredictions(fromQuery: "par" ...
  placesClient?.findAutocompletePredictions(fromQuery: "paris" ...
  fetchPlaceFromPlaceID: (بما في ذلك رقم تعريف المكان والحقل GMSPlaceFieldFormattedAddress)

خدمة ويب

• خدمة الويب
  طلب الإكمال التلقائي للأماكن (input="par", session_token: XYZ)
  طلب الإكمال التلقائي للأماكن (input="paris", session_token: XYZ)
  تفاصيل الأماكن (place_id, session_token: XYZ, fields:formatted_address)

ستظهر لك رموز التخزين التعريفية هذه في فاتورتك (عند عرض فاتورتك حسب رمز التخزين التعريفي):

• الإكمال التلقائي (مضمّن في "تفاصيل المكان") - لكل جلسة
• تفاصيل المكان
• البيانات الأساسية

• Android: حزمة تطوير برامج "الأماكن" لأجهزة Android (fetchPlace())
• iOS: حزمة تطوير برامج "الأماكن" لأجهزة iOS (fetchPlaceFromPlaceID:)
• JavaScript: خدمة "تفاصيل الأماكن" في واجهة برمجة التطبيقات JavaScript API لتطبيق "خرائط Google" (getDetails)
• JavaScript: تطبيق مصغّر "إكمال تلقائي للأماكن" في Maps JavaScript API (getPlace)
• JavaScript: تطبيق JavaScript API لتطبيق "خرائط Google": التطبيق المصغّر "مربّع البحث عن الأماكن": getPlaces() بعد اختيار المستخدِم نتيجة مكان (رمزها: دبوس)، *وليس* طلب بحث (رمزه: عدسة مكبرة)، كما هو موضّح هنا:

  

• خدمة الويب: خدمة "تفاصيل الأماكن" في Places API

باستخدام واجهة برمجة التطبيقات والخدمات على الويب، يتم تحصيل رسوم رمز التخزين التعريفي لتفاصيل المكان سواء قدّمت رمز تمييز جلسة أم لا.

يؤدي رمز التخزين التعريفي هذا أيضًا إلى تحصيل رسوم رموز التخزين التعريفية للبيانات: في حال تضمين حقول بيانات في طلبك، يمكن أن يؤدي ذلك إلى تحصيل رسوم إضافية مقابل رموز التخزين التعريفية للبيانات: Basic وContact و Atmosphere. حدِّد حقول البيانات التي تريدها فقط لتجنُّب التكاليف غير الضرورية. يتم تحصيل رسوم منك مقابل رمز التخزين التعريفي هذا بالإضافة إلى البيانات التي تطلبها.

1. يمكنك إجراء أحد هذه المكالمات أو الطلبات:
   • الأجهزة الجوّالة: اتصل بالرقم fetchPlace() على Android أو fetchPlaceFromPlaceID: على iOS، وحدِّد الحقل ADDRESS فقط.
   • Web API أو الخدمة: يمكنك إرسال طلب للحصول على تفاصيل عن مكان معيّن وتحديد حقل العنوان فقط: getPlaceDetails(fields: formatted_address)
   ستظهر لك رموز التخزين التعريفية هذه في فاتورتك (عند عرض فاتورتك حسب رمز التخزين التعريفي):
   • تفاصيل المكان
   • البيانات الأساسية
2. يمكنك إجراء أحد هذه المكالمات أو الطلبات:
   • الأجهزة الجوّالة: اتصل بالرقم fetchPlace() على Android أو fetchPlaceFromPlaceID: على iOS، وحدِّد الحقل PHONE_NUMBER فقط.
   • Web API أو الخدمة: يمكنك تقديم طلب للحصول على تفاصيل المكان وتحديد حقل رقم الهاتف: getPlaceDetails(fields: formatted_phone_number)
   ستظهر لك رموز التخزين التعريفية هذه في فاتورتك (عند عرض فاتورتك حسب رمز التخزين التعريفي):
   • تفاصيل المكان
   • بيانات الاتصال
3. يمكنك إجراء أحد هذه المكالمات أو الطلبات:
   • الأجهزة الجوّالة: اتصل بالرقم fetchPlace() على Android أو fetchPlaceFromPlaceID: على iOS، وحدِّد جميع الحقول.
   • Web API أو خدمة: يمكنك إرسال طلب للحصول على تفاصيل عن مكان معيّن وتحديد جميع الحقول (هذا النوع من الطلبات هو التلقائي في حال عدم تحديد أي حقول): getPlaceDetails().
   ستظهر لك رموز التخزين التعريفية هذه في فاتورتك (عند عرض فاتورتك حسب رمز التخزين التعريفي):
   • تفاصيل المكان
   • البيانات الأساسية
   • بيانات الاتصال
   • بيانات الغلاف الجوي

• ‫findCurrentPlace() (أجهزة Android)
• findPlaceLikelihoodsFromCurrentLocationWithPlaceFields: (أجهزة iOS)

يؤدي رمز التخزين التعريفي هذا أيضًا إلى تحصيل رسوم رموز التخزين التعريفية للبيانات: في حال تضمين حقول بيانات في طلبك، يمكن أن يؤدي ذلك إلى تحصيل رسوم إضافية مقابل رموز التخزين التعريفية للبيانات: Basic وContact و Atmosphere. حدِّد حقول البيانات التي تريدها فقط لتجنُّب التكاليف غير الضرورية. يتم تحصيل رسوم منك مقابل رمز التخزين التعريفي هذا بالإضافة إلى البيانات التي تطلبها.

توضِّح الأمثلة التالية رموز التخزين التعريفية التي يتم تحصيل رسومها منك عند تقديم طلب "العثور على المكان الحالي" وتحديد الحقول من رموز التخزين التعريفية لبيانات "البيانات الأساسية" و"جهة الاتصال" و"الجوّ". للاطّلاع على رموز التخزين التعريفية في فاتورتك، اطّلِع على فاتورتك حسب رمز التخزين التعريفي كما هو موضّح في مقالة تحليل الاستخدام والتكلفة لكل رمز تخزين تعريفي.

1. يمكنك إرسال طلب findCurrentPlace() (لنظام التشغيل Android) أو findPlaceLikelihoodsFromCurrentLocationWithPlaceFields: (لنظام التشغيل iOS) وتحديد الحقل ADDRESS فقط. تعرض فاتورتك رموز التخزين التعريفية التالية:
   • العثور على المكان الحالي
   • البيانات الأساسية
2. يمكنك إرسال طلب findCurrentPlace() (Android) أو findPlaceLikelihoodsFromCurrentLocationWithPlaceFields: (iOS) وتحديد الحقل PHONE_NUMBER. تعرض فاتورتك رموز التخزين التعريفية التالية:
   • العثور على المكان الحالي
   • بيانات الاتصال
3. يمكنك إرسال طلب findCurrentPlace() (لنظام التشغيل Android) أو findPlaceLikelihoodsFromCurrentLocationWithPlaceFields: (لنظام التشغيل iOS) وتحديد الحقول من جميع حِزم أنواع البيانات الثلاثة. تعرض فاتورتك رموز التخزين التعريفية التالية:
   • العثور على المكان الحالي
   • البيانات الأساسية
   • بيانات الاتصال
   • بيانات الغلاف الجوي

• Android: المكالمات إلى fetchPhoto()
• iOS: طلبات الاتصال loadPlacePhoto:
• JavaScript: لتحميل مكتبة "الأماكن" وخدمة "صور الأماكن" في واجهة برمجة التطبيقات JavaScript لخرائط Google عند طلب البيانات من عناوين URL التي يعرضها PlacePhoto.getUrl() لتحميل بيانات وحدات بكسل الصور ولا يتم تفعيل الفوترة إلى أن يتم استخدام عنوان URL فعليًا للحصول على بيانات وحدة البكسل.
• خدمة الويب: طلبات إلى خدمة "صور الأماكن" في Places API