تفاصيل رموز التخزين التعريفية القديمة لـ Places and Routes

توفّر هذه الصفحة تفاصيل رموز التخزين التعريفي وأرقام تعريفها والأحداث التي يمكن فوترتها ومفاتيح الفوترة لرموز التخزين التعريفي في Legacy Places API وLegacy Directions API وLegacy Distance Matrix API. للاطّلاع على الإصدارات الحالية من هذه الخدمات، يُرجى مراجعة تفاصيل رمز التخزين التعريفي لخدمة "الأماكن (جديد)" وتفاصيل رمز التخزين التعريفي لخدمة "المسارات والتنقّل". للحصول على دليل لجميع فئات المنتجات، يُرجى الاطّلاع على نظرة عامة على تفاصيل استخدام واجهة برمجة التطبيقات.

لمحة عن جداول رموز التخزين التعريفية

توضّح الأقسام التالية تفاصيل كل رمز تخزين تعريفي:

Category (الفئة)	ما إذا كان رمز التخزين التعريفي يندرج ضمن فئة Essentials أو Pro أو Enterprise.
الحدث القابل للفوترة	الحدث الذي تتم فوترته مقابل رمز التخزين التعريفي
المشغّلات	عناصر الرموز البرمجية التي تؤدي إلى تشغيل الأحداث القابلة للفوترة
الأسعار	روابط إلى جدول الأسعار لمجموعة رمز التخزين التعريفي هذا

رموز التخزين التعريفية القديمة لمنتجات Places

يُرجى الاطّلاع على رموز التخزين التعريفية لمنتج Places (New) لمعرفة أحدث الإصدارات.

لمحة عن رموز التخزين التعريفية لبيانات الأماكن

في ما يلي رموز التخزين التعريفية الثلاثة لبيانات الأماكن: البيانات الأساسية بيانات الاتصال بيانات الأجواء

يتم تفعيل رمز تخزين تعريفي واحد أو أكثر للبيانات في الحالات التالية:

• ‫Android: كل طلب إلى fetchPlace() أو findCurrentPlace()
• نظام التشغيل iOS: كل طلب إلى fetchPlaceFromPlaceID: أو findPlaceLikelihoodsFromCurrentLocationWithPlaceFields:
• خدمة الويب: كل طلب من Places API استنادًا إلى الحقول المحدّدة في الطلب

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

بالنسبة إلى خدمة الويب، تتيح لك طلبات Places API هذه تحديد حقول البيانات التي تريد عرضها:

• تفاصيل الأماكن
• العثور على مكان

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

• Places – Nearby Search
• Places – Text Search

( الرجوع إلى الأعلى )

[ Essentials: Places Legacy ]

رمز التخزين التعريفي: الإكمال التلقائي – لكل طلب

	Category (الفئة)	Essentials
	معرّف رمز التخزين التعريفي	‫7384-2DE4-D388 (عالميًا) ‫2164-BC00-53DC (الهند)
	واجهات برمجة التطبيقات	ميزة "الإكمال التلقائي للأماكن" (الإصدار القديم) على Android ميزة "الإكمال التلقائي للأماكن" (الإصدار القديم) على iOS ميزة "الإكمال التلقائي للأماكن" (الإصدار القديم) على الويب
	الحدث القابل للفوترة	طلب لا يتضمّن رمزًا مميزًا للجلسة
	المشغّلات	‫Android: findAutocompletePredictions() نظام التشغيل iOS: findAutocompletePredictionsFromQuery: ‫JavaScript: خدمة "الإكمال التلقائي للأماكن" في Maps JavaScript API خدمة الويب: خدمة "الإكمال التلقائي للأماكن" في Places API
	أمثلة	إذا قدّمت طلبًا من جلسة "إكمال تلقائي" غير صالحة (على سبيل المثال، جلسة تعيد استخدام رمز مميّز للجلسة)، سيتم أيضًا تحصيل رسوم منك مقابل رمز تخزين تعريفي لخدمة "الإكمال التلقائي" لكل طلب. قد يتم تحصيل رسوم من طلبات الإكمال التلقائي من "تطبيق الإكمال التلقائي للمكان" في Maps JavaScript API مقابل رمز التخزين التعريفي "الإكمال التلقائي – لكل طلب" عند إجراء طلبات من جلسة إكمال تلقائي غير صالحة. قد يحدث هذا الموقف عندما يكتب المستخدم أو ينسخ/يلصق عدة عناوين مختلفة في التطبيق المصغّر ولا يختار دائمًا عبارة بحث مقترحة.
	الأسعار	قائمة الأسعار (عالميًا) قائمة الأسعار (الهند)

( الرجوع إلى الأعلى )

