פרמטרים של בקשות

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

Places Insights API מאפשר לבצע כמה פונקציות מרכזיות:

  • ספירת מקומות: קביעת מספר המקומות שתואמים למקומות מסוימים קריטריונים כמו סוג המיקום, סטטוס הפעילות, רמת המחיר והדירוגים.
  • אחזור פרטי מקומות: קבלת שמות של מקומות שעומדים בתנאים מסננים ספציפיים, ואז לאחזר מידע מפורט יותר באמצעות Places API.
  • סינון גמיש: החלה של מסננים מקיפים כדי לקבל תובנות מדויקות. המסננים הזמינים כוללים:
    • אזור גיאוגרפי (עיגול, אזור או פוליגון מותאם אישית)
    • סוגי מקומות
    • סטטוס פעילות
    • רמות מחירים
    • טווחי דירוג

פרמטרים נדרשים

בקטע הזה מפורטים הפרמטרים הנדרשים לשליחת בקשה אל Places Insights API. כל בקשה צריכה לכלול את הפרטים הבאים:

  • סוג של תובנה.
  • מסנן מיקום ומסנן סוגים.

תובנה

קובעים את סוג התובנות שרוצים לחשב. סוגי התובנות הבאים נתמכים:

  • INSIGHT_COUNT: מחזירה את מספר המקומות שתואמים לקריטריונים של המסנן.
  • INSIGHT_PLACES: הפונקציה מחזירה את מזהי המקומות שתואמים לקריטריונים של המסנן.

הערה: אם בוחרים באפשרות הזו, Places Insights API מחזיר מזהי מקומות רק אם הערך של count הוא 100 או פחות.

סינון

מציינת את הקריטריונים לסינון מקומות. לכל הפחות, עליך לציין את LocationFilter וגם TypeFilter

מסנן מיקומים

מסנן מיקומים יכול להיות מאחד מהסוגים הבאים:

  • circle: מגדיר שטח כעיגול עם מרכז ורדיוס.
  • region: מגדיר אזור כאזור.
  • custom_area: מגדיר שטח כפוליגון מותאם אישית.
מעגל

אם בחרת את האזור הגיאוגרפי שלך כעיגול, עליך לספק center וradius. המרכז יכול להיות קו רוחב וקו אורך, או המקום המזהה של מרכז המעגל.

  • center:
    • lat_lng: קו הרוחב וקו האורך של מרכז המעגל. קווי רוחב חייב להיות מספר בין -90, 90, כולל. קו האורך חייב להיות מספר בין -180 ל-180, כולל.
    • place: מזהה המקום של מרכז העיגול. שימו לב שרק נקודה מקומות נתמכים. המחרוזת הזו חייבת להתחיל בקידומת places/.
  • radius: רדיוס המעגל במטרים. המספר הזה חייב להיות חיובי.
אזור

אפשר להגדיר את האזור כאזור באמצעות הפרמטר place. שימוש במזהה מקום שמייצג אזור גיאוגרפי (למשל אזור שאפשר לייצג פוליגון). לדוגמה, מזהה המקום טמפה, פלורידה הוא places/ChIJ4dG5s4K3wogRY7SWr4kTX6c

סוגי אזורים שלא נתמכים
establishment place_of_worship
floor post_box
food postal_code_suffix
general_contractor room
geocode street_address
health street_number
intersection sublocality_level_5
landmark subpremise

אפשר להשתמש בשדה types מקריאה ל-Geocoding API כדי לקבוע הסוג של המיקום או הכתובת שמשויכים למזהה של מקום, למשל אם מדובר עיר, שכונה או מדינה.

אזור מותאם אישית

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

אפשר להיכנס לכתובת https://geojson.io/ כדי לשרטט פוליגון מותאם אישית, להזין את הקואורדינטות האלה בבקשה. פוליגון חייב לכלול 4 לפחות שבהן הקואורדינטה הראשונה והאחרונה זהות. מלבד הקואורדינטה הראשונה והאחרונה, אסור שיהיו קואורדינטות כפולות נוספות. לדוגמה:

"coordinates":[
   {
      "latitude":37.776,
      "longitude":-122.666
   },
   {
      "latitude":37.130,
      "longitude":-121.898
   },
   {
      "latitude":37.326,
      "longitude":-121.598
   },
   {
      "latitude":37.912,
      "longitude":-122.247
   },
   {
      "latitude":37.776,
      "longitude":-122.666
   }
]

מסנן סוג

קובעת את סוגי המקומות להכללה או להחרגה. לרשימה של ועל סוגי מקומות משניים שנתמכים ב-Place Insights API, עיינו במאמר טבלה א במדריך סוגי מקומות ל-Places API (חדש). לפחות סוג אחד של included_types או included_primary_types חייב להיות כלול.

  • included_types: רשימה של סוגי המקומות הכלולים.
  • excluded_types: רשימה של סוגי מקומות שהוחרגו.
  • included_primary_types: רשימה של סוגי המקומות הראשיים הכלולים.
  • excluded_primary_types: רשימה של סוגי מקומות ראשיים שהוחרגו.

מידע נוסף על אופן הפעולה של מסנני סוגים וסוגי מקומות זמין במידע נוסף על סוג מסננים.

פרמטרים אופציונליים

שלושת המסננים הנותרים הם אופציונליים:

  • operating_status: מציין את הסטטוסים של מקומות שרוצים לכלול או להחריג. ברירת המחדל היא סינון לפי operating_status: OPERATING_STATUS_OPERATIONAL (ערך ספציפי אחד).
  • price_levels: מציין את רמות המחירים של המקומות. ברירת המחדל היא 'לא' סינון (כל רמות המחירים נכללות בתוצאות).
  • rating_filter: מציין את טווח הדירוגים של המקומות. ברירת המחדל היא 'לא' סינון (כל הדירוגים כלולים בתוצאות).

סטטוס פעילות

סינון לפי סטטוס הפעילות (למשל: תפעולי או זמני נסגרה).

רמת מחירים

סינון לפי רמת מחיר (למשל, בחינם, בינוני או יקר).

מסנן דירוג

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

  • min_rating: דירוג משתמשים ממוצע מינימלי (בין 1.0 ל-5.0).
  • max_rating: דירוג משתמשים ממוצע מקסימלי (בין 1.0 ל-5.0).