يوضح لك هذا العرض التوضيحي كيفية استخدام Directions API للحصول على مجموعة من اتجاهات القيادة من موقع إلى آخر. يمكنك تشغيل هذا الإصدار التجريبي بدون أي رسوم. لا يتجاوز تشغيل هذا العرض التوضيحي وحده حصتك الشهرية.
لاستخدام توجيهات API، عليك إكمال خطوات الإعداد المطلوبة من خلال النقر على علامات التبويب التالية:
الخطوة 1
وحدة التحكم
-
في Google Cloud Console، انقر على إنشاء مشروع في صفحة أداة اختيار المشروع لبدء إنشاء مشروع جديد على Google Cloud.
-
تأكَّد من تفعيل الفوترة لمشروعك على Google Cloud. تأكَّد من تفعيل الفوترة لمشروعك.
تقدّم خدمة Google Cloud فترة تجريبية مجانية تبلغ 0.00 دولار أمريكي. تنتهي صلاحية الفترة التجريبية في نهاية 90 يومًا أو بعد تراكم رسوم قدرها 300 دولار أمريكي (أو ما يعادلها بالعملة المحلية) على الحساب، أيهما أقرب. ويمكنك إلغاء الاشتراك في أي وقت. تتميز "منصة خرائط Google" برصيد شهري بقيمة 200 دولار أمريكي (أو ما يعادله بالعملة المحلية) متكرر. لمزيد من المعلومات، يُرجى الاطّلاع على أرصدة حساب الفوترة والفوترة.
Cloud SDK
gcloud projects create "PROJECT"
يمكنك الاطّلاع على مزيد من المعلومات عن حزمة تطوير البرامج (SDK) في Google Cloud، وتثبيت حزمة تطوير البرامج (SDK) في السحابة الإلكترونية والأوامر التالية:
الخطوة 2
لاستخدام "منصة خرائط Google"، يجب تفعيل واجهات برمجة التطبيقات أو حِزم تطوير البرامج (SDK) التي تخطط لاستخدامها مع مشروعك.
وحدة التحكم
Cloud SDK
gcloud services enable \ --project "PROJECT" \ "directions-backend.googleapis.com"
يمكنك الاطّلاع على مزيد من المعلومات عن حزمة تطوير البرامج (SDK) في Google Cloud، وتثبيت حزمة تطوير البرامج (SDK) في السحابة الإلكترونية والأوامر التالية:
الخطوة 3
تمر هذه الخطوة فقط خلال عملية إنشاء مفتاح واجهة برمجة التطبيقات. إذا كنت تستخدم مفتاح واجهة برمجة التطبيقات في الإنتاج، ننصحك بشدة بحظر مفتاح واجهة برمجة التطبيقات الخاص بك. ويمكنك العثور على مزيد من المعلومات في الصفحة الخاصة بالمنتج استخدام مفاتيح واجهة برمجة التطبيقات.
مفتاح واجهة برمجة التطبيقات هو معرّف فريد يصادق على الطلبات المرتبطة بمشروعك لأغراض الاستخدام والفوترة. يجب أن يكون لديك مفتاح واجهة برمجة تطبيقات واحد على الأقل مرتبط بمشروعك.
لإنشاء مفتاح واجهة برمجة التطبيقات:
وحدة التحكم
-
انتقِل إلى صفحة منصة خرائط Google > بيانات الاعتماد.
-
في صفحة بيانات الاعتماد، انقر على إنشاء بيانات اعتماد > مفتاح واجهة برمجة التطبيقات.
يعرض مربّع الحوار تم إنشاء مفتاح واجهة برمجة التطبيقات مفتاح واجهة برمجة التطبيقات الذي تم إنشاؤه حديثًا. -
انقر على إغلاق.
يتم إدراج مفتاح واجهة برمجة التطبيقات الجديد في صفحة بيانات الاعتماد ضمن مفاتيح واجهة برمجة التطبيقات.
(احرص على تقييد مفتاح واجهة برمجة التطبيقات قبل استخدامه في مرحلة الإنتاج.)
Cloud SDK
gcloud alpha services api-keys create \ --project "PROJECT" \ --display-name "DISPLAY_NAME"
يمكنك الاطّلاع على مزيد من المعلومات عن حزمة تطوير البرامج (SDK) في Google Cloud، وتثبيت حزمة تطوير البرامج (SDK) في السحابة الإلكترونية والأوامر التالية:
الحصول على الاتجاهات
لتلقّي اتجاهات القيادة من Disneyland إلى Universal Studios، هوليوود بتنسيق JSON، أدخِل عنوان URL في متصفّح الويب واستبدل YOUR_API_KEY بمفتاح واجهة برمجة التطبيقات:
https://maps.googleapis.com/maps/api/directions/json?origin=Disneyland&destination=Universal+Studios+Hollywood&key=YOUR_API_KEY
من المفترض أن تتلقّى استجابة JSON التالية:
{ "geocoded_waypoints" : [ { "geocoder_status" : "OK", "place_id" : "ChIJRVY_etDX3IARGYLVpoq7f68", "types" : [ "bus_station", "transit_station", "point_of_interest", "establishment" ] }, { "geocoder_status" : "OK", "partial_match" : true, "place_id" : "ChIJp2Mn4E2-woARQS2FILlxUzk", "types" : [ "route" ] } ], "routes" : [ { "bounds" : { "northeast" : { "lat" : 34.1330949, "lng" : -117.9143879 }, "southwest" : { "lat" : 33.8068768, "lng" : -118.3527671 } }, "copyrights" : "Map data ©2016 Google", "legs" : [ { "distance" : { "text" : "35.9 mi", "value" : 57824 }, "duration" : { "text" : "51 mins", "value" : 3062 }, "end_address" : "Universal Studios Blvd, Los Angeles, CA 90068, USA", "end_location" : { "lat" : 34.1330949, "lng" : -118.3524442 }, "start_address" : "Disneyland (Harbor Blvd.), S Harbor Blvd, Anaheim, CA 92802, USA", "start_location" : { "lat" : 33.8098177, "lng" : -117.9154353 }, ... Additional results shortened in this example[] ... "overview_polyline" : { "points" : "knjmEnjunUbKCfEA?_@]@kMBeE@qIIoF@wH@eFFk@WOUI_@?u@j@k@`@EXLTZHh@Y`AgApAaCrCUd@cDpDuAtAoApA{YlZiBdBaIhGkFrDeCtBuFxFmIdJmOjPaChDeBlDiAdD}ApGcDxU}@hEmAxD}[tt@yNb\\yBdEqFnJqB~DeFxMgK~VsMr[uKzVoCxEsEtG}BzCkHhKWh@]t@{AxEcClLkCjLi@`CwBfHaEzJuBdEyEhIaBnCiF|K_Oz\\ {MdZwAbDaKbUiB|CgCnDkDbEiE|FqBlDsLdXqQra@kX|m@aF|KcHtLm@pAaE~JcTxh@w\\`v@gQv`@}F`MqK`PeGzIyGfJiG~GeLhLgIpIcE~FsDrHcFfLqDzH{CxEwAbBgC|B}F|DiQzKsbBdeA{k@~\\oc@bWoKjGaEzCoEzEwDxFsUh^wJfOySx[uBnCgCbCoFlDmDvAiCr@eRzDuNxC_EvAiFpCaC|AqGpEwHzFoQnQoTrTqBlCyDnGmCfEmDpDyGzGsIzHuZzYwBpBsC`CqBlAsBbAqCxAoBrAqDdDcNfMgHbHiPtReBtCkD|GqAhBwBzBsG~FoAhAaCbDeBvD_BlEyM``@uBvKiA~DmAlCkA|B}@lBcChHoJnXcB`GoAnIS~CIjFDd]A|QMlD{@jH[vAk@`CoGxRgPzf@aBbHoB~HeMx^eDtJ}BnG{DhJU`@mBzCoCjDaAx@mAnAgCnBmAp@uAj@{Cr@wBPkB@kBSsEW{GV}BEeCWyAWwHs@qH? cIHkDXuDn@mCt@mE`BsH|CyAp@}AdAaAtAy@lBg@pCa@jE]fEcBhRq@pJKlCk@hLFrB@lD_@xCeA`DoBxDaHvM_FzImDzFeCpDeC|CkExDiJrHcBtAkDpDwObVuCpFeCdHoIl\\uBjIuClJsEvMyDbMqAhEoDlJ{C|J}FlZuBfLyDlXwB~QkArG_AnDiAxC{G|OgEdLaE`LkBbEwG~KgHnLoEjGgDxCaC`BuJdFkFtCgCnBuClD_HdMqEzHcBpB_C|BuEzCmPlIuE|B_EtDeBhCgAdCw@rCi@|DSfECrCAdCS~Di@jDYhA_AlC{AxCcL`U{GvM_DjFkBzBsB`BqDhBaEfAsTvEmEr@iCr@qDrAiFnCcEzCaE~D_@JmFdGQDwBvCeErEoD|BcFjC}DbEuD~D`@Zr@h@?d@Wr@}@vAgCbEaHfMqA`Cy@dAg@bAO`@gCi@w@W" }, "summary" : "I-5 N and US-101 N", "warnings" : [], "waypoint_order" : [] } ], "status" : "OK" }
تهانينا! لقد تمكّنت بنجاح من إعداد واستدعيت واجهة برمجة التطبيقات للاتجاهات للحصول على الاتجاهات.
جارٍ التنظيف
يمكنك حذف مشروعك على Google Cloud لإيقاف الفوترة لجميع الموارد المستخدَمة ضمن هذا المشروع.
- في Google Cloud Console، انتقِل إلى صفحة إدارة الموارد:
- إذا كان المشروع الذي تخطط لحذفه مرتبطًا بمؤسسة، اختَر قائمة المؤسسات في أعلى الصفحة ووسِّعها.
- في قائمة المشاريع، اختَر المشروع الذي تريد حذفه وانقر على حذف.
- في مربع الحوار، اكتب رقم تعريف المشروع وانقر على إيقاف التشغيل لحذف المشروع.
الخطوات التالية
ابدأ التطوير باستخدام Directions API من خلال إعداد مشروعك على Google Cloud:
للحصول على قائمة بجميع المعلَمات عند إنشاء طلب HTTP لواجهة برمجة التطبيقات للاتجاهات:
تعرَّف على كيفية الترميز من خلال مكتبات العملاء التي توفّر عمليات تنفيذ بسيطة وأصلية للمهام الشائعة، مثل المصادقة وتقييد الطلبات وإعادة المحاولة التلقائية. تتوفّر واجهة برمجة التطبيقات الاتجاهات في Java Client وPython Client وGo Client وNode.js Client for Google Maps Services.