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

تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

استخدام واجهة برمجة التطبيقات Maps JavaScript API والفوترة

تستخدم واجهة برمجة التطبيقات Maps JavaScript API نموذج تسعير "الدفع حسب الاستخدام". تؤدي طلبات واجهة برمجة التطبيقات JavaScript لخرائط Google إلى إجراء مكالمات إلى رقمَي تعريف منتج مختلفَين حسب نوع الطلب: عمليات تحميل الخرائط أو المناظر البانورامية. يتم تحديد أسعار طلبات البيانات من Places Library وMaps JavaScript API وخدمات JavaScript الأخرى بشكل منفصل عن أسعار رموز التخزين التعريفية الأصلية لـ JavaScript. بالإضافة إلى بنود استخدام Google العامة، هناك حدود استخدام خاصة بواجهة برمجة التطبيقات Maps JavaScript API. إدارة التكاليف ومستوى الاستخدام باستخدام الأدوات المتاحة في Google Cloud Console

كيفية فوترة واجهة برمجة التطبيقات Maps JavaScript API

تستخدم واجهة برمجة التطبيقات Maps JavaScript API نموذج الدفع حسب الاستخدام. يتم تحصيل رسوم واجهات برمجة التطبيقات وحِزم تطوير البرامج (SDK) في "منصة خرائط Google" حسب رمز التخزين التعريفي. يتم تتبُّع الاستخدام لكل رمز تخزين تعريفي، وقد تحتوي أي واجهة برمجة تطبيقات أو حزمة تطوير برامج (SDK) على أكثر من رمز تخزين تعريفي للمنتج واحد. يتم احتساب التكلفة من خلال

استخدام رمز التخزين التعريفي × السعر لكل استخدام

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

أسعار Maps JavaScript API

رمز التخزين التعريفي: الخرائط الديناميكية

تطبيق يعرض خريطة تم تحميلها باستخدام معرّف خريطة أو بدونه باستخدام واجهة برمجة تطبيقات JavaScript للخرائط، أو خريطة تم تحميلها باستخدام معرّف خريطة وباستخدام إما حزمة تطوير البرامج (SDK) لتطبيق "خرائط Google" لنظام التشغيل Android أو حزمة تطوير البرامج (SDK) لتطبيق "خرائط Google" لنظام التشغيل iOS

نطاق الحجم الشهري (السعر لكل تحميل خريطة)
0 إلى 100,000	من 100,001 إلى 500,000	أكثر من 500,000
‫0.007 دولار أمريكي لكل (7.00 دولار أمريكي لكل 1,000)	‫0.0056 دولار أمريكي لكل (5.60 دولار أمريكي لكل 1,000)	التواصل مع فريق المبيعات لمعرفة أسعار الكميات الكبيرة

لا تؤدي تفاعلات المستخدم مع الخريطة، مثل التمرير أو التصغير أو التكبير أو تبديل طبقات الخريطة، إلى توليد عمليات تحميل إضافية للخريطة.

رمز التخزين التعريفي: "التجوّل الافتراضي" الديناميكي

يتم الآن تحصيل رسوم منفصلة مقابل تحميل الخرائط والصور البانورامية في "التجوّل الافتراضي". يتم تحصيل رسوم منك مقابل كلّ إنشاء لعنصر بانوراما في تطبيق Maps JavaScript API أو حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" لتطبيقات Android أو حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" لتطبيقات iOS.

نطاق الحجم الشهري (السعر لكل بانوراما)
0 إلى 100,000	من 100,001 إلى 500,000	أكثر من 500,000
‫0.014 دولار أمريكي لكل (14.00 دولار أمريكي لكل 1,000)	‫0.0112 دولار أمريكي لكل (11.20 دولار أمريكي لكل 1,000)	التواصل مع فريق المبيعات لمعرفة أسعار الكميات الكبيرة

تحدث عملية إنشاء مثيل لكائن بانوراما:

في JavaScript، باستخدام فئة google.maps.StreetViewPanorama() أو الطريقة Map.getStreetView() لا يتم تحصيل رسوم مقابل استخدام تجربة "التجوّل الافتراضي" المضمّنة والمستندة إلى عنصر التحكّم "الدليل" في "التجوّل الافتراضي" أو استخدام فئة StreetViewService().
على Android، باستخدام إحدى فئات StreetViewPanoramaFragment أو SupportStreetViewPanoramaFragment أو StreetViewPanoramaView يتم احتساب صورة بانورامية في كل مرة يتم فيها استدعاء الطريقة onCreate() ذات الصلة.
على iOS، باستخدام العنصر GMSPanoramaView

أسعار Places Library وMaps JavaScript API

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

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

يتم تحصيل الرسوم أيضًا في حال استخدام الرموز المميّزة للجلسات وتنفيذ أيّ مما يلي:

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

نطاق الحجم الشهري (السعر لكل مكالمة)
0 إلى 100,000	من 100,001 إلى 500,000	أكثر من 500,000
‫0.00283 دولار أمريكي لكل (2.83 دولار أمريكي لكل 1,000)	‫0.00227 دولار أمريكي لكل (2.27 دولار أمريكي لكل 1,000)	التواصل مع فريق المبيعات لمعرفة أسعار الكميات الكبيرة

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

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

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

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

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