رمز التخزين التعريفي: الإكمال التلقائي (مضمّن في تفاصيل المكان) - لكل جلسة

	Category (الفئة)	Essentials
	معرّف رمز التخزين التعريفي	‫E9C9-934B-DDB1 (عالميًا)
	واجهات برمجة التطبيقات	ميزة "الإكمال التلقائي للأماكن" (الإصدار القديم) على Android ميزة "الإكمال التلقائي للأماكن" (الإصدار القديم) على iOS ميزة "الإكمال التلقائي للأماكن" (الإصدار القديم) على الويب
	الحدث القابل للفوترة	الجلسة
	المشغّلات	‫Android: مكالمة مع "fetchPlace()" أجهزة iOS: استدعاء fetchPlaceFromPlaceID: خدمة الويب: طلب تفاصيل المكان الحقول في الطلب: احرص على تحديد الحقول التي تحتاج إليها في الطلب لتجنُّب أي رسوم غير ضرورية. استنادًا إلى الحقول التي تحدّدها، يؤدي طلب "تفاصيل المكان" أيضًا إلى إنشاء رموز تخزين التعريفية للبيانات التالية: البيانات الأساسية (Essentials) Places - Contact Data (Enterprise) Places - Atmosphere (Enterprise) في حال عدم تحديد حقول في طلب "تفاصيل المكان"، يتم تفعيل جميع رموز تخزين البيانات التعريفية. إذا طلبت إعادة تحميل معرّف تفاصيل المكان فقط (يحدّد طلبك الحقل place_id فقط) خلال جلسة إكمال تلقائي، تتم فوترة الجلسة على أنّها رمز التخزين التعريفي: الإكمال التلقائي بدون تفاصيل المكان - لكل جلسة.
	أمثلة	ملاحظة: يمكنك الاطّلاع على رمز التخزين التعريفي هذا في تقارير الفوترة، ولكن ليس في صفحة الفوترة > الأسعار في Google Cloud Console. تتوفّر طلبات الإكمال التلقائي بدون أي رسوم. يتم تحصيل رسوم من رمز التخزين التعريفي القديم هذا عند طلب "تفاصيل المكان" اللاحقة استنادًا إلى أسعار تفاصيل المكان العادية. يوضّح هذا المثال سلسلة من الطلبات، حسب المنصة، من شأنها أن تؤدي إلى ظهور رموز التخزين التعريفية التالية في فاتورتك، عند عرض فاتورتك حسب رمز التخزين التعريفي: الإكمال التلقائي (مضمّن في تفاصيل المكان) – لكل جلسة تفاصيل المكان البيانات الأساسية مثال على الطلب حسب المنصة: طلبات Android findAutocompletePredictions() (.setQuery("par"), .setSessionToken(XYZ)) findAutocompletePredictions() (.setQuery("paris"), .setSessionToken(XYZ)) fetchPlace() (مع FetchPlaceRequest بما في ذلك رقم تعريف المكان وحقل العنوان) طلبات 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)
	الأسعار	قائمة الأسعار (عالميًا) قائمة الأسعار (الهند)

لمحة عن جلسات "الإكمال التلقائي"

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

بعد أن يختار المستخدم مكانًا (أي بعد إجراء طلب "تفاصيل المكان")، يجب بدء جلسة جديدة باستخدام رمز مميز جديد للجلسة.

يمكن إنشاء جلسات "الإكمال التلقائي" من واجهات برمجة التطبيقات التالية:

• خدمة "الإكمال التلقائي للأماكن" في Places API أو خدمة "الإكمال التلقائي للأماكن" في Maps JavaScript API يجب تصميم تطبيقك لتوفير الرموز المميزة للجلسات (قد تحتاج إلى تغيير الرمز الحالي).
• تطبيق الإكمال التلقائي المصغّر في Maps JavaScript API يتم تفعيل الفوترة المستندة إلى الجلسة تلقائيًا في هذه التطبيقات المصغّرة، بدون الحاجة إلى إجراء أي تغيير في الرمز البرمجي.

يكون الرمز المميز للجلسة صالحًا لجلسة مستخدم واحدة، ولا يجب استخدامه لأكثر من جلسة مستخدم واحدة. في حال إعادة استخدام رمز مميّز للجلسة، تُعتبر الجلسة غير صالحة ويتم تحصيل رسوم الطلبات كما لو لم يتم تقديم أي رمز مميّز للجلسة.

تتم فوترة طلبات "الإكمال التلقائي" وطلبات "تفاصيل الأماكن" التي تستخدم الجلسات على رموز تخزين تعريفية مختلفة.

( الرجوع إلى الأعلى )

رمز التخزين التعريفي: البيانات الأساسية

