Places Aggregate API, שנקרא בעבר Places Insights API, זמין עכשיו לכלל המשתמשים (GA).
שאלות נפוצות על Places Aggregate API
קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
האם יש הגבלת קצב על ה-API?
ל-Places Aggregate API יש מכסת ברירת מחדל של 1,200 שאילתות לדקה.
מה ההבדל בין 'included_primary_types' לבין 'included_types' ב-TypeFilter?
-
included_primary_types: מסננים למקומות שבהם הסוגים שצוינו הם הקטגוריה הראשית או העיקרית שלהם. יכול להיות שלמקומות האלה יש גם סוגים משניים אחרים.
-
included_types: מסנן מקומות לפי הסוגים שצוינו כקטגוריות שלהם, בלי קשר אם זה הסוג הראשי או המשני.
לדוגמה, חיפוש עם included_primary_types שמוגדר ל-restaurant יחזיר מקומות שהפונקציה העיקרית שלהם היא הגשת אוכל, בעוד שחיפוש עם included_types שמוגדר ל-restaurant יחזיר מקומות שמגישים אוכל גם אם יש להם קטגוריה ראשית אחרת, כמו museum עם cafe.
מידע נוסף זמין במאמר סוגי מקומות.
איך מגדירים אזור חיפוש מותאם אישית שאינו עיגול?
אפשר להגדיר אזור חיפוש מותאם אישית באמצעות פוליגון. צריך לספק רשימה של קואורדינטות של קו רוחב וקו אורך שמגדירות את הקודקודים של פוליגון יחיד בסדר נגד כיוון השעון. הקואורדינטות הראשונות והאחרונות חייבות להיות זהות כדי לסגור את הפוליגון.
אלא אם צוין אחרת, התוכן של דף זה הוא ברישיון Creative Commons Attribution 4.0 ודוגמאות הקוד הן ברישיון Apache 2.0. לפרטים, ניתן לעיין במדיניות האתר Google Developers. Java הוא סימן מסחרי רשום של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2025-08-29 (שעון UTC).
[null,null,["עדכון אחרון: 2025-08-29 (שעון UTC)."],[],[],null,["# Places Aggregate API FAQ\n\nIs there a rate limit on the API?\n---------------------------------\n\nFor Places Aggregate API, there is a default rate limit of\n1,200 queries per minute.\n\nWhat is the difference between 'included_primary_types' and 'included_types' in the TypeFilter?\n-----------------------------------------------------------------------------------------------\n\n- `included_primary_types`: Filters for places where the specified types are their main or primary category. These places might also have other secondary types.\n- `included_types`: Filters for places that have the specified types as any of their categories, regardless of whether it's the primary or secondary type.\n\nFor example, a search using `included_primary_types` set to `restaurant` would\nreturn places whose primary function is to serve food, whereas `included_types`\nset to `restaurant` would return places that serve food even if they have\nanother primary category, such as a `museum` with a `cafe`.\n\nFor further reading, visit [Place Types](/maps/documentation/places/web-service/place-types).\n\nHow do I define a custom search area that isn't a circle?\n---------------------------------------------------------\n\nYou can define a custom search area using a polygon. Provide a list of latitude\nand longitude coordinates that define the vertices of a single polygon in a\ncounter-clockwise order. The first and last coordinates *must* be the same to\nclose the polygon."]]