ملاحظة: في حال إجراء مكالمة إلى SKU: تفاصيل المكان (الموقع الجغرافي فقط) ثم مكالمة إلى SKU: الإجراء المفضّل للتحقّق من العنوان قبل انتهاء صلاحية رمز الجلسة، لن يتم تحصيل رسوم المكالمة SKU: تفاصيل المكان (الموقع الجغرافي فقط) وسيتم تحصيل رسوم الجلسة فقط مقابل المكالمة التي تم إجراؤها إلى SKU: الإجراء المفضّل للتحقّق من العنوان.

نطاق الحجم الشهري (السعر لكل مكالمة)
0 إلى 100,000	من 100,001 إلى 500,000	أكثر من 500,000
‫0.00 دولار أمريكي لكل (0.00 دولار أمريكي لكل 1,000)	‫0.00 دولار أمريكي لكل (0.00 دولار أمريكي لكل 1,000)	‫0.00 دولار أمريكي لكل (0.00 دولار أمريكي لكل 1,000)

رمز التخزين التعريفي: تفاصيل المكان (المعرّفات فقط)

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

Places Library، واجهة برمجة التطبيقات JavaScript لتطبيق "خرائط Google": id، photos

نطاق الحجم الشهري (السعر لكل مكالمة)
0 إلى 100,000	من 100,001 إلى 500,000	أكثر من 500,000
0.0 دولار أمريكي لكل (0.00 دولار أمريكي لكل 1,000)	0.0 دولار أمريكي لكل (0.00 دولار أمريكي لكل 1,000)	0.0 دولار أمريكي لكل (0.00 دولار أمريكي لكل 1,000)

رمز التخزين التعريفي: تفاصيل المكان (الموقع الجغرافي فقط)

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

Places Library، واجهة برمجة التطبيقات JavaScript API في "خرائط Google": addressComponents، adrFormatAddress، formattedAddress، location، plusCode، types، viewport

نطاق الحجم الشهري (السعر لكل مكالمة)
0 إلى 100,000	من 100,001 إلى 500,000	أكثر من 500,000
‫0.005 دولار أمريكي لكل (5.00 دولار أمريكي لكل 1,000)	‫0.004 دولار أمريكي لكل (4.00 دولار أمريكي لكل 1,000)	التواصل مع فريق المبيعات لمعرفة أسعار الكميات الكبيرة

رمز التخزين التعريفي: تفاصيل المكان (أساسية)

Places Library، واجهة برمجة التطبيقات JavaScript API في "خرائط Google": accessibilityOptions، businessStatus، displayName، googleMapsUri، iconBackgroundColor، primaryTypeDisplayName، svgIconMaskURI، types، utcOffsetMinutes

نطاق الحجم الشهري (السعر لكل مكالمة)
0 إلى 100,000	من 100,001 إلى 500,000	أكثر من 500,000
‫0.0170 دولار أمريكي لكل (17.00 دولار أمريكي لكل 1,000)	‫0.0136 دولار أمريكي لكل (13.60 دولار أمريكي لكل 1,000)	التواصل مع فريق المبيعات لمعرفة أسعار الكميات الكبيرة

رمز التخزين التعريفي: تفاصيل المكان (إعداد متقدّم)

Places Library، وMaps JavaScript API: internationalPhoneNumber، nationalPhoneNumber، priceLevel، rating، regularOpeningHours، userRatingCount، websiteUri

نطاق الحجم الشهري (السعر لكل مكالمة)
0 إلى 100,000	من 100,001 إلى 500,000	أكثر من 500,000
‫0.020 دولار أمريكي لكل (20.00 دولار أمريكي لكل 1,000)	‫0.016 دولار أمريكي لكل (16.00 دولار أمريكي لكل 1,000)	التواصل مع فريق المبيعات لمعرفة أسعار الكميات الكبيرة

رمز التخزين التعريفي: تفاصيل المكان (الخيار المفضّل)

Places Library، واجهة برمجة التطبيقات JavaScript لتطبيق "خرائط Google": 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

نطاق الحجم الشهري (السعر لكل مكالمة)
0 إلى 100,000	من 100,001 إلى 500,000	أكثر من 500,000
‫0.025 دولار أمريكي لكل (25.00 دولار أمريكي لكل 1,000)	‫0.020 دولار أمريكي لكل (20.00 دولار أمريكي لكل 1,000)	التواصل مع فريق المبيعات لمعرفة أسعار الكميات الكبيرة

رمز التخزين التعريفي: ميزة "البحث في الأماكن القريبة" (أساسية)

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

Places Library، واجهة برمجة التطبيقات JavaScript لتطبيق "خرائط Google": accessibilityOptions، addressComponents، adrFormatAddress، businessStatus، displayName، formattedAddress، googleMapsUri، iconBackgroundColor، id، location، photos، plusCode، svgIconMaskURI، types، utcOffsetMinutes، viewport