رمز تخزين تعريفي للبيانات يفوتر حقول البيانات الأساسية في طلب تفاصيل الأماكن أو العثور على مكان.

	Category (الفئة)	Essentials
	معرّف رمز التخزين التعريفي	‫75D4-C522-326B (في جميع أنحاء العالم) 5D7B-1F7B-395E (الهند)
	واجهات برمجة التطبيقات	تفاصيل المكان (الإصدار القديم) مع الحقول الأساسية العثور على مكان (الإصدار القديم) مع الحقول الأساسية
	الحدث القابل للفوترة	طلب ناجح لحقول البيانات الأساسية
	المشغّلات	حقول حزمة تطوير البرامج (SDK) لنظام التشغيل 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 يتم تحصيل رسوم رمز التخزين التعريفي هذا بالإضافة إلى رمز التخزين التعريفي الأساسي (تفاصيل الأماكن أو البحث عن مكان أو البحث في الجوار أو البحث النصي) للطلب الذي أدّى إلى تفعيله.
	الفوترة حسب قناع الحقل	تتم فوترة طلبك استنادًا إلى الحقول المقدَّمة في قناع الحقول. على سبيل المثال: إذا كان قناع الحقل يتضمّن حقولاً من رمز التخزين التعريفي هذا فقط: يتم تحصيل رسوم الطلب وفقًا لسعر رمز التخزين التعريفي هذا. إذا كان قناع الحقل يتضمّن حقولاً من رموز تخزين تعريفية أخرى: تتم فوترة الطلب بأعلى سعر لرمز التخزين التعريفي للحقول المطلوبة. على سبيل المثال، إذا أدرجت حقولاً من رمز تخزين تعريفي لـ Essentials ورمز تخزين تعريفي لـ Enterprise، تتم فوترة الطلب بسعر رمز التخزين التعريفي لـ Enterprise.
	الأسعار	قائمة الأسعار (عالميًا) قائمة الأسعار (الهند)

( الرجوع إلى الأعلى )

رمز التخزين التعريفي: Find Place – ID only

	Category (الفئة)	Essentials
	معرّف رمز التخزين التعريفي	‫44A2-D839-A3AC (عالمي) FE05-60A4-CDDF (الهند)
	واجهات برمجة التطبيقات	خدمة الويب Places Web Service Find Place
	الحدث القابل للفوترة	طلب ناجح لـ place_id فقط
	المشغّلات	طلب العثور على مكان بدون تحديد حقول، أو مع تحديد الحقل place_id فقط: FindPlace(fields: place_id).
	الأسعار	قائمة الأسعار (عالميًا) قائمة الأسعار (الهند)

( الرجوع إلى الأعلى )

رمز التخزين التعريفي: تفاصيل المكان – إعادة تحميل المعرّف

	Category (الفئة)	Essentials
	معرّف رمز التخزين التعريفي	‫2D88-4302-6299 (عالميًا) ‎4604-F56B-7086 (الهند)
	واجهات برمجة التطبيقات	Place Details (Legacy)
	الحدث القابل للفوترة	طلب ناجح لحقول أرقام التعريف فقط
	المشغّلات	طلب يتضمّن حقل "رقم تعريف المكان" فقط: getPlaceDetails(fields: place_id).
	الأسعار	قائمة الأسعار (عالميًا) قائمة الأسعار (الهند)

( الرجوع إلى الأعلى )

رمز التخزين التعريفي: ميزة "الإكمال التلقائي للبحث" - لكل طلب

	Category (الفئة)	Essentials
	معرّف رمز التخزين التعريفي	‫C4B1-8805-63EF (عالميًا) ‎59E9-EB83-5CA3 (الهند)
	واجهات برمجة التطبيقات	خدمة "الإكمال التلقائي لطلبات البحث"
	الحدث القابل للفوترة	طلب ناجح
	المشغّلات	‫JavaScript: خدمة الإكمال التلقائي للأماكن في Maps JavaScript API (getQueryPredictions()) واستخدام تطبيق SearchBox المصغّر في Maps JavaScript API (يتم إنشاء طلبات الإكمال التلقائي لطلبات البحث أثناء كتابة المستخدم). خدمة الويب: خدمة الإكمال التلقائي لطلبات البحث في Places API لا تتوفّر ميزة التسعير حسب جلسة الإكمال التلقائي باستخدام ميزة "الإكمال التلقائي لطلب البحث". يتم تحصيل رسوم طلبات "تفاصيل المكان" اللاحقة استنادًا إلى رمز التخزين التعريفي Pro لتفاصيل المكان.
	الأسعار	قائمة الأسعار (عالميًا) قائمة الأسعار (الهند)

( الرجوع إلى الأعلى )

[ Pro: Places Legacy ]

رمز التخزين التعريفي: الإكمال التلقائي بدون تفاصيل المكان - لكل جلسة

	Category (الفئة)	Pro
	معرّف رمز التخزين التعريفي	‫B52C-8320-6DC5 (في جميع أنحاء العالم) C625-D3CE-DF37 (الهند)
	واجهات برمجة التطبيقات	ميزة "الإكمال التلقائي للأماكن" (الإصدار القديم) على Android ميزة "الإكمال التلقائي للأماكن" (الإصدار القديم) على iOS ميزة "الإكمال التلقائي للأماكن" (الإصدار القديم) على الويب
	الحدث القابل للفوترة	الجلسة
	المشغّلات	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) غير متبوع بطلب تفاصيل المكان
	الأسعار	قائمة الأسعار (عالميًا) قائمة الأسعار (الهند)

( الرجوع إلى الأعلى )

