الإصدار التجريبي من Directions API

يوضّح لك هذا العرض التقديمي كيفية استخدام واجهة برمجة التطبيقات Directions API للحصول على مجموعة من اتجاهات القيادة من موقع إلى آخر. يمكنك إجراء هذا الإصدار التجريبي بدون أي رسوم. لا يؤدي تشغيل هذا العرض التجريبي وحده إلى تجاوز الحصة الشهرية.

لاستخدام Directions API، أكمِل خطوات الإعداد المطلوبة من خلال النقر على علامات التبويب التالية:

gcloud projects create "PROJECT"

gcloud services enable \
    --project "PROJECT" \
    "directions-backend.googleapis.com"

gcloud alpha services api-keys create \
    --project "PROJECT" \
    --display-name "DISPLAY_NAME"

الحصول على الاتجاهات

للحصول على اتجاهات القيادة من ديزني لاند إلى 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"
    }

تهانينا! لقد أعددت واجهة برمجة التطبيقات Directions API وطلبت منها تلقّي الاتجاهات بنجاح.

تنظيف

يمكنك حذف مشروعك على Google Cloud لإيقاف الفوترة مقابل جميع الموارد المستخدَمة في ذلك المشروع.

1. في Google Cloud Console، انتقِل إلى صفحة إدارة الموارد:

   الانتقال إلى صفحة "إدارة الموارد"

2. إذا كان المشروع الذي تريد حذفه مرتبطًا بمؤسسة، اختَر قائمة المؤسسات في أعلى الصفحة ووسِّعها.
3. في قائمة المشاريع، اختَر المشروع الذي تريد حذفه وانقر على حذف.
4. في مربّع الحوار، اكتب رقم تعريف المشروع وانقر على إيقاف لحذف المشروع.

الخطوات التالية

• ابدأ عملية التطوير باستخدام Directions API من خلال إعداد مشروعك على Google Cloud:

  الإعداد في Cloud Console

• للحصول على قائمة بجميع المَعلمات عند إنشاء طلب HTTP لـ Directions API:

  الحصول على الاتجاهات

• تعرَّف على كيفية الترميز باستخدام مكتبات العملاء التي توفّر عمليات تنفيذ بسيطة ومدمجة للمهام الشائعة، مثل المصادقة وتقييد معدل إرسال الطلبات وإعادة المحاولة التلقائية. تتوفّر واجهة برمجة التطبيقات Directions API في برنامج Java Client وبرنامج Python Client وبرنامج Go Client وبرنامج Node.js Client لخدمات "خرائط Google".