نطاق الحجم الشهري (السعر لكل مكالمة)
0 إلى 100,000	من 100,001 إلى 500,000	أكثر من 500,000
‫0.032 دولار أمريكي لكل (32.00 دولار أمريكي لكل 1,000)	‫0.0256 دولار أمريكي لكل (25.60 دولار أمريكي لكل 1,000)	التواصل مع فريق المبيعات لمعرفة أسعار الكميات الكبيرة

رمز التخزين التعريفي: البحث في الأماكن القريبة (متقدّم)

Places Library، وMaps JavaScript API: internationalPhoneNumber، nationalPhoneNumber، priceLevel، rating، regularOpeningHours، userRatingCount، websiteUri

نطاق الحجم الشهري (السعر لكل مكالمة)
0 إلى 100,000	من 100,001 إلى 500,000	أكثر من 500,000
‫0.035 دولار أمريكي لكل (35.00 دولار أمريكي لكل 1,000)	‫0.028 دولار أمريكي لكل (28.00 دولار أمريكي لكل 1,000)	التواصل مع فريق المبيعات لمعرفة أسعار الكميات الكبيرة

رمز التخزين التعريفي: البحث في الأماكن القريبة (الخيار المفضّل)

نطاق الحجم الشهري (السعر لكل مكالمة)
0 إلى 100,000	من 100,001 إلى 500,000	أكثر من 500,000
‫0.040 دولار أمريكي لكل (40.00 دولار أمريكي لكل 1,000)	‫0.032 دولار أمريكي لكل (32.00 دولار أمريكي لكل 1,000)	التواصل مع فريق المبيعات لمعرفة أسعار الكميات الكبيرة

رمز التخزين التعريفي: البحث النصي (المعرّف فقط)

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

مكتبة "الأماكن"، واجهة برمجة التطبيقات JavaScript API في "خرائط Google": id

نطاق الحجم الشهري (السعر لكل مكالمة)
0 إلى 100,000	من 100,001 إلى 500,000	أكثر من 500,000
0.0 دولار أمريكي لكل (0.00 دولار أمريكي لكل 1,000)	0.0 دولار أمريكي لكل (0.00 دولار أمريكي لكل 1,000)	0.0 دولار أمريكي لكل (0.00 دولار أمريكي لكل 1,000)

رمز التخزين التعريفي: البحث بالكتابة (أساسي)

مكتبة "الأماكن"، واجهة برمجة التطبيقات JavaScript API في "خرائط Google": accessibilityOptions، addressComponents، adrFormatAddress، businessStatus، displayName، formattedAddress، googleMapsUri، iconBackgroundColor، location، photos، plusCode، svgIconMaskURI، types، utcOffsetMinutes، viewport

نطاق الحجم الشهري (السعر لكل مكالمة)
0 إلى 100,000	من 100,001 إلى 500,000	أكثر من 500,000
‫0.032 دولار أمريكي لكل (32.00 دولار أمريكي لكل 1,000)	‫0.0256 دولار أمريكي لكل (25.60 دولار أمريكي لكل 1,000)	التواصل مع فريق المبيعات لمعرفة أسعار الكميات الكبيرة

رمز التخزين التعريفي: البحث النصي (متقدّم)

Places Library، واجهة برمجة التطبيقات JavaScript API في "خرائط Google": internationalPhoneNumber، nationalPhoneNumber، priceLevel، rating، regularOpeningHours، userRatingCount، websiteUri

نطاق الحجم الشهري (السعر لكل مكالمة)
0 إلى 100,000	من 100,001 إلى 500,000	أكثر من 500,000
‫0.035 دولار أمريكي لكل (35.00 دولار أمريكي لكل 1,000)	‫0.028 دولار أمريكي لكل (28.00 دولار أمريكي لكل 1,000)	التواصل مع فريق المبيعات لمعرفة أسعار الكميات الكبيرة

رمز التخزين التعريفي: البحث النصي (الخيار المفضّل)

نطاق الحجم الشهري (السعر لكل مكالمة)
0 إلى 100,000	من 100,001 إلى 500,000	أكثر من 500,000
‫0.040 دولار أمريكي لكل (40.00 دولار أمريكي لكل 1,000)	‫0.032 دولار أمريكي لكل (32.00 دولار أمريكي لكل 1,000)	التواصل مع فريق المبيعات لمعرفة أسعار الكميات الكبيرة

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

يتم تحصيل رسوم رمز التخزين التعريفي Place Photo مقابل كل طلب يتم إرساله إلى واجهة برمجة التطبيقات.

نطاق الحجم الشهري (السعر لكل مكالمة)
0 إلى 100,000	من 100,001 إلى 500,000	أكثر من 500,000
‫0.007 دولار أمريكي لكل (7.00 دولار أمريكي لكل 1,000)	‫0.0056 دولار أمريكي لكل (5.60 دولار أمريكي لكل 1,000)	التواصل مع فريق المبيعات لمعرفة أسعار الكميات الكبيرة

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

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

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

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

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

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

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

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

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

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