رمز التخزين التعريفي: Find Current Place

	Category (الفئة)	Pro
	معرّف رمز التخزين التعريفي	7218-264C-D1D7 (عالميًا) ‎0862-F46E-1A1A (الهند)
	واجهات برمجة التطبيقات	حزمة تطوير البرامج (SDK) للأماكن لنظام التشغيل Android، حزمة تطوير البرامج (SDK) للأماكن لنظام التشغيل iOS
	الحدث القابل للفوترة	طلب ناجح
	المشغّلات	طريقة findCurrentPlace() (Android) طريقة findPlaceLikelihoodsFromCurrentLocationWithPlaceFields: (iOS) يؤدي رمز التخزين التعريفي هذا أيضًا إلى تفعيل الفوترة لرموز التخزين التعريفية للبيانات: إذا أدرجت حقول بيانات في طلبك، يمكن أن يؤدي ذلك إلى تفعيل فوترة إضافية لرموز التخزين التعريفية للبيانات: البيانات الأساسية وبيانات الاتصال وبيانات الأجواء. حدِّد حقول البيانات التي تريد تجنُّب التكاليف غير الضرورية لها فقط. يتم تحصيل رسوم منك مقابل رمز التخزين التعريفي هذا بالإضافة إلى البيانات التي تطلبها.
	أمثلة	توضّح الأمثلة التالية رموز التخزين التعريفية التي تتم فوترتها عند إجراء طلب "العثور على المكان الحالي" وتحديد حقول من رموز التخزين التعريفية لبيانات "أساسية" و"معلومات الاتصال" و"الأجواء". للاطّلاع على رموز التخزين التعريفية في فاتورتك، يمكنك عرض فاتورتك حسب رمز التخزين التعريفي كما هو موضّح في مقالة تحليل الاستخدام والتكلفة لكل رمز تخزين تعريفي. عند تقديم طلب "العثور على المكان الحالي" باستخدام الحقل ADDRESS فقط: تعرض فاتورتك رموز التخزين التعريفية التالية: العثور على المكان الحالي البيانات الأساسية عند تقديم طلب "العثور على المكان الحالي" باستخدام الحقل PHONE_NUMBER فقط: تعرض فاتورتك رموز التخزين التعريفية التالية: العثور على المكان الحالي بيانات جهات الاتصال عند تقديم طلب "العثور على المكان الحالي" مع تضمين حقول أنواع البيانات الثلاثة: تعرض فاتورتك رموز التخزين التعريفية التالية: العثور على المكان الحالي البيانات الأساسية بيانات جهات الاتصال بيانات الغلاف الجوي
	الأسعار	قائمة الأسعار (عالميًا) قائمة الأسعار (الهند)

( الرجوع إلى الأعلى )

رمز التخزين التعريفي: العثور على مكان

	Category (الفئة)	Pro
	معرّف رمز التخزين التعريفي	DC67-3188-2294 (عالمي) ‫ECB4-087C-9A27 (الهند)
	واجهات برمجة التطبيقات	Find Place (Legacy)
	الحدث القابل للفوترة	طلب ناجح لأكثر من حقل رقم التعريف فقط
	المشغّلات	طلب العثور على مكان مع تحديد أكثر من حقل رقم التعريف فقط يؤدي رمز التخزين التعريفي هذا أيضًا إلى تفعيل الفوترة لرموز التخزين التعريفية للبيانات: إذا أدرجت حقول بيانات في طلبك، يمكن أن يؤدي ذلك إلى تفعيل فوترة إضافية لرموز التخزين التعريفية للبيانات: البيانات الأساسية وبيانات الاتصال وبيانات الأجواء. حدِّد حقول البيانات التي تريد تجنُّب التكاليف غير الضرورية لها فقط. يتم تحصيل رسوم منك مقابل رمز التخزين التعريفي هذا بالإضافة إلى البيانات التي تطلبها.
	أمثلة	توضّح الأمثلة التالية رموز التخزين التعريفية التي تتم فوترتها عند إجراء طلب "العثور على المكان الحالي" وتحديد حقول من رموز التخزين التعريفية لبيانات "أساسية" و"معلومات الاتصال" و"الأجواء". للاطّلاع على رموز التخزين التعريفية في فاتورتك، يمكنك عرض فاتورتك حسب رمز التخزين التعريفي كما هو موضّح في مقالة تحليل الاستخدام والتكلفة لكل رمز تخزين تعريفي. عند تقديم طلب "العثور على مكان" باستخدام الحقل ADDRESS فقط: تعرض فاتورتك رموز التخزين التعريفية التالية: العثور على المكان الحالي البيانات الأساسية عند تقديم طلب "العثور على مكان" باستخدام الحقل PHONE_NUMBER فقط: تعرض فاتورتك رموز التخزين التعريفية التالية: العثور على المكان الحالي بيانات جهات الاتصال عند تقديم طلب "العثور على مكان" يتضمّن جميع حقول أنواع البيانات الثلاثة: تعرض فاتورتك رموز التخزين التعريفية التالية: العثور على المكان الحالي البيانات الأساسية بيانات جهات الاتصال بيانات الغلاف الجوي
	الأسعار	قائمة الأسعار (عالميًا) قائمة الأسعار (الهند)

