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