Android: كل طلب إلى fetchPlace() أو findCurrentPlace()
iOS: كل مكالمة إلى fetchPlaceFromPlaceID: أو findPlaceLikelihoodsFromCurrentLocationWithPlaceFields:
خدمة الويب: كل طلب من طلبات "الأماكن" استنادًا إلى الحقول المحدّدة في الطلب

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

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

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

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

الأماكن - البحث عن الأماكن المجاورة
الأماكن: البحث النصي

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

باستخدام مَعلمة fields في طلب "تفاصيل المكان" أو "العثور على مكان"، يمكنك حصر الجواب بالردّ على الحقول المحدّدة فقط. يتم تضمين الحقول في الفئة أساسي في التكلفة الأساسية لطلب "الأماكن" ولا تؤدي إلى تحصيل أي رسوم إضافية. يتم تنشيط رمز التخزين التعريفي البيانات الأساسية عند طلب أيٍّ من الحقول التالية:

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

ملاحظة: تم إيقاف حقول Place.Field.ADDRESS وPlace.Field.ICON_URL Place.Field.LAT_LNG وPlace.Field.NAME Place.Field.WHEELCHAIR_ACCESSIBLE_ENTRANCE نهائيًا في الإصدار 4.0 من حزمة SDK لتطبيق "الأماكن" على نظام التشغيل Android. استخدِم Place.Field.FORMATTED_ADDRESS وPlace.Field.ICON_MASK_URL Place.Field.LOCATION Place.Field.DISPLAY_NAME وPlace.ACCESSIBILITY_OPTIONS بدلاً من ذلك. لا تتوفّر Place.Field.ACCESSIBILITY_OPTIONS إلا لميزة "تفاصيل المكان" (الجديدة).

أجهزة 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

نطاق الحجم الشهري (السعر لكل مكالمة)
0 إلى 100,000	من 100,001 إلى 500,000	أكثر من 500,000
تكلفة طلب ميزة "الأماكن" + 0.00 دولار أمريكي	تكلفة طلب ميزة "الأماكن" + 0.00 دولار أمريكي	تكلفة طلب ميزة "الأماكن" + 0.00 دولار أمريكي

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

باستخدام مَعلمة fields في طلب "تفاصيل المكان" أو "العثور على مكان" لخدمات الويب، أو صفيف من Place.Field لنظامَي التشغيل Android أو iOS، يمكنك حصر الاستجابة بالحقول المحدّدة فقط. تؤدي الحقول في فئة جهة الاتصال إلى تحصيل رسوم إضافية. يتم تنشيط رمز التخزين التعريفي Contact Data عند طلب أيّ من الحقول التالية:

Android: Place.Field.CURRENT_OPENING_HOURS أو Place.Field.INTERNATIONAL_PHONE_NUMBER أو Place.Field.OPENING_HOURS أو Place.Field.SECONDARY_OPENING_HOURS أو Place.Field.WEBSITE_URI

ملاحظة: تم إيقاف حقل Place.Field.PHONE_NUMBER نهائيًا في الإصدار 4.0 من حزمة تطوير البرامج (SDK) لتطبيق "الأماكن" لنظام التشغيل Android. استخدِم Place.Field.INTERNATIONAL_PHONE_NUMBER بدلاً من ذلك.

iOS: GMSPlaceFieldOpeningHours أو GMSPlaceFieldPhoneNumber أو GMSPlaceFieldWebsite
خدمة ويب: formatted_phone_number international_phone_number أو opening_hours current_opening_hours أو secondary_opening_hours website

نطاق الحجم الشهري (السعر لكل مكالمة)
0 إلى 100,000	من 100,001 إلى 500,000	أكثر من 500,000
تكلفة طلب أماكن + 0.003 دولار أمريكي لكل مكان (+ 3.00 دولار أمريكي لكل 1,000 مكان)	تكلفة طلب أماكن + 0.0024 دولار أمريكي لكل طلب (+ 2.40 دولار أمريكي لكل 1,000 طلب)	التواصل مع فريق المبيعات لمعرفة أسعار الكميات الكبيرة

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

باستخدام مَعلمة fields في طلب "تفاصيل المكان" أو "العثور على مكان"، يمكنك حصر الاستجابة بالحقول المحدّدة فقط. تؤدي الحقول في فئة الجو إلى تحمّل رسوم إضافية. يتم بدء رمز التخزين التعريفي بيانات الغلاف الجوي عند طلب أيّ من الحقول التالية:

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 أو Place.Field.USER_RATING_COUNT

