מזהי מקומות

קל לארגן דפים בעזרת אוספים אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
בחירת פלטפורמה: Android iOS JavaScript שירות אינטרנט

מזהי מקומות מזהים באופן ייחודי מקום במסד הנתונים של מקומות Google ובמפות Google. מזהי מקומות מתקבלים בבקשות לממשקי ה-API הבאים של מפות Google:

  • אחזור כתובת בשביל מזהה מקום בשירות האינטרנט Geocoding API ובשירות Geocoding API, Maps JavaScript API.
  • ציון נקודות המוצא, היעד ונקודת הביניים בשירות האינטרנט כיוונים API ובשירות מסלול, Maps JavaScript API.
  • ציון של מקורות ויעדים בשירות האינטרנט API של מטריצת מרחקים ושל שירות Matrix API, Maps JavaScript API.
  • מתבצע אחזור של פרטי מקומות בשירות האינטרנט של ה-API של מקומות Google, ה-SDK של מקומות ל-Android, ה-SDK של מקומות ל-iOS וספריית המקומות, JavaScript API.
  • שימוש בפרמטרים של מזהה מיקום ב-Maps embed API.
  • אחזור שאילתות חיפוש בכתובות URL של מפות Google.
  • הצגת מגבלות מהירות ב-Roads API.
  • חיפוש ועיצוב של פוליגונים בסגנון גבולי בסגנון מבוסס-נתונים.

איך למצוא את המזהה של מקום מסוים

רוצה למצוא את מזהה המקום של מקום ספציפי? כדי למצוא מקום מסוים ולקבל את המזהה שלו, אפשר להשתמש בכלי לחיפוש מזהה המקום שלמטה.

לחלופין, אפשר להציג את מאתר המקומות עם הקוד שלו בתיעוד של ה-API של JavaScript ב-Maps.

סקירה כללית

מזהה מקום הוא מזהה טקסט שמזהה מקום באופן ייחודי. האורך של המזהה עשוי להשתנות (אין מגבלת אורך למזהי מקום). דוגמאות:

  • ChIJgUbEo8cfqokR5lP9_Wh_DaM
  • GhIJQWDl0CIeQUARxks3icF8U8A
  • EicxMyBNYXJrZXQgU3QsIFdpbG1pbmd0b24sIE5DIDI4NDAxLCBVU0EiGhIYChQKEgnRTo6ixx-qiRHo_bbmkCm7ZRAN
  • EicxMyBNYXJrZXQgU3QsIFdpbG1pbmd0b24sIE5DIDI4NDAxLCBVU0E
  • IhoSGAoUChIJ0U6OoscfqokR6P225pApu2UQDQ

מזהי המקומות זמינים ברוב המיקומים, כולל עסקים, ציוני דרך, פארקים וצמתים. ייתכן שלאותו מקום או מיקום יהיו כמה מזהי מקומות שונים. מזהי המקומות עשויים להשתנות עם הזמן.

ניתן להשתמש באותו מזהה מקום בממשק ה-API של 'מקומות' ובמספר ממשקי API של הפלטפורמה של מפות Google. לדוגמה, אפשר להשתמש באותו מזהה מקום כדי לציין מקום ב-Places API, ב-Maps JavaScript API, ב-geocoding API, ב-Maps embed API וב-Roads API.

אחזור פרטי מקום באמצעות מזהה המקום

מזהי מקומות פטורים מהגבלות השמירה במטמון שמפורטות בסעיף 3.2.3(ב) בתנאים ובהגבלות של הפלטפורמה של מפות Google. לאחר שתזהה את מזהה המקום של מקום מסוים, תוכל להשתמש בו שוב בפעם הבאה שתחפש את המקום. מידע נוסף זמין במאמר שמירת מזהי מקומות לשימוש מאוחר יותר בהמשך.

אחת מהדרכים הנפוצות להשתמש במזהי מקומות היא לחפש מקום (למשל, באמצעות API של מקומות או ספריית המקומות ב-Maps JavaScript API), ואז להשתמש במזהה המקום שהוחזר כדי לאחזר את פרטי המקום. אפשר לאחסן את מזהה המקום ולהשתמש בו כדי לאחזר את אותם פרטי מקום מאוחר יותר. למידע נוסף על שמירת מזהי מקומות בהמשך.

דוגמה לשימוש ב-API של 'מקומות'

באמצעות ה-API של 'מקומות', אפשר למצוא מזהה מקום על ידי שליחת בקשה לחיפוש מקומות.

הדוגמה הבאה היא בקשת חיפוש עבור מקומות מסוג 'restaurant' ברדיוס של 1500 מ' מנקודה מסוימת בסידני באוסטרליה, עם המילה 'שיט':

https://maps.googleapis.com/maps/api/place/nearbysearch/json?location=-33.8670522,151.1957362&radius=1500&type=restaurant&keyword=cruise&key=YOUR_API_KEY

התגובה כוללת מזהה מקום בשדה place_id, כפי שמוצג בקטע הקוד הזה:

{
  "html_attributions" : [],
  "results" : [
    {
      "geometry" : {
        "location" : {
          "lat" : -33.870775,
          "lng" : 151.199025
        }
      },
      ...
      "place_id" : "ChIJrTLr-GyuEmsRBfy61i59si0",
      ...
    }
  ],
  "status" : "OK"
}

