דוגמאות

בקטע הזה נספק כמה דוגמאות לבקשות ל-Places Insights API.

הצגת מקומות בתוך מעגל

הצגת כל המסעדות ברדיוס של 200 מטר מכיכר טרפלגר בלונדון.

  • אזור החיפוש הוא עיגול שמרכזו קו אורך וקו רוחב ספציפיים. רדיוס המעגל הזה הוא 200 מטרים, והוא קובע את גודל אזור החיפוש.
  • סוג המקום המבוקש הוא מסעדה, והוא מועבר באמצעות includedTypes בתוך typeFilters.
  • הבקשה למספר מתבצעת באמצעות INSIGHTS_COUNT, והבקשה למזהי המקומות מתבצעת באמצעות INSIGHTS_PLACES.
curl --location 'https://areainsights.googleapis.com/v1:computeInsights' \
--header 'X-Goog-Api-Key: API_KEY' \
--header 'Content-Type: application/json' \
--data '{
  "insights": ["INSIGHT_COUNT", "INSIGHT_PLACES"],
  "filter": {
    "locationFilter": {
      "circle": {
        "latLng": { "latitude": 51.508, "longitude": -0.128},
        "radius": 200
      }
    },
    "typeFilter": { "includedTypes": "restaurant" }
  }
}'

החרגת סוגי מקומות

אתם יכולים להחריג סוגי מקומות מהספירה.

הבקשה הבאה זהה לדוגמה הראשונה, אבל נוספת לה הערך excludedTypes בשדה typeFilters. אפשר להשתמש במחרוזת או במערך של מחרוזות למאפיינים includedTypes ו-excludedTypes.

בדוגמה הזו, שני סוגי מקומות – cafe ו-bakery – לא נכללים בספירה של restaurant.

curl --location 'https://areainsights.googleapis.com/v1:computeInsights' \
--header 'X-Goog-Api-Key: API_KEY' \
--header 'Content-Type: application/json' \
--data '{
    "insights": ["INSIGHT_COUNT", "INSIGHT_PLACES"],
    "filter": {
        "locationFilter": {
            "circle": {
                "latLng": { "latitude": 51.508, "longitude": -0.128},
                "radius": 200
            }
        },
        "typeFilter": {
            "includedTypes": "restaurant",
            "excludedTypes": [
                "cafe",
                "bakery"
            ]
        }
    }
}'

שימוש בסוג הראשי

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

curl --location 'https://areainsights.googleapis.com/v1:computeInsights' \
--header 'X-Goog-Api-Key: API_KEY' \
--header 'Content-Type: application/json' \
--data '{
  "insights": ["INSIGHT_COUNT", "INSIGHT_PLACES"],
  "filter": {
    "locationFilter": {
      "circle": {
        "latLng": { "latitude": 51.508, "longitude": -0.128},
        "radius": 200
      }
    },
    "typeFilter": { "includedPrimaryTypes": "restaurant" }
  }
}'

פוליגון מותאם אישית

בדוגמה הזו מוסבר איך להשתמש בפוליגון מותאם אישית כדי להגדיר את אזור החיפוש. חשוב לזכור שציון הערך INSIGHTS_PLACES מגביל את החיפוש לאזורים קטנים מספיק כדי להחזיר עד 100 מזהי מקומות. באזורים גדולים יותר, אפשר להשתמש ב-INSIGHTS_COUNT כדי לעקוף את המגבלה הזו, כך שהשירות לא יצטרך להחזיר מזהי מקומות נפרדים.

כמו קודם, סוג המקום שבו נעשה שימוש הוא restaurant. בדוגמה הזו מוצגים גם שלושה מסננים נוספים:

  • operatingStatus: בדוגמה הזו נספרים רק מקומות שפועלים.
  • priceLevel: בדוגמה הזו נספרים רק מקומות במחירים נמוכים ובמחירים סבירים.
  • ratingFilter: בדוגמה הזו נספרים רק מקומות עם ציון ביקורות בין 4.0 ל-5.0.
curl --location 'https://areainsights.googleapis.com/v1:computeInsights' \
--header 'X-Goog-Api-Key: API_KEY' \
--header 'Content-Type: application/json' \
--data '{
    "insights": [ "INSIGHT_COUNT" ],
    "filter": {
        "locationFilter": {
            "customArea": {
                "polygon": {
                    "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 }
                    ]
                }
            }
        },
        "typeFilter": {
            "includedTypes": "restaurant"
        },
        "operatingStatus": [ "OPERATING_STATUS_OPERATIONAL" ],
        "priceLevels": [ "PRICE_LEVEL_INEXPENSIVE", "PRICE_LEVEL_MODERATE" ],
        "ratingFilter": { "minRating": 4.0, "maxRating": 5.0 }
    }
}'

אזור גיאוגרפי

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

העברת מזהה המקום ל-Places Insights API מגדירה את אזור החיפוש לפי גבולות האזור הגיאוגרפי. מזהה המקום מועבר באמצעות place, בפורמט places/place_ID.

אפשר לקבל מזהה מקום של אזור גיאוגרפי באחת מהדרכים הבאות:

curl --location 'https://areainsights.googleapis.com/v1:computeInsights' \
--header 'X-Goog-Api-Key: API_KEY' \
--header 'Content-Type: application/json' \
--data '{
    "insights": [
        "INSIGHT_COUNT"
    ],
    "filter": {
        "locationFilter": {
            "region": {
                "place": "places/ChIJiQHsW0m3j4ARm69rRkrUF3w"
            }
        },
        "typeFilter": {
            "includedTypes": [
                "restaurant"
            ]
        }
    }
}'