ملاحظة: تم إيقاف حقل Place.Field.USER_RATINGS_TOTAL نهائيًا في الإصدار 4.0 من حزمة تطوير البرامج (SDK) لنظام التشغيل Places على Android. استخدِم Place.Field.USER_RATING_COUNT بدلاً من ذلك.
أجهزة iOS: GMSPlaceFieldPriceLevel وGMSPlaceFieldRating GMSPlaceFieldUserRatingsTotal وGMSPlaceFieldTakeout وGMSPlaceFieldDelivery وGMSPlaceFieldDineIn وGMSPlaceFieldCurbsidePickup GMSPlaceFieldReservable وGMSPlaceFieldServesBreakfast وGMSPlaceFieldServesLunch وGMSPlaceFieldServesDinner وGMSPlaceFieldServesBeer GMSPlaceFieldServesWine أو GMSPlaceFieldServesBrunch أو GMSPlaceFieldServesVegetarianFood
JavaScript: راجِع الحقول (تفاصيل المكان).
خدمة الويب: curbside_pickup أو delivery أو dine_in editorial_summary أو price_level أو rating أو reservable reviews أو serves_beer أو serves_breakfast أو serves_brunch serves_dinner أو serves_lunch أو serves_vegetarian_food أو serves_wine takeout أو user_ratings_total

نطاق الحجم الشهري (السعر لكل مكالمة)
0 إلى 100,000	من 100,001 إلى 500,000	أكثر من 500,000
تكلفة طلب أماكن + 0.005 دولار أمريكي لكل مكان (+ 5.00 دولار أمريكي لكل 1,000 مكان)	تكلفة طلب أماكن + 0.004 دولار أمريكي لكل طلب (+ 4.00 دولار أمريكي لكل 1,000 طلب)	التواصل مع فريق المبيعات لمعرفة أسعار الكميات الكبيرة

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

يتم تحصيل رسوم رمز التخزين التعريفي الإكمال التلقائي لكل طلب مقابل أي من هذه المكالمات أو الطلبات التي لا تتضمّن رمزًا مميزًا للجلسة:

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

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

قد يتم تحصيل رسوم من طلبات الإكمال التلقائي الواردة من واجهة برمجة التطبيقات JavaScript API لتطبيق "خرائط Google" شريط التطبيقات المصغّر للإكمال التلقائي للأماكن، وذلك مقابل رمز التخزين التعريفي Autocomplete – Per Request في حال إجراء طلبات من جلسة إكمال تلقائي غير صالحة. قد يحدث ذلك عندما يكتب المستخدم عناوين مختلفة متعددة أو ينسخ عناوين مختلفة أو يلصقها في التطبيق المصغّر ولا يختار دائمًا اقتراحًا للإكمال التلقائي.

نطاق الحجم الشهري (السعر لكل طلب)
0 إلى 100,000	من 100,001 إلى 500,000	أكثر من 500,000
‫0.00283 دولار أمريكي لكل (2.83 دولار أمريكي لكل 1,000)	‫0.00227 دولار أمريكي لكل (2.27 دولار أمريكي لكل 1,000)	التواصل مع فريق المبيعات لمعرفة أسعار الكميات الكبيرة

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

يتم تحصيل رسوم رمز التخزين التعريفي الإكمال التلقائي بدون تفاصيل الأماكن - لكل جلسة مقابل جلسة الإكمال التلقائي التي لا تتضمّن طلب تفاصيل الأماكن (خلال بضع دقائق من بدء الجلسة).

نطاق الحجم الشهري (السعر لكل جلسة)
0 إلى 100,000	من 100,001 إلى 500,000	أكثر من 500,000
‫0.017 دولار أمريكي لكل (17.00 دولار أمريكي لكل 1,000)	‫0.0136 دولار أمريكي لكل (13.60 دولار أمريكي لكل 1,000)	التواصل مع فريق المبيعات لمعرفة أسعار الكميات الكبيرة

مثال

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

Android

findAutocompletePredictions() (.setQuery(”par”), .setSessionToken(XYZ))
findAutocompletePredictions() (.setQuery(”paris”), .setSessionToken(XYZ))

iOS

خدمة ويب

طلب الإكمال التلقائي للأماكن (input=”par”, session_token: XYZ)
طلب الإكمال التلقائي للأماكن (input=”paris”, session_token: XYZ)

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

الإكمال التلقائي بدون تفاصيل عن المكان - لكل جلسة (يبدأ السعر من 0.017 دولار أمريكي لكل جلسة)

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

يتم تحصيل رسوم ميزة الإكمال التلقائي (المضمّنة في تفاصيل الأماكن) – لكل جلسة من رمز التخزين التعريفي مقابل جلسة الإكمال التلقائي التي تتضمّن أيًا مما يلي:

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

يتوفر طلب الإكمال التلقائي بدون أي رسوم، ويتم تحصيل رسوم الاتصال اللاحق بـ "تفاصيل الأماكن" استنادًا إلى أسعار "تفاصيل الأماكن" العادية.

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

في حال عدم تحديد الحقول في طلب "تفاصيل المكان"، يتم تنشيط جميع رموز التخزين التعريفية للبيانات (الأساسية وجهات الاتصال والجو).

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

نطاق الحجم الشهري (السعر لكل جلسة)
0 إلى 100,000	من 100,001 إلى 500,000	أكثر من 500,000
0.00 دولار أمريكي	0.00 دولار أمريكي	0.00 دولار أمريكي

مثال

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

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)

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

ميزة الإكمال التلقائي (مضمّنة في "تفاصيل الأماكن") - لكل جلسة (يتم تحصيل رسوم بقيمة 0.00 دولار أمريكي)
تفاصيل المكان (يبدأ السعر من 0.017 دولار أمريكي لكل جلسة)
البيانات الأساسية (يتم تحصيل رسوم بقيمة 0.00 دولار أمريكي)

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