( الرجوع إلى الأعلى )

رمز التخزين التعريفي: Places – بحث في الجوار

	Category (الفئة)	Pro
	معرّف رمز التخزين التعريفي	‫6B23-8A17-D29D (عالميًا) CC66-BE0E-2477 (الهند)
	واجهات برمجة التطبيقات	Nearby Search (Legacy)
	الحدث القابل للفوترة	تمت الموافقة على طلب الحصول على ميزات Pro
	المشغّلات	خدمة "البحث في الجوار" عن الأماكن في Maps JavaScript API (nearbySearch()) خدمة "البحث في الجوار" في Places API لا يتيح هذا الطلب تحديد الحقول المطلوب عرضها. يعرض الردّ قائمة بالأماكن ومجموعة فرعية من حقول البيانات المتوافقة. يؤدي رمز التخزين التعريفي هذا أيضًا إلى تفعيل الفوترة لرموز التخزين التعريفية للبيانات: بما أنّ طلب البحث في الجوار (القديم) يعرض جميع حقول البيانات المتاحة للمكان المحدّد، يمكن أن يؤدي ذلك إلى تفعيل فوترة إضافية لرموز التخزين التعريفية للبيانات: البيانات الأساسية وبيانات الاتصال وبيانات الأجواء. سيتم تحصيل رسوم منك مقابل رمز التخزين التعريفي هذا بالإضافة إلى البيانات التي تطلبها. لتجنُّب طلب بيانات لا تحتاج إليها (ودفع رسوم مقابلها)، استخدِم طلب العثور على مكان (قديم) بدلاً من ذلك.
	أمثلة	أرسلت طلب "بحث في الجوار"، مثل NearbySearch (San Francisco, 100 meters). تعرض فاتورتك رموز التخزين التعريفية هذه عند عرض فاتورتك حسب رمز التخزين التعريفي: المكان البيانات الأساسية بيانات جهات الاتصال بيانات الغلاف الجوي
	الأسعار	قائمة الأسعار (عالميًا) قائمة الأسعار (الهند)

( الرجوع إلى الأعلى )

رمز التخزين التعريفي: Places – Text Search

	Category (الفئة)	Pro
	معرّف رمز التخزين التعريفي	‫E95A-86C7-7F47 (عالمي) ‎102E-888D-5596 (الهند)
	واجهات برمجة التطبيقات	البحث النصي (الإصدار القديم)
	الحدث القابل للفوترة	طلب ناجح إلى "البحث النصي" (الإصدار القديم)
	المشغّلات	خدمة البحث النصي عن الأماكن في Maps JavaScript API (textSearch()). خدمة "البحث النصي" في Places API تعرض طلبات "البحث النصي" قائمة بالأماكن، ولكن لا يمكن تحديد الحقول التي يتم عرضها. تعرض طلبات "البحث النصي" مجموعة فرعية من حقول البيانات المتوافقة. يتم تحصيل رسوم منك مقابل طلب "البحث النصي" وجميع رموز التخزين التعريفية لأنواع البيانات: البيانات الأساسية وبيانات الاتصال وبيانات الأجواء. رمز التخزين التعريفي: Places – Text Search يتم تفعيله أيضًا من خلال عنصر واجهة المستخدم Place SearchBox في Maps JavaScript API: طريقة getPlaces() بعد أن يختار المستخدم طلب بحث عن مكان (الرمز: المكبّر)، وليس نتيجة (الرمز: دبوس)، كما هو موضّح هنا: في نتائج تطبيق مربّع البحث المصغّر، بعد كتابة "بيتزا" في مربّع البحث، يُرجى ملاحظة أنّ توصيل البيتزا يظهر بجانبه رمز عدسة مكبّرة، ما يشير إلى أنّه طلب بحث عن مكان (وليس نتيجة). يؤدي رمز التخزين التعريفي هذا أيضًا إلى تفعيل الفوترة لرموز التخزين التعريفية للبيانات: بما أنّ طلب البحث النصي (القديم) يعرض جميع حقول البيانات المتاحة للمكان المحدّد، يمكن أن يؤدي ذلك إلى تفعيل فوترة إضافية لرموز التخزين التعريفية للبيانات: البيانات الأساسية وبيانات الاتصال وبيانات الأجواء. سيتم تحصيل رسوم منك مقابل رمز التخزين التعريفي هذا بالإضافة إلى البيانات التي تطلبها. لتجنُّب طلب بيانات لا تحتاج إليها (ودفع رسوم مقابلها)، استخدِم طلب العثور على مكان (قديم) بدلاً من ذلك.
	أمثلة	إذا قدّمت طلبًا باستخدام Text Search (القديمة)، ستعرض فاتورتك رموز التخزين التعريفية هذه عند عرض فاتورتك حسب رمز التخزين التعريفي: Places - Text Search البيانات الأساسية بيانات جهات الاتصال بيانات الغلاف الجوي
	الأسعار	قائمة الأسعار (عالميًا) قائمة الأسعار (الهند)

( الرجوع إلى الأعلى )

