تستخدم واجهة برمجة تطبيقات الأماكن نموذج تسعير الدفع حسب الاستخدام. تنشئ طلبات واجهة برمجة تطبيقات الأماكن استدعاءات لأية رموز تخزين تعريفية متعددة. بالإضافة إلى بنود استخدام Google بشكل عام، هناك حدود للاستخدام خاصة بواجهة برمجة تطبيقات الأماكن. إدارة تكاليفك واستخدامك باستخدام الأدوات المتاحة في Google Cloud Console.
كيفية تحرير فواتير واجهة برمجة تطبيقات الأماكن
تستخدم واجهة برمجة تطبيقات الأماكن نموذج تسعير الدفع حسب الاستخدام. يتم إصدار فواتير لواجهات برمجة التطبيقات لمنصة "خرائط Google" وحزم SDK عن طريق رمز التخزين التعريفي. يتم تتبّع الاستخدام لكل رمز تخزين تعريفي، ويمكن أن تحتوي أي واجهة برمجة تطبيقات أو حزمة SDK على أكثر من رمز تخزين تعريفي للمنتج. يتم حساب التكلفة حسب
استخدم حاسبة الأسعار والاستخدام لتقدير تكلفة الاستخدام لكل واجهة برمجة تطبيقات أو SDK. بالنسبة إلى رموز التخزين التعريفية المؤهلة في Google Maps Platform، يتوفر رصيد Google Maps Platform بقيمة 200 دولار أمريكي شهريًا لكل حساب فوترة. ويتم تطبيق هذا الرصيد تلقائيًا1 على رموز التخزين التعريفية المؤهلة.
تسعير واجهة برمجة تطبيقات الأماكن
حول جلسات الإكمال التلقائي
تتضمن جلسة الإكمال التلقائي بعض طلبات الإكمال التلقائي (لاسترداد الاقتراحات على أحد الأماكن أثناء كتابة المستخدم)، وطلب واحد على الأكثر من تفاصيل الأماكن (لاسترداد تفاصيل حول المكان الذي حدده المستخدم). ويتم تمرير نفس رمز الجلسة إلى الإكمال التلقائي وطلب تفاصيل المكان التالي. تبدأ الجلسة بطلب الإكمال التلقائي الأول (الذي يحدث عادةً عندما يبدأ المستخدم الكتابة). يتم إجراء استدعاء "تفاصيل الأماكن" عندما يحدد المستخدم أحد اقتراحات الإكمال التلقائي. إذا لم يحدد أحد المستخدمين اقتراحًا، لن يتم إجراء استدعاء لتفاصيل الأماكن.
بعد أن يحدد المستخدم مكانًا (أي يتم إجراء استدعاء تفاصيل الأماكن)، يجب بدء جلسة جديدة باستخدام رمز مميز جديد للجلسة.
يمكن إنشاء جلسات الإكمال التلقائي من واجهات برمجة التطبيقات التالية:
- خدمة الإكمال التلقائي لأماكن الأماكن أو خدمة الإكمال التلقائي للأماكن في واجهة برمجة تطبيقات JavaScript. يجب تصميم تطبيقك لتقديم رموز مميّزة للجلسة (قد تحتاج إلى تغيير الرمز الحالي).
- أداة الإكمال التلقائي لواجهة برمجة تطبيقات JavaScript للخرائط. ويتم تفعيل الفوترة المستندة إلى الجلسة تلقائيًا على هذه الأدوات، بدون الحاجة إلى تغيير أي رمز.
الرمز المميز للجلسة جيد لجلسة مستخدم واحدة ويجب عدم استخدامه لأكثر من جلسة مستخدم واحدة. إذا أعدت استخدام رمز مميز للجلسة، فسيتم اعتبار الجلسة غير صالحة ويتم تحصيل رسوم الطلبات كما لو لم يتم تقديم رمز مميز للجلسة.
تتم فوترة طلبات الإكمال التلقائي وطلبات تفاصيل الأماكن باستخدام الجلسات في رموز تخزين تعريفية مختلفة.
حول رموز التخزين التعريفي لبيانات الأماكن
وحدات SKU لبيانات الأماكن الثلاثة هي: البيانات الأساسية، وبيانات جهة الاتصال، وبيانات الغلاف الجوي.يتم تشغيل رمز تخزين تعريفي واحد أو أكثر للبيانات:
- Android: كل طلب إلى
fetchPlace()
أوfindCurrentPlace()
- iOS: كل مكالمة إلى
fetchPlaceFromPlaceID:
أوfindPlaceLikelihoodsFromCurrentLocationWithPlaceFields:
- خدمة الويب: يطلب كل مكان من الأماكن بناءً على الحقول المحددة في الطلب
ويتم تحصيل رسوم رموز التخزين التعريفية للبيانات دائمًا بالإضافة إلى رمز التخزين التعريفي الأساسي للطلب الذي يؤدي إلى تشغيلها. على سبيل المثال، سيتم تحصيل رسوم طلب "تفاصيل المكان" الذي يحتوي على حقول "البيانات الأساسية" ضمن رمز التخزين التعريفي "للبيانات الأساسية" ورمز التخزين التعريفي لتفاصيل المكان.
بالنسبة إلى خدمة الويب، تتيح طلبات بيانات الأماكن من Google دعم تحديد حقول البيانات المراد عرضها:
بالنسبة إلى خدمة الويب، تطلب واجهات برمجة تطبيقات الأماكن هذه عدم تحديد الحقول المعروضة. تعرض هذه المكالمات دائمًا جميع بيانات الأماكن، وتحصّل وحدات SKU لبيانات الأماكن الثلاثة بالإضافة إلى رسوم كل طلب من طلبات واجهة برمجة التطبيقات:
رمز التخزين التعريفي: البيانات الأساسية
باستخدام معلمة الحقول في طلب تفاصيل المكان أو البحث عن مكان ، يمكنك قصر الاستجابة على هذه الحقول المحددة فقط. يتم تضمين الحقول في الفئة أساسي في التكلفة الأساسية لطلب "الأماكن" ولا ينتج عنها أي رسوم إضافية. يتم تشغيل رمز التخزين التعريفي للبيانات الأساسية عند طلب أي من هذه الحقول:
-
نظام التشغيل Android:
Place.Field.ADDRESS
أوPlace.Field.ADDRESS_COMPONENTS
أوPlace.Field.BUSINESS_STATUS
أوPlace.Field.ICON_BACKGROUND_COLOR
أوPlace.Field.ICON_URL
أوPlace.Field.ID
أوPlace.Field.LAT_LNG
أوPlace.Field.NAME
أوPlace.Field.PHOTO_METADATAS
أوPlace.Field.PLUS_CODE
أوPlace.Field.TYPES
أوPlace.Field.VIEWPORT
أوPlace.Field.UTC_OFFSET
أوPlace.Field.WHEELCHAIR_ACCESSIBLE_ENTRANCE
-
نظام التشغيل iOS:
GMSPlaceFieldFormattedAddress
أوGMSPlaceFieldBusinesssStatus
أو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.00 دولار أمريكي |
تكلفة طلب الأماكن وأكثر من 0.00 دولار أمريكي |
تكلفة طلب الأماكن وأكثر من 0.00 دولار أمريكي |
رمز التخزين التعريفي: بيانات جهة الاتصال
باستخدام معلمة الحقول في تفاصيل المكان أو طلب العثور على المكان لخدمات الويب، أو في مصفوفة من Place.Field
لنظام التشغيل Android أو iOS، يمكنك تقييد الاستجابة بتلك الحقول المحددة فقط. تؤدي الحقول في فئة جهة الاتصال إلى فرض رسوم إضافية. يتم تشغيل رمز التخزين التعريفي لبيانات جهات الاتصال
عند طلب أي من الحقول التالية:
-
Android:
Place.Field.CURRENT_OPENING_HOURS
أوPlace.Field.OPENING_HOURS
أوPlace.Field.PHONE_NUMBER
أوPlace.Field.SECONDARY_OPENING_HOURS
أوPlace.Field.WEBSITE_URI
-
iOS:
GMSPlaceFieldOpeningHours
أوGMSPlaceFieldPhoneNumber
أوGMSPlaceFieldWebsite
-
خدمة الويب:
formatted_phone_number
أوinternational_phone_number
أوopening_hours
أوcurrent_opening_hours
أوsecondary_opening_hours
أوwebsite
نطاق الحجم الشهري (السعر لكل مكالمة) |
||
---|---|---|
تكلفة طلب الأماكن + 0.003 دولار لكل منها (+ 3.00 دولارات أمريكية لكل 1000 دولار أمريكي) |
تكلفة طلب الأماكن + 0.0024 دولار لكل منها (+ 2.40 USD لكل 1000) |
يُرجى التواصل مع فريق المبيعات لمعرفة سعر المجلّد. |
رمز التخزين التعريفي: بيانات الغلاف الجوي
باستخدام معلمة الحقول في طلب تفاصيل المكان أو البحث عن مكان ، يمكنك قصر الاستجابة على تلك الحقول المحددة فقط. تؤدي الحقول في فئة Atmosphere إلى فرض رسوم إضافية. يتم تشغيل رمز التخزين التعريفي لبيانات Atmosphere عند طلب أي من هذه الحقول:
- نظام التشغيل Android:
Place.Field.CURBSIDE_PICKUP
أوPlace.Field.DELIVERY
أو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_RATINGS_TOTAL
- iOS:
GMSPlaceFieldPriceLevel
أوGMSPlaceFieldRating
أوGMSPlaceFieldUserRatingsTotal
أوGMSPlaceFieldTakeout
أوGMSPlaceFieldDelivery
أوGMSPlaceFieldDineIn
أوGMSPlaceFieldCurbsidePickup
أوGMSPlaceFieldReservable
أوGMSPlaceFieldServesBreakfast
أوGMSPlaceFieldServesLunch
أوGMSPlaceFieldServesDinner
أوGMSPlaceFieldServesBeer
أوGMSPlaceFieldServesWine
أوGMSPlaceFieldServesBrunch
أوGMSPlaceFieldServesVegetarianFood
. - جافا سكريبت: راجع الحقول (تفاصيل المكان)
- خدمة الويب:
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.005 دولار لكل منها (+ 5.00 USD لكل 1000) |
تكلفة طلب الأماكن زائد 0.004 دولار لكل منها (+ 4.00 USD لكل 1000) |
يُرجى التواصل مع فريق المبيعات لمعرفة سعر المجلّد. |
رمز التخزين التعريفي: الإكمال التلقائي – لكل طلب
يتم تحصيل رسوم من رمز التخزين التعريفي الإكمال التلقائي – لكل طلب مقابل أي من هذه الطلبات أو الطلبات التي لا تتضمن رمزًا مميزًا للجلسة:
- نظام التشغيل Android:
findAutocompletePredictions()
- نظام التشغيل iOS:
findAutocompletePredictionsFromQuery:
- جافا سكريبت: خدمة الإكمال التلقائي لـ JavaScript API للخرائط
- خدمة الويب: خدمة الإكمال التلقائي لواجهة برمجة تطبيقات الأماكن
كما يتم تحصيل رسوم أيضًا من المكالمات التي يتم إجراؤها من جلسة الإكمال التلقائي غير الصالحة (على سبيل المثال، جلسة تعيد استخدام رمز مميز لجلسة)) الإكمال التلقائي - لكل طلب SKU.
قد يتم تحصيل رسوم من خدمة الإكمال التلقائي لطلبات من أداة الإكمال التلقائي لـ "واجهة برمجة تطبيقات JavaScript" في "خرائط Google" من خلال الإكمال التلقائي - لكل طلب رمز تخزين تعريفي في حال إجراء مكالمات من جلسة "إكمال تلقائي" غير صالحة. وقد يحدث هذا عندما يكتب المستخدم عناوين مختلفة أو ينسخ/يلصق عناوين مختلفة في الأداة ولا يحدد دائمًا توقع الإكمال التلقائي.
نطاق الحجم الشهري (السعر لكل طلب) |
||
---|---|---|
0.00283 دولار أمريكي لكل (2.83 دولار أمريكي لكل 1000 دولار أمريكي) |
0.00227 دولار أمريكي لكل (2.27 دولار أمريكي لكل 1000 دولار أمريكي) |
يُرجى التواصل مع فريق المبيعات لمعرفة سعر المجلّد. |
رمز التخزين التعريفي: الإكمال التلقائي بدون تفاصيل المكان – لكل جلسة
يتم تحصيل رسوم من رمز التخزين التعريفي الإكمال التلقائي بدون تفاصيل المكان – لكل جلسة مقابل جلسة الإكمال التلقائي التي لا تتضمن طلب تفاصيل المكان (خلال بضع دقائق من بداية الجلسة).
نطاق المجلد الشهري (السعر لكل جلسة) |
||
---|---|---|
0.017 دولار أمريكي لكل (17.00 دولار أمريكي لكل 1000 دولار أمريكي) |
0.0136 دولار أمريكي لكل (13.60 دولار أمريكي لكل 1000 دولار أمريكي) |
يُرجى التواصل مع فريق المبيعات لمعرفة سعر المجلّد. |
مثال
إذا أصدر التطبيق هاتين المكالمتين في جلسة واحدة:
Android
- findcompletePredictions() (.setQuery(”par”), .setSessionToken(XYZ) )
- findcompletePredictions() (.setQuery(”paris”), .setSessionToken(XYZ) )
iOS
- placesClient??findcompletePredictions(fromQuery: "par" ...
- placesClient??findcompletePredictions(fromQuery: "paris" ...
خدمة ويب
- طلب إكمال تلقائي (input=”par”, session_token: XYZ)
- طلب الإكمال التلقائي للمكان (input=”paris), session_token: XYZ)
سترى على رمز التخزين التعريفي هذا مدرجًا (عند الاطّلاع على فاتورتك حسب رمز التخزين التعريفي):
- الإكمال التلقائي بدون تفاصيل المكان – لكل جلسة (يبدأ السعر من 0.017 دولار أمريكي لكل جلسة)
رمز التخزين التعريفي: الإكمال التلقائي (مضمّن في تفاصيل المكان) – لكل جلسة
يتم تحصيل رسوم من رمز التخزين التعريفي الإكمال التلقائي (مضمّن في تفاصيل المكان) – لكل جلسة مقابل جلسة إكمال تلقائي تشمل أيًا مما يلي:
- Android: مكالمة إلى
fetchPlace()
- iOS: مكالمة إلى
fetchPlaceFromPlaceID:
- خدمة الويب: طلب تفاصيل المكان
يتوفر طلب الإكمال التلقائي بدون أي رسوم، كما يتم تحصيل رسوم مكالمة "تفاصيل المكان" اللاحقة بناءً على سعر تفاصيل المكان العادي.
ينشئ طلب تفاصيل المكان رموز تخزين تعريفية للبيانات (أساسي و/أو جهة اتصال و/أو Atmosphere) – بناءً على الحقول المحددة في الطلب.
إذا لم تحدد حقولاً في طلب تفاصيل المكان، فسيتم تشغيل جميع رموز التخزين التعريفية للبيانات (الأساسي، والاتصال، والغلاف الجوي).
طلبات إعادة تحميل معرّف تفاصيل المكان (الطلبات التي تحدد الحقل place_id
فقط) أثناء جلسة الإكمال التلقائي تتم فوترتها كـ SKU: الإكمال التلقائي
بدون تفاصيل المكان – لكل جلسة.
نطاق المجلد الشهري (السعر لكل جلسة) |
||
---|---|---|
0.00 دولار أمريكي | 0.00 دولار أمريكي | 0.00 دولار أمريكي |
مثال
إذا أصدر تطبيقك المكالمات الثلاث التالية في جلسة واحدة:
Android
- findcompletePredictions() (.setQuery(”par”), .setSessionToken(XYZ) )
- findcompletePredictions() (.setQuery(”paris”), .setSessionToken(XYZ) )
- fetchPlace() (مع
FetchPlaceRequest
بما في ذلك رقم تعريف المكان، وحقل ADDRESS)
iOS
- placesClient??findcompletePredictions(fromQuery: "par" ...
- placesClient??findcompletePredictions(fromQuery: "paris" ...
- fetchPlaceFromPlaceID:
(بما في ذلك معرّف المكان والحقل
GMSPlaceFieldFormattedAddress
)
خدمة ويب
- طلب الإكمال التلقائي للأماكن (input=”par), session_token: XYZ)
- طلب الإكمال التلقائي للأماكن (input=”paris), session_token: XYZ)
- تفاصيل الأماكن (place_id، session_token: XYZ، الحقول:تنسيق_العنوان)
ستظهر على فاتورتك رموز التخزين التعريفية هذه (عند الاطّلاع على فاتورتك حسب رمز التخزين التعريفي):
- الإكمال التلقائي (مضمّن في تفاصيل المكان) - لكل جلسة (تحصيل الفواتير 0.00 دولار أمريكي)
- تفاصيل المكان (يبدأ السعر من 0.017 دولار أمريكي لكل جلسة)
- البيانات الأساسية (تحصيل الفواتير بسعر 0.00 SAR)
SKU: الإكمال التلقائي لطلبات البحث – لكل طلب
يتم تحصيل رسوم رمز التخزين التعريفي الإكمال التلقائي لطلب البحث – لكل طلب لكل طلب إلى:
- جافا سكريبت:
خدمة الإكمال التلقائي لأماكن واجهة برمجة تطبيقات جافا سكريبت (
getQueryPredictions()
) واستخدام أداة البحث في واجهة برمجة تطبيقات جافا سكريبت للخرائط (يتم إنشاء طلبات الإكمال التلقائي لطلبات البحث كأنواع للمستخدمين). - خدمة الويب: خدمة الإكمال التلقائي لطلب البحث في الأماكن
نطاق الحجم الشهري (السعر لكل طلب) |
||
---|---|---|
0.00283 دولار أمريكي لكل (2.83 دولار أمريكي لكل 1000 دولار أمريكي) |
0.00227 دولار أمريكي لكل (2.27 دولار أمريكي لكل 1000 دولار أمريكي) |
يُرجى التواصل مع فريق المبيعات لمعرفة سعر المجلّد. |
الأسعار عبر جلسة الإكمال التلقائي غير متاحة باستخدام الإكمال التلقائي لطلبات البحث. يتم تحصيل رسوم المكالمات اللاحقة لتفاصيل الأماكن على أساس أسعار تفاصيل الأماكن المعتادة.
رمز التخزين التعريفي: تفاصيل المكان
يتم احتساب رسوم تفاصيل المكان على النحو التالي:
نطاق الحجم الشهري (السعر لكل مكالمة) |
||
---|---|---|
0.017 دولار أمريكي لكل (17.00 دولار أمريكي لكل 1000 دولار أمريكي) |
0.0136 دولار أمريكي لكل (13.60 دولار أمريكي لكل 1000 دولار أمريكي) |
يُرجى التواصل مع فريق المبيعات لمعرفة سعر المجلّد. |
يتم إنشاء رمز التخزين التعريفي لتفاصيل المكان من واجهات برمجة التطبيقات التالية:
- نظام التشغيل Android: تطبيق SDK لأماكن Android
(
fetchPlace()
) - iOS: مكان حزمة تطوير البرامج (SDK) لنظام التشغيل iOS
(
fetchPlaceFromPlaceID:
) - جافا سكريبت:
خدمة تفاصيل مكان واجهة برمجة تطبيقات جافا سكريبت في الخرائط (
getDetails
) - جافا سكريبت:
أداة الإكمال التلقائي للأماكن في واجهة برمجة تطبيقات JavaScript (
getPlace
) - JavaScript:
أداة "بحث الأماكن" على "واجهة برمجة تطبيقات JavaScript" في "خرائط Google":
getPlaces()
طريقة بعد أن يختار المستخدم نتيجة البحث عن المكان (الرمز: تثبيت)، *وليس* طلب بحث (الرمز: مكبّر)، كما هو موضّح هنا:في نتائج أداة البحث، بعد كتابة "pizza" في مربّع البحث، يُرجى ملاحظة أن Pizza Autentico به رمز طلب بحث بجانبه، ويظهر رمز نتيجة بجانبه، ومن ثمّ لا يتضمن الرمز طلب البحث . - خدمة الويب: خدمة تفاصيل حول الأماكن في واجهة برمجة تطبيقات الأماكن
باستخدام واجهة برمجة التطبيقات والخدمات على الويب، يتم تحصيل الرسوم من رمز التخزين التعريفي لتفاصيل المكان سواء تم توفير رمز مميز للجلسة أم لا.
تؤدي أيضًا مكالمة أو طلب تفاصيل المكان إلى إنشاء رموز تخزين تعريفية للبيانات (أساسي و/أو جهة اتصال و/أو الغلاف الجوي)، بناءً على الحقول المحددة في المكالمة أو الطلب. إذا تم تحديد حقول لا في استدعاء أو طلب تفاصيل المكان، فسيتم تشغيل جميع رموز SKU للبيانات، وسيتم تحصيل رسوم منك مقابل مكالمة أو طلب تفاصيل الأماكن بالإضافة إلى تكلفة جميع البيانات.
أمثلة
- نفِّذ أحد هذه المكالمات أو الطلبات:
- الجوّال: يمكنك الاتصال بـ
fetchPlace()
على نظام التشغيل Android أوfetchPlaceFromPlaceID:
على iOS، وتحديد الحقلADDRESS
فقط - واجهة برمجة تطبيقات الويب أو الخدمة: يمكنك تقديم طلب "تفاصيل المكان" وتحديد حقل العنوان فقط:
getPlaceDetails(fields: formatted_address)
- تفاصيل المكان (يبدأ السعر من 0.017 دولار أمريكي لكل جلسة)
- البيانات الأساسية (تحصيل الفواتير بسعر 0.00 SAR)
- الجوّال: يمكنك الاتصال بـ
- نفِّذ أحد هذه المكالمات أو الطلبات:
- الجوّال: يمكنك الاتصال بـ
fetchPlace()
على نظام التشغيل Android أوfetchPlaceFromPlaceID:
على iOS، وتحديد الحقلPHONE_NUMBER
فقط - واجهة برمجة تطبيقات أو خدمة على الويب: يمكنك تقديم طلب "تفاصيل المكان" وتحديد حقل رقم الهاتف:
getPlaceDetails(fields: formatted_phone_number)
- تفاصيل المكان (يبدأ السعر من 0.017 دولار أمريكي لكل جلسة)
- بيانات الاتصال (يبدأ السعر من 0.003 دولار أمريكي لكل طلب)
- الجوّال: يمكنك الاتصال بـ
- نفِّذ أحد هذه المكالمات أو الطلبات:
- الجوّال: يمكنك الاتصال بـ
fetchPlace()
على نظام التشغيل Android أوfetchPlaceFromPlaceID:
على iOS، وتحديد جميع الحقول - واجهة برمجة تطبيقات الويب أو الخدمة: يمكنك تقديم طلب "تفاصيل المكان" وتحديد جميع الحقول (هذا النوع من الطلب هو الخيار التلقائي إذا لم تحدّد أي حقول):
getPlaceDetails()
.
- تفاصيل المكان (يبدأ السعر من 0.017 دولار أمريكي لكل جلسة)
- البيانات الأساسية (تحصيل الفواتير بسعر 0.00 SAR)
- بيانات الاتصال (يبدأ السعر من 0.003 دولار أمريكي لكل طلب)
- بيانات الغلاف الجوي (سعر يبدأ من 0.005 دولار أمريكي لكل طلب)
- الجوّال: يمكنك الاتصال بـ
رمز التخزين التعريفي: تفاصيل المكان – تحديث رقم التعريف
استخدم طلب تفاصيل المكان لتحديث أرقام تعريف الأماكن القديمة. وتتوفّر هذه الأنواع من الطلبات بدون أي رسوم.
نطاق الحجم الشهري (السعر لكل مكالمة) |
||
---|---|---|
0.00 دولار أمريكي | 0.00 دولار أمريكي | 0.00 دولار أمريكي |
مثال
يمكنك تقديم طلب تفاصيل المكان لتحديد حقل رقم تعريف المكان فقط:
getPlaceDetails(fields: place_id)
.
سترى على رمز التخزين التعريفي هذا مدرجًا (عند الاطّلاع على فاتورتك حسب رمز التخزين التعريفي):
- تفاصيل المكان – إعادة تحميل رقم التعريف (تحصيل الفواتير عند 0.00 دولار أمريكي)
رمز التخزين التعريفي: العثور على مكان
يتم تحصيل رسوم من خلال البحث عن مكان عن طلب "البحث عن مكان".
نطاق الحجم الشهري (السعر لكل مكالمة) |
||
---|---|---|
0.017 دولار أمريكي لكل (17.00 دولار أمريكي لكل 1000 دولار أمريكي) |
0.0136 دولار أمريكي لكل (13.60 دولار أمريكي لكل 1000 دولار أمريكي) |
يُرجى التواصل مع فريق المبيعات لمعرفة سعر المجلّد. |
تعمل طلبات البحث عن المكان أيضًا على إنشاء رموز تخزين تعريفية للبيانات (أساسية و/أو جهة اتصال و/أو Atmosphere)، بناءً على الحقول المحددة في الطلب. مثل طلبات تفاصيل المكان، يمكنك استخدام معلمة الحقول في طلب العثور على المكان لحصر الاستجابة في الحقول المحددة فقط. تتم محاسبتك مقابل طلب العثور على المكان وكذلك البيانات المطلوبة. بشكل افتراضي، إذا تم طلب حقول لا، لن يتم عرض سوى معرّف المكان، لذلك لا يتم تحصيل رسوم إضافية للبيانات.
أمثلة
- يمكنك تقديم طلب بحث عن مكان وتحديد حقل العنوان فقط:
FindPlace(fields: formatted_address)
. ستظهر على فاتورتك رموز التخزين التعريفية هذه (عند عرض فاتورتك حسب رمز التخزين التعريفي):- البحث عن مكان (يبدأ السعر من 0.017 دولار أمريكي لكل مكالمة)
- البيانات الأساسية (تحصيل الفواتير بسعر 0.00 SAR)
- يمكنك تقديم طلب "تحديد مكان" وتحديد حقل رقم الهاتف:
FindPlace(fields: formatted_phone_number)
. ستظهر على فاتورتك رموز التخزين التعريفية هذه (عند عرض فاتورتك حسب رمز التخزين التعريفي):- البحث عن مكان (يبدأ السعر من 0.017 دولار أمريكي لكل مكالمة)
- بيانات الاتصال (يبدأ السعر من 0.003 دولار أمريكي لكل طلب)
- يمكنك تقديم طلب "العثور على مكان" وتحديد الحقول من مجموعات البيانات الثلاثة من نوع البيانات التالية:
FindPlace(fields: formatted_address, opening_hours, price_level)
. ستظهر لك رموز التخزين التعريفية هذه مُدرَجة في فاتورتك (عند عرض فاتورتك حسب رمز التخزين التعريفي):- البحث عن مكان (يبدأ السعر من 0.017 دولار أمريكي لكل مكالمة)
- البيانات الأساسية (تحصيل الفواتير بسعر 0.00 SAR)
- بيانات الاتصال (يبدأ السعر من 0.003 دولار أمريكي لكل طلب)
- بيانات الغلاف الجوي (سعر يبدأ من 0.005 دولار أمريكي لكل طلب)
رمز التخزين التعريفي: العثور على مكان – رقم التعريف فقط
يتم تحصيل رسوم البحث عن المكان – رقم التعريف فقط عن طلبات البحث عن المكان التي تحدد فقط رقم تعريف المكان المطلوب عرضه. بشكل افتراضي، إذا لم يتم تحديد أي حقول في طلب العثور على المكان، فسيتم عرض معرّف المكان فقط.
نطاق الحجم الشهري (السعر لكل مكالمة) |
||
---|---|---|
0.00 دولار أمريكي | 0.00 دولار أمريكي | 0.00 دولار أمريكي |
مثال
يمكنك تقديم طلب بحث عن مكان وتحديد الحقل place_id
فقط: FindPlace(fields: place_id)
.
سترى على رمز التخزين التعريفي هذا مدرجًا (عند الاطّلاع على فاتورتك حسب رمز التخزين التعريفي):
- البحث عن مكان – رقم التعريف فقط (يتم تحصيل الرسوم من 0.00 دولار أمريكي)
رمز التخزين التعريفي: المكان – البحث في الأماكن القريبة
يتم تحصيل رسوم من المكان – البحث القريب عن الطلبات إلى خدمة
البحث عن الأماكن المجاورة في واجهة برمجة تطبيقات JavaScript
(nearbySearch()
) أو إلى
خدمة البحث عن الأماكن المجاورة لواجهة برمجة تطبيقات الأماكن
نطاق الحجم الشهري (السعر لكل مكالمة) |
||
---|---|---|
0.032 دولار أمريكي لكل (32.00 دولار أمريكي لكل 1000 دولار أمريكي) |
0.0256 دولار أمريكي لكل (25.60 دولار أمريكي لكل 1000 دولار أمريكي) |
يُرجى التواصل مع فريق المبيعات لمعرفة سعر المجلّد. |
تعرض طلبات البحث بالجوار قائمة بالأماكن، لكنها لا تدعم تحديد الحقول التي يتم عرضها. تعرض طلبات البحث في مكان قريب مجموعة فرعية من حقول البيانات المتوافقة. يتم تحصيل رسوم منك مقابل طلب البحث في الأماكن القريبة بدءًا من 0.032 دولار أمريكي لكل طلب، بالإضافة إلى جميع رموز التخزين التعريفية من نوع البيانات (البيانات الأساسية وبيانات الاتصال وبيانات الغلاف الجوي).
مثال
يمكنك تقديم طلب بحث عن الأجهزة المجاورة، مثل NearbySearch (San Francisco, 100 meters)
.
ستظهر على فاتورتك رموز التخزين التعريفية هذه (عند الاطّلاع على فاتورتك حسب رمز التخزين التعريفي):
- المكان - البحث بالجوار (سعر يبدأ من 0.032 دولار أمريكي لكل مكالمة)
- البيانات الأساسية (تحصيل الفواتير بسعر 0.00 SAR)
- بيانات الاتصال (يبدأ السعر من 0.003 دولار أمريكي لكل طلب)
- بيانات الغلاف الجوي (سعر يبدأ من 0.005 دولار أمريكي لكل طلب)
رمز التخزين التعريفي: المكان – البحث عن النص
يتم تحصيل رسوم من Place – Text Search عن الطلبات إلى
خدمة البحث عن نص في واجهة برمجة تطبيقات JavaScript
(textSearch()
) أو إلى
خدمة البحث النصي في واجهة برمجة تطبيقات الأماكن.
نطاق الحجم الشهري (السعر لكل مكالمة) |
||
---|---|---|
0.032 دولار أمريكي لكل (32.00 دولار أمريكي لكل 1000 دولار أمريكي) |
0.0256 دولار أمريكي لكل (25.60 دولار أمريكي لكل 1000 دولار أمريكي) |
يُرجى التواصل مع فريق المبيعات لمعرفة سعر المجلّد. |
تعرض طلبات البحث النصي قائمة بالأماكن، ولكنها لا تدعم تحديد الحقول التي يتم عرضها. تعرض طلبات البحث النصي مجموعة فرعية من حقول البيانات المتوافقة. يتم تحصيل رسوم منك مقابل طلب البحث النصي بدءًا من 0.032 دولارًا أمريكيًا لكل طلب، بالإضافة إلى جميع رموز التخزين التعريفية من نوع البيانات (البيانات الأساسية وبيانات جهات الاتصال وبيانات الغلاف الجوي).
يتم أيضًا إنشاء رمز التخزين التعريفي للمكان – البحث النصي عن طريق أداة
واجهة برمجة تطبيقات المكان للبحث في واجهة برمجة تطبيقات جافا سكريبت للخرائط: getPlaces()
بعد أن يحدد المستخدم طلب البحث عن المكان (الرمز: مكبّر)، وليس
النتيجة (الرمز: الدبوس)، كما هو موضح هنا:

مثال
يمكنك تقديم طلب بحث نصي، مثل TextSearch(123 Main Street)
. سترى على فاتورتك رموز التخزين التعريفية هذه (عند عرض فاتورتك حسب رمز التخزين التعريفي):
- المكان - البحث عن النص (سعر يبدأ من 0.032 دولار أمريكي لكل مكالمة)
- البيانات الأساسية (تحصيل الفواتير بسعر 0.00 SAR)
- بيانات الاتصال (يبدأ السعر من 0.003 دولار أمريكي لكل طلب)
- بيانات الغلاف الجوي (سعر يبدأ من 0.005 دولار أمريكي لكل طلب)
رمز التخزين التعريفي: صورة مكان
يتم تحصيل رسوم من رمز التخزين التعريفي لصورة المكان مقابل:
- Android: مكالمات إلى
fetchPhoto()
- iOS: مكالمات صادرة إلى
loadPlacePhoto:
- JavaScript: عند الانتقال إلى Library Places, Maps JavaScript's
Place Photos Service عند طلب بيانات من عناوين URL التي تعرضها
PlacePhoto.getUrl()
لتحميل بيانات بكسل الصورة - خدمة الويب: يتم إرسال طلبات إلى خدمة "صور الأماكن" لواجهة برمجة تطبيقات الأماكن
بالنسبة إلى خدمة JavaScript، لا يؤدي استدعاء الطريقة PlacePhoto.getUrl()
إلى فوترة إلى أن يتم استخدام عنوان URL للحصول على بيانات البكسل بشكل فعلي.
نطاق الحجم الشهري (السعر لكل مكالمة) |
||
---|---|---|
0.007 دولار أمريكي لكل (7.00 دولارات أمريكية لكل 1000 دولار أمريكي) |
0.0056 دولار أمريكي لكل (5.60 دولار أمريكي لكل 1000 دولار أمريكي) |
يُرجى التواصل مع فريق المبيعات لمعرفة سعر المجلّد. |
حدود الاستخدام الأخرى
على الرغم من أنه ليس هناك حد أقصى لعدد الطلبات في اليوم، إلا أنه سيستمر تطبيق حد الاستخدام التالي عند استخدام واجهة برمجة تطبيقات الأماكن:
- يبلغ الحدّ الأقصى لمعدّل الزحف 100 طلب في الثانية. ويتم حسابها من خلال مجموع الطلبات من جهة العميل والطلبات من جانب الخادم لجميع التطبيقات باستخدام بيانات اعتماد المشروع نفسه.
قيود بنود الاستخدام
للحصول على معلومات عن بنود الاستخدام، راجع سياسات واجهة برمجة تطبيقات الأماكن، وقسم قيود الترخيص في بنود خدمة نظام خرائط Google الأساسي.
إدارة تكلفة الاستخدام
لإدارة تكلفة استخدام واجهات برمجة التطبيقات في "منصة خرائط Google"، يمكنك ضبط حدود الحصة اليومية على جميع الطلبات المقدمة إلى أي واجهة برمجة تطبيقات خاضعة للفوترة. وتتم إعادة ضبط الحصص اليومية في منتصف الليل بتوقيت المحيط الهادئ.
لعرض حدود الحصة أو تغييرها لواجهة برمجة تطبيقات الأماكن:
- في Cloud Console، افتح صفحة حصص "منصة خرائط Google".
- انقر على القائمة المنسدلة لواجهات برمجة التطبيقات وحدد واجهة برمجة تطبيقات الأماكن.
- للاطّلاع على حدود الحصّة، يُرجى الانتقال إلى بطاقة الطلبات.
يسرد الجدول أسماء الحصص وحدودها. - لتغيير أحد حدود الحصة، انقر على الرمز تعديل لهذا الحد.
في مربع الحوار الذي يظهر، في الحقل الحصة المحددة للحصة، أدخل الحد الأقصى للحصة اليومية القابلة للفوترة (يصل إلى حد الحصة المسموح به، إن وجد، الذي تحدده Google) وحدد حفظ.
إذا بلغ استخدام واجهة برمجة التطبيقات الحد المسموح به للفواتير في أي يوم محدد، فلن يتمكن التطبيق من الدخول إلى واجهة برمجة التطبيقات لبقية هذا اليوم.
موارد إدارة التكاليف ذات الصلة
-
يجب على المستخدمين في الهند إنشاء حساب فوترة على Google Cloud Platform قبل إنشاء حساب فوترة على Google Maps Platform حتى يتم الحصول على رصيد في Maps Platform.↩