يتم تحصيل رسوم رمز التخزين التعريفي إكمال طلبات البحث تلقائيًا - لكل طلب مقابل كل طلب من أجل:

JavaScript: تشمل هذه الواجهة خدمة الإكمال التلقائي للأماكن في واجهة برمجة تطبيقات JavaScript للخرائط (getQueryPredictions()) واستخدام العنصر المكوّن SearchBox في واجهة برمجة تطبيقات JavaScript للخرائط (يتم توليد طلبات الإكمال التلقائي للطلبات أثناء كتابة المستخدم).
خدمة ويب: خدمة الإكمال التلقائي لطلبات البحث في Places API

نطاق الحجم الشهري (السعر لكل طلب)
0 إلى 100,000	من 100,001 إلى 500,000	أكثر من 500,000
‫0.00283 دولار أمريكي لكل (2.83 دولار أمريكي لكل 1,000)	‫0.00227 دولار أمريكي لكل (2.27 دولار أمريكي لكل 1,000)	التواصل مع فريق المبيعات لمعرفة أسعار الكميات الكبيرة

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

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

يتم تحصيل رسوم المكالمات إلى "تفاصيل الأماكن" على النحو التالي:

نطاق الحجم الشهري (السعر لكل مكالمة)
0 إلى 100,000	من 100,001 إلى 500,000	أكثر من 500,000
‫0.017 دولار أمريكي لكل (17.00 دولار أمريكي لكل 1,000)	‫0.0136 دولار أمريكي لكل (13.60 دولار أمريكي لكل 1,000)	التواصل مع فريق المبيعات لمعرفة أسعار الكميات الكبيرة

يتم إنشاء رمز التخزين التعريفي تفاصيل الأماكن من واجهات برمجة التطبيقات التالية:

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

في نتائج أداة مربّع البحث، بعد كتابة "بيتزا" في مربع بحث، لاحظ أنّ Pizza Autentico يظهر بجانبها رمز دبوس، ما يشير إلى أنّه هو نتيجة مكان (وليس طلب بحث).
خدمة الويب: خدمة "تفاصيل الأماكن" في Places API

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

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

أمثلة

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

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

استخدِم طلب "تفاصيل الأماكن" من أجل إعادة تحميل معرّفات الأماكن القديمة. تتوفّر هذه الأنواع من الطلبات بدون أي رسوم.

نطاق الحجم الشهري (السعر لكل مكالمة)
0 إلى 100,000	من 100,001 إلى 500,000	أكثر من 500,000
0.00 دولار أمريكي	0.00 دولار أمريكي	0.00 دولار أمريكي

مثال

قدِّم طلبًا للحصول على تفاصيل المكان مع تحديد حقل رقم تعريف المكان فقط: getPlaceDetails(fields: place_id). سيظهر لك رمز التخزين التعريفي هذا في فاتورتك (عند عرض فاتورتك حسب رمز التخزين التعريفي):

تفاصيل الأماكن - إعادة تحميل رقم التعريف (يتم تحصيل رسوم بقيمة 0.00 دولار أمريكي)

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

يتم تحصيل رسوم من البحث عن مكان مقابل طلب البحث عن مكان.

نطاق الحجم الشهري (السعر لكل مكالمة)
0 إلى 100,000	من 100,001 إلى 500,000	أكثر من 500,000
‫0.017 دولار أمريكي لكل (17.00 دولار أمريكي لكل 1,000)	‫0.0136 دولار أمريكي لكل (13.60 دولار أمريكي لكل 1,000)	التواصل مع فريق المبيعات لمعرفة أسعار الكميات الكبيرة

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

أمثلة

يمكنك تقديم طلب "العثور على مكان" وتحديد حقل العنوان فقط: FindPlace(fields: formatted_address). ستظهر لك رموز التخزين التعريفية هذه في فاتورتك (عند عرض فاتورتك حسب رمز التخزين التعريفي):
- العثور على مكان (يبدأ السعر من 0.017 دولار أمريكي لكل مكالمة)
- البيانات الأساسية (يتم تحصيل رسوم بقيمة 0.00 دولار أمريكي)
يمكنك تقديم طلب "العثور على مكان" وتحديد حقل رقم الهاتف: FindPlace(fields: formatted_phone_number). ستظهر في فاتورتك رموز التخزين التعريفية هذه (عند عرض فاتورتك حسب رمز التخزين التعريفي):
- العثور على مكان (يبدأ السعر من 0.017 دولار أمريكي لكل مكالمة)
- بيانات الاتصال (يبدأ السعر من 0.003 دولار أمريكي لكل طلب)
يمكنك تقديم طلب "العثور على مكان" وتحديد حقول من جميع حِزم أنواع البيانات الثلاث: FindPlace(fields: formatted_address, opening_hours, price_level). في فاتورتك، ستظهر لك رموز التخزين التعريفية هذه (عند عرض فاتورتك حسب رمز التخزين التعريفي):
- العثور على مكان (يبدأ السعر من 0.017 دولار أمريكي لكل مكالمة)
- البيانات الأساسية (يتم تحصيل رسوم بقيمة 0.00 دولار أمريكي)
- بيانات الاتصال (يبدأ السعر من 0.003 دولار أمريكي لكل طلب)
- بيانات الغلاف الجوي (يبدأ السعر من 0.005 دولار أمريكي لكل طلب)

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