رمز التخزين التعريفي: تفاصيل الأماكن

	Category (الفئة)	Pro
	معرّف رمز التخزين التعريفي	‫FC5C-DF28-543F (عالميًا) F7AA-FEF9-C90E (الهند)
	واجهات برمجة التطبيقات	Place Details (Legacy)
	الحدث القابل للفوترة	تمت الموافقة على طلب الحصول على ميزات Pro
	المشغّلات	‫Android: حزمة تطوير برامج الأماكن لأجهزة Android (fetchPlace()) نظام التشغيل iOS: حزمة تطوير البرامج بالاستناد إلى الأماكن لنظام التشغيل iOS (fetchPlaceFromPlaceID:) ‫JavaScript: خدمة تفاصيل المكان في Maps JavaScript API (getDetails) ‫JavaScript: أداة الإكمال التلقائي للأماكن في Maps JavaScript API (getPlace) ‫JavaScript: عنصر واجهة مستخدم مربّع البحث عن الأماكن في Maps JavaScript API: طريقة getPlaces() بعد أن يختار المستخدم نتيجة مكان (الرمز: دبوس)، *وليس* طلب بحث (الرمز: عدسة مكبّرة)، كما هو موضّح هنا: في نتائج عنصر واجهة مستخدم مربّع البحث، بعد كتابة "بيتزا" في مربّع البحث، يُرجى ملاحظة أنّ بيتزا أوتنتيكو يظهر بجانبه رمز دبوس، ما يشير إلى أنّه نتيجة مكان (وليس طلب بحث). خدمة الويب: خدمة "تفاصيل المكان" (الإصدار القديم) عند استخدام واجهة برمجة التطبيقات والخدمات على الويب، يتم تحصيل رسوم مقابل رمز التخزين التعريفي لخدمة "تفاصيل المكان" سواء قدّمت رمزًا مميزًا للجلسة أم لا. يؤدي رمز التخزين التعريفي هذا أيضًا إلى تفعيل الفوترة لرموز التخزين التعريفية للبيانات: إذا أدرجت حقول بيانات في طلبك، يمكن أن يؤدي ذلك إلى تفعيل فوترة إضافية لرموز التخزين التعريفية للبيانات: البيانات الأساسية وبيانات الاتصال وبيانات الأجواء. حدِّد حقول البيانات التي تريد تجنُّب التكاليف غير الضرورية لها فقط. يتم تحصيل رسوم منك مقابل رمز التخزين التعريفي هذا بالإضافة إلى البيانات التي تطلبها.
	أمثلة	أجرِ إحدى المكالمات أو الطلبات التالية: الأجهزة الجوّالة: يمكنك استدعاء fetchPlace() على Android أو fetchPlaceFromPlaceID: على iOS، وتحديد حقل ADDRESS فقط واجهة برمجة تطبيقات الويب أو الخدمة: يمكنك تقديم طلب "تفاصيل المكان (الإصدار القديم)" وتحديد حقل العنوان فقط: getPlaceDetails(fields: formatted_address) في فاتورتك، ستظهر رموز التخزين التعريفية هذه (عند عرض فاتورتك حسب رمز التخزين التعريفي): تفاصيل الأماكن البيانات الأساسية أجرِ إحدى المكالمات أو الطلبات التالية: الأجهزة الجوّالة: يمكنك استدعاء fetchPlace() على Android أو fetchPlaceFromPlaceID: على iOS، وتحديد حقل PHONE_NUMBER فقط واجهة برمجة تطبيقات الويب أو الخدمة: قدِّم طلبًا للحصول على تفاصيل المكان (الإصدار القديم) وحدِّد حقل رقم الهاتف: getPlaceDetails(fields: formatted_phone_number) في فاتورتك، ستظهر رموز التخزين التعريفية هذه (عند عرض فاتورتك حسب رمز التخزين التعريفي): تفاصيل الأماكن بيانات جهات الاتصال أجرِ إحدى المكالمات أو الطلبات التالية: الأجهزة الجوّالة: يمكنك استدعاء fetchPlace() على Android أو fetchPlaceFromPlaceID: على iOS، وتحديد جميع الحقول واجهة برمجة تطبيقات الويب أو الخدمة: يمكنك تقديم طلب للحصول على تفاصيل المكان (القديمة) وتحديد جميع الحقول (هذا النوع من الطلبات هو التلقائي إذا لم تحدّد أي حقول): getPlaceDetails(). في فاتورتك، ستظهر رموز التخزين التعريفية هذه (عند عرض فاتورتك حسب رمز التخزين التعريفي): تفاصيل الأماكن البيانات الأساسية بيانات جهات الاتصال بيانات الغلاف الجوي
	الأسعار	قائمة الأسعار (عالميًا) قائمة الأسعار (الهند)

( الرجوع إلى الأعلى )

[ Enterprise: Places Legacy ]

رمز التخزين التعريفي: بيانات الغلاف الجوي