לתיאור של כל השדות בתגובה, אפשר לעיין במאמר חיפוש מקום.

עכשיו אתם יכולים לשלוח בקשה של פרטי מקום, ולהוסיף את מזהה המקום לפרמטר place_id:

https://maps.googleapis.com/maps/api/place/details/json?place_id=ChIJrTLr-GyuEmsRBfy61i59si0&key=YOUR_API_KEY

שמירת מזהי מקומות לשימוש מאוחר יותר

מזהי מקומות פטורים מהגבלות השמירה במטמון שמפורטות בסעיף 3.2.3(א) בתנאים ובהגבלות של הפלטפורמה של מפות Google. לכן אפשר לאחסן ערכים של מזהי מקומות לשימוש עתידי.

רענון של מזהי מקומות שמורים

אנחנו ממליצים לרענן את מזהי המקומות אם גילם עולה על 12 חודשים. אתם יכולים לרענן את מזהי המקומות ללא חיוב. לשם כך, שולחים בקשת פרטי מקום, ומציינים רק את השדה place_id בפרמטר fields.

לדוגמה:

  https://maps.googleapis.com/maps/api/place/details/json?place_id=ChIJ05IRjKHxEQ0RJLV_5NLdK2w&fields=place_id&key=YOUR_API_KEY
  

השיחה הזו תפעיל את המק"ט לפרטים של מקום – רענון מזהה מק"ט. עם זאת, הבקשה הזו עשויה להחזיר גם קוד סטטוס NOT_FOUND. אחת מהאסטרטגיות היא לאחסן את הבקשה המקורית שהחזירה כל מזהה מקום. אם מזהה מקום הופך ללא חוקי, אפשר להנפיק מחדש את הבקשה הזו לקבלת תוצאות חדשות. התוצאות האלה יכולות לכלול את המקום המקורי, אבל לא בהכרח. הבקשה היא לחיוב.

קודי שגיאה כשמשתמשים במזהי מקומות

קוד הסטטוס INVALID_REQUEST מציין שמזהה המקום שצוין אינו חוקי. ניתן להחזיר את INVALID_REQUEST כשהמזהה של המקום נקטע או השתנה באופן שגוי, והוא כבר לא נכון.

קוד הסטטוס NOT_FOUND מציין שמזהה המיקום שצוין כבר לא בשימוש. מזהה של מיקום יכול להיות לא עדכני אם עסק נסגר או עובר למיקום חדש. מזהי מקומות עשויים להשתנות עקב עדכונים בקנה מידה גדול במסד הנתונים של מפות Google. במקרים כאלה, מקום מסוים עשוי לקבל מזהה מקום חדש, והמזהה הקודם יחזיר תגובת NOT_FOUND.

באופן ספציפי, סוגים מסוימים של מזהי מקומות עשויים לגרום לפעמים לתגובה של NOT_FOUND, או שה-API עשוי להחזיר מזהה מקום אחר בתגובה. הסוגים האלה של מזהי מקומות כוללים:

  • כתובות רחוב שלא קיימות במפות Google ככתובות מדויקות, אבל הן נגזרות מטווח של כתובות.
  • קטעים של נתיב ארוך, שבהם הבקשה מציינת גם עיר או יישוב.
  • צמתים.
  • מקומות עם רכיב כתובת מסוג subpremise.

המזהים האלה הם בדרך כלל מחרוזת ארוכה (אין מגבלת אורך מקסימלית למזהי המקומות). למשל:

EpID4LC14LC_4LCo4LCv4LGN4LCo4LCX4LCw4LGNIC0g4LC44LGI4LCm4LGN4LCs4LC-4LCm4LGNIOCwsOCxi-CwoeCxjeCwoeCxgSAmIOCwteCwv-CwqOCwr-CxjSDgsKjgsJfgsLDgsY0g4LCu4LGG4LCv4LC_4LCo4LGNIOCwsOCxi-CwoeCxjeCwoeCxgSwg4LC14LC_4LCo4LCv4LGNIOCwqOCwl-CwsOCxjSDgsJXgsL7gsLLgsKjgsYAsIOCwsuCwleCxjeCwt-CxjeCwruCwv-CwqOCwl-CwsOCxjSDgsJXgsL7gsLLgsKjgsYAsIOCwuOCwsOCxguCwsOCxjSDgsKjgsJfgsLDgsY0g4LC14LGG4LC44LGN4LCf4LGNLCDgsLjgsK_gsYDgsKbgsL7gsKzgsL7gsKbgsY0sIOCwueCxiOCwpuCwsOCwvuCwrOCwvuCwpuCxjSwg4LCk4LGG4LCy4LCC4LCX4LC-4LCjIDUwMDA1OSwg4LCt4LC-4LCw4LCk4LCm4LGH4LC24LCCImYiZAoUChIJ31l5uGWYyzsR9zY2qk9lDiASFAoSCd9ZebhlmMs7Efc2NqpPZQ4gGhQKEglDz61OZpjLOxHgDJCFY-o1qBoUChIJi37TW2-YyzsRr_uv50r7tdEiCg1MwFcKFS_dyy4