يتم تحصيل رسوم العثور على مكان: رقم التعريف فقط مقابل طلبات العثور على مكان التي تحدد فقط رقم تعريف المكان المطلوب عرضه. إذا لم يتم تحديد أي حقول في طلب البحث عن مكان، يتم تلقائيًا عرض معرّف المكان فقط.

نطاق الحجم الشهري (السعر لكل مكالمة)
0 إلى 100,000	من 100,001 إلى 500,000	أكثر من 500,000
0.00 دولار أمريكي	0.00 دولار أمريكي	0.00 دولار أمريكي

مثال

يمكنك تقديم طلب "العثور على مكان" وتحديد حقل place_id فقط: FindPlace(fields: place_id). سيظهر لك رمز التخزين التعريفي هذا في فاتورتك (عند عرض فاتورتك حسب رمز التخزين التعريفي):

العثور على مكان: رقم التعريف فقط (يتم تحصيل رسوم بقيمة 0.00 دولار أمريكي)

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

يتم تحصيل رسوم من الأماكن - البحث عن الأماكن القريبة مقابل الطلبات المرسَلة إلى خدمة البحث عن الأماكن القريبة في واجهة برمجة التطبيقات JavaScript API لتطبيق "خرائط Google" (nearbySearch())، أو إلى خدمة البحث عن الأماكن القريبة في واجهة برمجة التطبيقات Places API.

نطاق الحجم الشهري (السعر لكل مكالمة)
0 إلى 100,000	من 100,001 إلى 500,000	أكثر من 500,000
‫0.032 دولار أمريكي لكل (32.00 دولار أمريكي لكل 1,000)	‫0.0256 دولار أمريكي لكل (25.60 دولار أمريكي لكل 1,000)	التواصل مع فريق المبيعات لمعرفة أسعار الكميات الكبيرة

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

مثال

إذا أجريت طلب بحث في الأماكن المجاورة، مثل NearbySearch (San Francisco, 100 meters) ستظهر لك رموز التخزين التعريفية هذه في فاتورتك (عند عرض فاتورتك حسب رمز التخزين التعريفي):

مكان: "بحث في الجوار" (يبدأ السعر من 0.032 دولار أمريكي لكل مكالمة)
البيانات الأساسية (يتم تحصيل رسوم بقيمة 0.00 دولار أمريكي)
بيانات الاتصال (يبدأ السعر من 0.003 دولار أمريكي لكل طلب)
بيانات الغلاف الجوي (يبدأ السعر من 0.005 دولار أمريكي لكل طلب)

رمز التخزين التعريفي: الأماكن - البحث النصي

يتم تحصيل رسوم من الأماكن - البحث النصي مقابل الطلبات المرسَلة إلى خدمة البحث النصي عن الأماكن في واجهة برمجة التطبيقات JavaScript API لتطبيق "خرائط Google" (textSearch())، أو إلى خدمة البحث النصي في واجهة برمجة التطبيقات Places API.

نطاق الحجم الشهري (السعر لكل مكالمة)
0 إلى 100,000	من 100,001 إلى 500,000	أكثر من 500,000
‫0.032 دولار أمريكي لكل (32.00 دولار أمريكي لكل 1,000)	‫0.0256 دولار أمريكي لكل (25.60 دولار أمريكي لكل 1,000)	التواصل مع فريق المبيعات لمعرفة أسعار الكميات الكبيرة

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

يتم أيضًا إنشاء رمز التخزين التعريفي للبحث عن الأماكن باستخدام نص من خلال الرمز البرمجي شريط أدوات "مربّع البحث عن الأماكن" في Maps JavaScript API: getPlaces() الطريقة بعد اختيار المستخدِم طلب بحث عن مكان (الرمز: المكبِّر)، وليس نتيجة (الرمز: دبوس)، كما هو موضّح هنا:

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

مثال

تقديم طلب بحث نصي، مثل TextSearch(123 Main Street) في فاتورتك، ستظهر لك رموز التخزين التعريفية هذه (عند عرض فاتورتك حسب رمز التخزين التعريفي):

المكان: البحث النصي (يبدأ السعر من 0.032 دولار أمريكي لكل مكالمة)
البيانات الأساسية (يتم تحصيل رسوم بقيمة 0.00 دولار أمريكي)
بيانات الاتصال (يبدأ السعر من 0.003 دولار أمريكي لكل طلب)
بيانات الغلاف الجوي (يبدأ السعر من 0.005 دولار أمريكي لكل طلب)

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

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

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

بالنسبة إلى خدمة JavaScript، لا يؤدي استدعاء الطريقة PlacePhoto.getUrl() إلى الفوترة إلى أن يتم استخدام عنوان URL فعليًا للحصول على بيانات وحدة البكسل.