رمز تخزين تعريفي للبيانات يفوتر حقول بيانات الأجواء في طلب تفاصيل المكان أو العثور على مكان.

	Category (الفئة)	Enterprise
	معرّف رمز التخزين التعريفي	‫D63D-5CC5-302A (عالميًا) 0CE0-1963-137E (الهند)
	واجهات برمجة التطبيقات	تفاصيل المكان (الإصدار القديم) مع حقول الأجواء العثور على مكان (الإصدار القديم) مع حقول الأجواء
	الحدث القابل للفوترة	طلب ناجح لحقول بيانات Atmosphere
	المشغّلات	يتم تحصيل رسوم رمز التخزين التعريفي هذا بالإضافة إلى رمز التخزين التعريفي الأساسي (تفاصيل الأماكن أو البحث عن مكان أو البحث في الجوار أو البحث النصي) للطلب الذي أدّى إلى تفعيله.
	أمثلة على فوترة قناع الحقل	تتم فوترة طلبك استنادًا إلى الحقول المقدَّمة في قناع الحقول. على سبيل المثال: إذا كان قناع الحقل يتضمّن حقولاً من رمز التخزين التعريفي هذا فقط: يتم تحصيل رسوم الطلب وفقًا لسعر رمز التخزين التعريفي هذا. إذا كان قناع الحقل يتضمّن حقولاً من رموز تخزين تعريفية أخرى: تتم فوترة الطلب بأعلى سعر لرمز التخزين التعريفي للحقول المطلوبة. على سبيل المثال، إذا أدرجت حقولاً من رمز تخزين تعريفي لـ Essentials ورمز تخزين تعريفي لـ Enterprise، تتم فوترة الطلب بسعر رمز التخزين التعريفي لـ Enterprise.
	الأسعار	قائمة الأسعار (عالميًا) قائمة الأسعار (الهند)

( الرجوع إلى الأعلى )

رمز التخزين التعريفي: بيانات جهات الاتصال

رمز تخزين تعريفي للبيانات يفوتر حقول بيانات الاتصال في طلب تفاصيل المكان أو العثور على مكان.

	Category (الفئة)	Enterprise
	معرّف رمز التخزين التعريفي	F095-CD01-81B2 (عالمي) A03F-5079-C66C (الهند)
	واجهات برمجة التطبيقات	تفاصيل المكان (الإصدار القديم) مع حقول جهات الاتصال العثور على مكان (الإصدار القديم) مع حقول جهات الاتصال
	الحدث القابل للفوترة	طلب ناجح لحقول "بيانات الاتصال"
	المشغّلات	حقول حزمة تطوير البرامج (SDK) لنظام التشغيل 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 حقول حزمة تطوير البرامج (SDK) لنظام التشغيل iOS GMSPlaceFieldOpeningHours GMSPlaceFieldPhoneNumber GMSPlaceFieldWebsite حقول خدمة الويب formatted_phone_number international_phone_number opening_hours current_opening_hours secondary_opening_hours website يتم تحصيل رسوم رمز التخزين التعريفي هذا بالإضافة إلى رمز التخزين التعريفي الأساسي (تفاصيل الأماكن أو البحث عن مكان أو البحث في الجوار أو البحث النصي) للطلب الذي أدّى إلى تفعيله.
	الفوترة حسب قناع الحقل	تتم فوترة طلبك استنادًا إلى الحقول المقدَّمة في قناع الحقول. على سبيل المثال: إذا كان قناع الحقل يتضمّن حقولاً من رمز التخزين التعريفي هذا فقط: يتم تحصيل رسوم الطلب وفقًا لسعر رمز التخزين التعريفي هذا. إذا كان قناع الحقل يتضمّن حقولاً من رموز تخزين تعريفية أخرى: تتم فوترة الطلب بأعلى سعر لرمز التخزين التعريفي للحقول المطلوبة. على سبيل المثال، إذا أدرجت حقولاً من رمز تخزين تعريفي لـ Essentials ورمز تخزين تعريفي لـ Enterprise، تتم فوترة الطلب بسعر رمز التخزين التعريفي لـ Enterprise.
	الأسعار	قائمة الأسعار (عالميًا) قائمة الأسعار (الهند)

( الرجوع إلى الأعلى )

رمز التخزين التعريفي: Places Photo

	Category (الفئة)	Enterprise
	معرّف رمز التخزين التعريفي	‫81E7-85D0-58A7 (في كلّ أنحاء العالم) ‫9F4B-2E19-1B63 (الهند)
	واجهات برمجة التطبيقات	Places Photo (الإصدار القديم)
	الحدث القابل للفوترة	طلب ناجح للحصول على صورة
	المشغّلات	‫Android: طلبات إلى fetchPhoto() أجهزة iOS: طلبات الوصول إلى loadPlacePhoto: ‫JavaScript: طلبات إلى PlacePhoto.getUrl() لتحميل بيانات بكسل الصورة خدمة الويب: الطلبات المُرسَلة إلى خدمة "صور الأماكن" في Places API
	الأسعار	قائمة الأسعار (عالميًا) قائمة الأسعار (الهند)

( الرجوع إلى الأعلى )

رموز تخزين واجهة برمجة التطبيقات القديمة Routes API

