استخدام واجهة برمجة التطبيقات الخاصة بالطرق والفوترة
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
Roads API إلى إنشاء رموز تخزين تعريفية مختلفة استنادًا إلى نوع الطلب: أقرب الطرق أو المسار الذي تمّت القيادة فيه مع ميزة "المحاذاة مع الطرق" أو حدود السرعة.
تفاصيل رمز التخزين التعريفي والسعر الخاص بـ "Roads API"
يعرض الجدول التالي تفاصيل رمز التخزين التعريفي والأسعار الخاصة بـ Roads API.
1 لا يمكن لبعض المستخدِمين استخدام رمز التخزين التعريفي هذا.
حدود الاستخدام
مع أنّه ليس هناك حدّ أقصى لعدد الطلبات في اليوم، يتم تطبيق حدود الاستخدام التالية على Roads API:
تكون الطلبات في الدقيقة محدودة، ويتم احتسابها على مستوى جميع نقاط نهاية Roads API.
يمكنك إرسال 100 نقطة كحد أقصى لكل طلب.
تعديل الحصة
تحدّد حدود الحصة الحدّ الأقصى لعدد الطلبات المسموح بها لواجهة برمجة تطبيقات أو خدمة معيّنة خلال إطار زمني محدّد. عندما يصل عدد الطلبات في مشروعك إلى الحد الأقصى للحصة، تتوقف خدمتك عن الاستجابة للطلبات.
لتعديل قيمة الحصة لواجهة برمجة التطبيقات، اتّبِع الخطوات التالية:
في Cloud Console، انتقِل إلى Google Maps Platform > الحصص.
اختَر واجهة برمجة التطبيقات التي تريد تعديل الحصة فيها.
حدِّد قيمة الحصة التي تريد تغييرها، ثم ضَع علامة في مربّع الاختيار بجانبها.
انقر على تعديل، وأدخِل قيمة حصة جديدة، ثم انقر على إرسال الطلب.
عرض طلبات زيادة الحصة
للاطّلاع على جميع طلبات زيادة الحصة، بما في ذلك الطلبات السابقة والمعلّقة، اتّبِع الخطوات التالية:
في Cloud Console، انتقِل إلى Google Maps Platform > الحصص.
اختَر واجهة برمجة التطبيقات التي تريد الاطّلاع على طلب زيادة الحصة لها.
تاريخ التعديل الأخير: 2025-08-31 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-08-31 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eThe Roads API uses a pay-as-you-go model and offers services for route traveled, nearest roads, and speed limits, each with its own pricing based on usage volume.\u003c/p\u003e\n"],["\u003cp\u003eYou must enable billing and include an API key or OAuth token with all API requests to use the Roads API.\u003c/p\u003e\n"],["\u003cp\u003eUsage is subject to limits including 30,000 requests per minute, a maximum of 100 points per request, and terms of use restrictions outlined in Google Maps Platform policies.\u003c/p\u003e\n"],["\u003cp\u003eManage costs by setting daily quota limits for the Roads API through the Google Cloud console to avoid service disruptions due to exceeding usage limits.\u003c/p\u003e\n"],["\u003cp\u003eA $200 USD Google Maps Platform credit is available monthly until February 28, 2025, for eligible SKUs and will be replaced by free usage thresholds afterward.\u003c/p\u003e\n"]]],["The Roads API uses a pay-as-you-go model, billed by SKU type: route traveled, nearest roads, or speed limits. Billing requires enabled billing and an API key or OAuth token. Costs are calculated by SKU usage and price per use, with a $200 monthly credit until March 1, 2025, then replaced by a free usage threshold. Usage is limited to 30,000 requests per minute and 100 points per request. Daily quota limits can be set in the Google Cloud console.\n"],null,["# Roads API Usage and Billing\n\n| **Reminder:** To use the Roads API, you must [enable billing](https://console.cloud.google.com/project/_/billing/enable?utm_source=Docs_BillingNudge) on each of your projects and include an [API key](/maps/documentation/roads/get-api-key) or OAuth token with all API or SDK requests.\nRoads API requests generate different SKUs depending on the type of request: nearest roads, route traveled with snap to roads, or speed limits.\n\nSKU details and pricing for the Roads API\n-----------------------------------------\n\nThe following table shows the SKU details and pricing for the Roads API.\n\n| Category | SKU Details | SKU Pricing |\n|----------|---------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------|\n| **Pro** | [SKU: Roads - Nearest Road](/maps/billing-and-pricing/sku-details#nearest-road-pro-sku) | [Main pricing list](/maps/billing-and-pricing/pricing#routes-pricing) [India pricing list](/maps/billing-and-pricing/pricing-india#routes-pricing) |\n| **Pro** | [SKU: Roads - Route Traveled](/maps/billing-and-pricing/sku-details#route-traveled-pro-sku) | [Main pricing list](/maps/billing-and-pricing/pricing#routes-pricing) [India pricing list](/maps/billing-and-pricing/pricing-india#routes-pricing) |\n| **Pro** | [SKU: Roads - Speed Limits](/maps/billing-and-pricing/sku-details#speed-limits-pro-sku)^1^ | [Main pricing list](/maps/billing-and-pricing/pricing#routes-pricing) [India pricing list](/maps/billing-and-pricing/pricing-india#routes-pricing) |\n\n^1^ This SKU has limited access.\n\n\nUsage limits\n------------\n\nWhile there is no maximum number of requests per day, the following\nusage limits are in place for the Roads API:\n\n- Requests per minute are limited, calculated across all\n Roads API endpoints.\n\n | **Note:** The usage limit is based on number of requests for the Speed Limits endpoint as well, even though billing is based on the number of elements.\n- A maximum of 100 points per request.\n\n\nAdjust quota\n------------\n\n\nQuota limits define the maximum number of requests allowed for a specific API or service within a\ngiven timeframe. When the number of requests in your project reaches the quota limit, your service\nstops responding to requests.\n| **Important:** To understand how an increase in quota could affect your bill, check out the [pricing calculator](https://mapsplatform.google.com/pricing/#pricing-calculator).\n\nTo modify a quota value for your API, follow these steps:\n\n1. In the Cloud console, navigate to **Google Maps Platform \\\u003e Quotas**.\n2. Select the API for which you want to modify the quota.\n3. Identify the quota value that you want to change, and select it using the checkbox.\n4. Click **Edit** , enter a new quota value, and click **Submit request**.\n\n### View quota increase requests\n\n| **Important:** You must have the appropriate [IAM permissions to view quota increase requests](https://cloud.google.com/docs/quotas/permissions#permissions_increase).\n\nTo view all quota increase requests, including past and pending requests:\n\n1. In the Cloud console, navigate to **Google Maps Platform \\\u003e Quotas**.\n2. Select the API for which you want to view the quota increase request.\n3. Click **Increase Requests**.\n\n| **Tip:** Make sure to monitor your quota usage regularly to avoid service interruptions. [Learn more about quotas and\n| quota alerts](/maps/billing-and-pricing/manage-costs#quotas).\n\nTerms of Use restrictions\n-------------------------\n\nFor information on terms of use, see\n[policies for the Roads API](/maps/documentation/roads/policies), and the\n[License Restrictions section](https://cloud.google.com/maps-platform/terms/#3.-license.)\nof the Google Maps Platform Terms of Service. \n\n*** ** * ** ***"]]