نطاق الحجم الشهري (السعر لكل مكالمة)
0 إلى 100,000	من 100,001 إلى 500,000	أكثر من 500,000
‫0.007 دولار أمريكي لكل (7.00 دولار أمريكي لكل 1,000)	‫0.0056 دولار أمريكي لكل (5.60 دولار أمريكي لكل 1,000)	التواصل مع فريق المبيعات لمعرفة أسعار الكميات الكبيرة

أسعار خدمات JavaScript

يتم تحديد أسعار خدمات JavaScript بشكل منفصل. يُرجى الاطّلاع على صفحة استخدام الخدمة والفوترة للحصول على مزيد من المعلومات:

حدود الاستخدام الأخرى

على الرغم من عدم وجود حد أقصى لعدد الطلبات في اليوم، تم وضع حدود استخدام التالية لواجهة برمجة التطبيقات Maps JavaScript API:

30,000 طلب في الدقيقة
‫300 طلب في الدقيقة لكل عنوان IP في وحدة تحكّم Google Cloud، تتم الإشارة إلى هذه الحصة باسم عمليات تحميل الخرائط في الدقيقة لكل مستخدم.

حدود استخدام الخرائط الثلاثية الأبعاد ذات الصور الواقعية في JavaScript في "خرائط Google"

تم وضع حدود الاستخدام التالية للخرائط الثلاثية الأبعاد ذات المظهر الواقعي في JavaScript في "خرائط Google".

‫100 طلب في الدقيقة
10 طلبات في الدقيقة لكل عنوان IP

قيود بنود الاستخدام

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

إدارة تكلفة الاستخدام

لإدارة تكلفة استخدام واجهة برمجة التطبيقات Maps JavaScript API أو لتلبية متطلبات عدد الزيارات في مرحلة الإنتاج، يمكنك ضبط حدود الحصص اليومية على جميع الطلبات المرسَلة إلى أي واجهة برمجة تطبيقات. تتم إعادة ضبط الحصص اليومية في منتصف الليل بتوقيت المحيط الهادئ.

للاطّلاع على حدود الحصة أو تغييرها لواجهة برمجة التطبيقات JavaScript لخرائط Google:

في وحدة تحكّم Cloud Console، افتح صفحة حصص Google Maps Platform.
انقر على القائمة المنسدلة لواجهات برمجة التطبيقات واختَر واجهة برمجة التطبيقات JavaScript لخرائط Google.
للاطّلاع على حدود الحصة، انتقِل إلى بطاقة الطلبات.
جدول يسرد أسماء الحصص وحدودها
لتغيير حدّ الحصة، انقر على رمز تعديل لذلك الحدّ.
في مربّع الحوار الذي يظهر، أدخِل الحدّ الأقصى المفضّل للمساحة المتوفّرة يوميًا والمخصّصة للفوترة (حتى الحدّ الأقصى للمساحة المتوفّرة، إن وُجد، والذي تحدّده Google) ثمّ انقر على حفظ.

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

استخدام واجهة برمجة التطبيقات Maps JavaScript API والفوترة

كيفية فوترة واجهة برمجة التطبيقات Maps JavaScript API

أسعار Maps JavaScript API

رمز التخزين التعريفي: الخرائط الديناميكية

رمز التخزين التعريفي: "التجوّل الافتراضي" الديناميكي

أسعار Places Library وMaps JavaScript API

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

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

رمز التخزين التعريفي: تفاصيل المكان (المعرّفات فقط)

رمز التخزين التعريفي: تفاصيل المكان (الموقع الجغرافي فقط)

رمز التخزين التعريفي: تفاصيل المكان (أساسية)

رمز التخزين التعريفي: تفاصيل المكان (إعداد متقدّم)

رمز التخزين التعريفي: تفاصيل المكان (الخيار المفضّل)

رمز التخزين التعريفي: ميزة "البحث في الأماكن القريبة" (أساسية)

رمز التخزين التعريفي: البحث في الأماكن القريبة (متقدّم)

رمز التخزين التعريفي: البحث في الأماكن القريبة (الخيار المفضّل)

رمز التخزين التعريفي: البحث النصي (المعرّف فقط)

رمز التخزين التعريفي: البحث بالكتابة (أساسي)

رمز التخزين التعريفي: البحث النصي (متقدّم)

رمز التخزين التعريفي: البحث النصي (الخيار المفضّل)

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

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

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

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

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

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

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

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

مثال

Android

iOS

خدمة ويب

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

مثال

Android

iOS

خدمة ويب

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

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

أمثلة

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

مثال

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

أمثلة

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

مثال

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

مثال

رمز التخزين التعريفي: الأماكن - البحث النصي

مثال

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

أسعار خدمات JavaScript

حدود الاستخدام الأخرى

حدود استخدام الخرائط الثلاثية الأبعاد ذات الصور الواقعية في JavaScript في "خرائط Google"

قيود بنود الاستخدام

إدارة تكلفة الاستخدام

مراجع إدارة التكاليف ذات الصلة