[ Essentials: Routes Legacy ]

SKU: Directions

	Category (الفئة)	Essentials
	معرّف رمز التخزين التعريفي	‫28A8-3EB4-4595 (عالميًا) ‎4714-291C-3199 (الهند)
	واجهات برمجة التطبيقات	خدمة الاتجاهات في Maps JavaScript API، Directions API (الإصدار القديم)
	الحدث القابل للفوترة	طلب ناجح بدون ميزات Pro أو Enterprise
	المشغّلات	طلبات البحث التي لا تؤدي إلى عرض رمز تخزين تعريفي بتقييم أعلى
	الأسعار	قائمة الأسعار (عالميًا) قائمة الأسعار (الهند)

( الرجوع إلى الأعلى )

رمز التخزين التعريفي: Distance Matrix

	Category (الفئة)	Essentials
	معرّف رمز التخزين التعريفي	‫C1B6-FF9D-7700 (على مستوى العالم) 558A-4F88-F361 (الهند)
	واجهات برمجة التطبيقات	‫Distance Matrix API (الإصدار القديم)، خدمة Distance Matrix في Maps JavaScript API
	الحدث القابل للفوترة	كل عنصر لا يحتوي على ميزات Pro أو Enterprise يؤدي كل طلب يتم إرساله إلى Distance Matrix API إلى إنشاء عناصر، حيث يساوي عدد origins مضروبًا في عدد destinations عدد العناصر.
	المشغّلات	طلبات العناصر التي لا تؤدي إلى تفعيل رموز التخزين التعريفي الأعلى سعرًا
	الأسعار	قائمة الأسعار (عالميًا) قائمة الأسعار (الهند)

( الرجوع إلى الأعلى )

[ Pro: Routes Legacy ]

رمز التخزين التعريفي: Directions Advanced

	Category (الفئة)	Pro
	معرّف رمز التخزين التعريفي	9407-00C2-CF85 (عالميًا) E27B-BD57-FD7D (الهند)
	واجهات برمجة التطبيقات	خدمة الاتجاهات في Maps JavaScript API، Directions API (الإصدار القديم)
	الحدث القابل للفوترة	طلب ناجح يتضمّن ميزات Pro
	المشغّلات	duration_in_traffic. بين 11 و25 نقطة على المسار اضبط waypoints=optimize:true. اضبط أحد مُعدِّلات الموقع الجغرافي التالية: side_of_road heading
	الأسعار	قائمة الأسعار (عالميًا) قائمة الأسعار (الهند)

( الرجوع إلى الأعلى )

رمز التخزين التعريفي: Distance Matrix Advanced

	Category (الفئة)	Pro
	معرّف رمز التخزين التعريفي	DFAE-763F-CF6E (عالميًا) C0F4-32AE-F6D1 (الهند)
	واجهات برمجة التطبيقات	‫Distance Matrix API (الإصدار القديم)، خدمة Distance Matrix في Maps JavaScript API
	الحدث القابل للفوترة	كل عنصر عاد بميزات Pro. يؤدي كل طلب يتم إرساله إلى Distance Matrix API إلى إنشاء عناصر، حيث يساوي عدد origins مضروبًا في عدد destinations عدد العناصر.
	المشغّلات	duration_in_traffic. اضبط أحد مُعدِّلات الموقع الجغرافي التالية: side_of_road heading
	الأسعار	قائمة الأسعار (عالميًا) قائمة الأسعار (الهند)

( الرجوع إلى الأعلى )

صفحات تفاصيل رموز التخزين التعريفية ذات الصلة

• نظرة عامة على تفاصيل استخدام واجهة برمجة التطبيقات: دليل كامل لوحدات تخزين البيانات منظَّم حسب فئات Essentials وPro وEnterprise وLegacy.
• تفاصيل رموز التخزين التعريفية في "خرائط Google": رموز التخزين التعريفية لكلّ من "حزمة تطوير البرامج بالاستناد إلى بيانات خرائط Google للتطبيقات المتوافقة مع Android" و"حزمة تطوير البرامج بالاستناد إلى بيانات خرائط Google للتطبيقات المتوافقة مع iOS" وMaps JavaScript API وMaps Embed API وMaps Static API وStreet View Static API وElevation API وAerial View API وMap Tiles API.
• تفاصيل رموز التخزين التعريفية لمنتجات Routes: رموز التخزين التعريفية لمنتجات Routes API وRoute Optimization API وRoads API وNavigation SDK
• تفاصيل رموز التخزين التعريفية في Places (New): Places API (New) و"حزمة أدوات خرائط Google الجاهزة للأماكن" وPlaces Aggregate API وAddress Validation API وGeocoding API وGeolocation API وTime Zone API وMaps Grounding Lite.
• تفاصيل رموز التخزين التعريفية الخاصة بالبيئة: رموز التخزين التعريفية لكل من Air Quality API وPollen API وSolar API وWeather API.
• أسعار "منصة خرائط Google" والأسعار في الهند: فئات الحجم الشهري والأسعار لكل حدث