ההדגמה הזו מראה איך להשתמש ב-כיוונים API כדי לקבל קבוצה של מסלולי נסיעה ממיקום אחד לאחר. ניתן להריץ את ההדגמה הזו ללא חיוב. הפעלת ההדגמה הזו לבד לא חורגת מהמכסה החודשית שלך.
כדי להשתמש ב-כיוונים API, השלימו את שלבי ההגדרה הנדרשים על ידי לחיצה על הכרטיסיות הבאות:
שלב 1
מסוף
-
במסוף Google Cloud, בדף לבחירת הפרויקט לוחצים על Create Project כדי להתחיל ליצור פרויקט חדש ב-Cloud.
-
הקפידו לוודא שהחיוב מופעל בפרויקט שלכם ב-Cloud. מוודאים שהחיוב מופעל בפרויקט שלכם.
ב-Google Cloud אנחנו מציעים תקופת ניסיון לחיוב ב-$0.00. תקופת הניסיון תסתיים לאחר 90 יום, או לאחר שנצברו בחשבון חיובים בסך 300 דולר, המוקדם מבין השניים. אפשר לבטל בכל שלב. הפלטפורמה של מפות Google כוללת קרדיט חודשי בסך 800 ש"ח. למידע נוסף, ראו זיכויים בחשבון לחיוב וחיוב.
Cloud SDK
gcloud projects create "PROJECT"
מידע נוסף על Google Cloud SDK , Cloud SDK install ועל הפקודות הבאות:
שלב 2
כדי להשתמש בפלטפורמה של מפות Google, עליכם להפעיל את ממשקי ה-API או ערכות ה-SDK שבהם אתם מתכננים להשתמש בפרויקט.
מסוף
Cloud SDK
gcloud services enable \ --project "PROJECT" \ "directions-backend.googleapis.com"
מידע נוסף על Google Cloud SDK , Cloud SDK install ועל הפקודות הבאות:
שלב 3
שלב זה מתבצע רק בתהליך יצירת מפתח ה-API. אם מפתח ה-API שלך נמצא בשימוש בסביבת הייצור, מומלץ מאוד להגביל את מפתח ה-API שלך. ניתן למצוא מידע נוסף בדף הספציפי, באמצעות שימוש במפתחות API.
מפתח ה-API הוא מזהה ייחודי שמאמת בקשות שמשויכות לפרויקט שלך, למטרות שימוש וחיוב. צריך לשייך למפתח לפחות מפתח API אחד.
כך יוצרים מפתח API:
מסוף
-
עוברים לדף פלטפורמה של מפות Google > פרטי כניסה.
-
בדף Credentials, לוחצים על Create credentials > API key.
תיבת הדו-שיח API key created מציגה את מפתח ה-API החדש. -
לוחצים על סגירה.
מפתח ה-API החדש מופיע בדף פרטי הכניסה בקטע מפתחות API.
(זכרו להגביל את מפתח ה-API לפני שמשתמשים בו בסביבת הייצור).
Cloud SDK
gcloud alpha services api-keys create \ --project "PROJECT" \ --display-name "DISPLAY_NAME"
מידע נוסף על Google Cloud SDK , Cloud SDK install ועל הפקודות הבאות:
מקבל מסלול
כדי לקבל הוראות נסיעה מ-Disneyland ל-Universal Studios, הוליווד בפורמט JSON, מזינים את כתובת ה-URL בדפדפן האינטרנט ומחליפים את הערך YOUR_API_KEY במפתח ה-API:
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 כדי להפסיק את החיוב על כל המשאבים באותו פרויקט.
- במסוף Google Cloud, נכנסים לדף Manage resources:
- אם הפרויקט שרוצים למחוק מחובר לארגון, בוחרים ומרחיבים את רשימת הארגונים בראש הדף.
- ברשימת הפרויקטים, בוחרים את הפרויקט שרוצים למחוק ולוחצים על Delete.
- כדי למחוק את הפרויקט, כותבים את מזהה הפרויקט בתיבת הדו-שיח ולוחצים על Shut down.
השלבים הבאים
כדי להתחיל לפתח את המסלול באמצעות ה-API של המסלולים, מגדירים את הפרויקט ב-Google Cloud:
כדי לקבל רשימה של כל הפרמטרים כשאתם יוצרים את בקשת ה-HTTP API ל-DIRECTION API:
נלמד איך לתכנת ספריות לקוח שמספקות הטמעות פשוטות ומותאמות למשימות נפוצות, כמו אימות, ויסות בקשות וניסיון אוטומטי. ה-API של כיוונים זמין בלקוח Java, ב-Python Client, ב-Go Client וב-Node.js Client עבור שירותי מפות Google.