מידע על Places API (חדש)

מפתחים באזור הכלכלי האירופי (EEA)

מבוא

‫Places API (חדש) כולל את ממשקי ה-API הבאים:

במסמך הזה מופיעה סקירה כללית של ממשקי ה-API החדשים האלה.

Place Details (חדש)

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

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

Place Photos (חדש)

‫Place Photos (חדש) מאפשר לכם להוסיף לאפליקציה תוכן צילומי באיכות גבוהה, באמצעות גישה למיליוני התמונות שמאוחסנות במסד הנתונים של Google Places. באמצעות Place Photos (New) API, אפשר לגשת לתמונות ולשנות את הגודל של התמונה לגודל האופטימלי לאפליקציה.

כל הבקשות אל Place Photos (New) API חייבות לכלול שם של משאב תמונה, שמזהה באופן ייחודי את התמונה שרוצים להחזיר. אפשר לקבל את שם המשאב של התמונה באמצעות:

כדי לכלול את שם המשאב של התמונה בתגובה לבקשה של Place Details (חדש), Text Search (חדש) או Nearby Search (חדש), צריך לוודא שכוללים את השדה photos במסכת השדות של הבקשה.

חיפוש טקסט (חדש) וחיפוש בקרבת מקום (חדש)

‫Places API כולל שני ממשקי API לחיפוש:

  • חיפוש טקסט (חדש)

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

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

  • חיפוש בקרבת מקום (חדש)

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

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

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

השלמה אוטומטית (חדשה) וטוקנים של סשנים

‫Autocomplete (חדש) הוא שירות אינטרנט שמחזיר חיזויים של מקומות וחיזויים של שאילתות בתגובה לבקשת HTTP. בבקשה, מציינים מחרוזת לחיפוש טקסט וגבולות גיאוגרפיים ששולטים באזור החיפוש.

אסימוני סשן הם מחרוזות שנוצרות על ידי המשתמשים ועוקבות אחרי קריאות ל-Autocomplete (חדש) כסשנים. התכונה 'השלמה אוטומטית (חדשה)' משתמשת באסימוני סשן כדי לקבץ את שלבי השאילתה והבחירה של חיפוש השלמה אוטומטית של משתמש לסשן נפרד למטרות חיוב.

שדות, מאפיינים ואפשרויות נגישות חדשים

‫Places API (חדש) כולל שדות, מאפיינים ואפשרויות חדשים של נגישות כדי לספק למשתמשים מידע נוסף על מקום מסוים. ההיבטים האלה מתוארים בקטעים הבאים.

שדות

‫Places API (חדש) כולל כמה שדות חדשים:

שדה תיאור
regularSecondaryOpeningHours תיאור של זמנים מסוימים לפעולות מסוימות. שעות פעילות משניות שונות משעות הפעילות העיקריות של העסק. לדוגמה, מסעדה יכולה לציין את השעות שבהן אפשר להזמין ולקבל את האוכל מהרכב או את השעות שבהן היא מציעה משלוחים כשעות פעילות משניות.
paymentOptions אפשרויות התשלום שהמקום מקבל. יכול להיות שבמקום מסוים מקבלים יותר מאפשרות תשלום אחת. אם נתוני אמצעי התשלום לא זמינים, השדה של אמצעי התשלום לא יוגדר. האפשרויות כוללות את הפעולות הבאות:
  • כרטיס אשראי
  • כרטיס חיוב
  • מזומן בלבד
  • תשלום דרך NFC
parkingOptions אפשרויות החנייה שהמקום מציע. האפשרויות כוללות את הפעולות הבאות:
  • חניונים בחינם
  • מגרשי חנייה בתשלום
  • חניה ברחוב בחינם
  • שירותי החניה של רכבים
  • חניון בחינם
  • חניון בתשלום
subDestinations מקומות ייחודיים שקשורים למקום מסוים. לדוגמה, טרמינלים בנמל תעופה נחשבים ליעדי משנה של נמל התעופה.
fuelOptions המידע העדכני ביותר על אפשרויות הדלק שזמינות בתחנת דלק. המידע הזה מתעדכן באופן קבוע. האפשרויות כוללות את האפשרויות הבאות:
  • סולר
  • רגיל ללא עופרת
  • ביניים
  • פרימיום
  • SP91
  • SP91 E10
  • SP92
  • SP95 E10
  • SP98
  • SP99
  • SP100
  • גפ"מ
  • E80
  • E85
  • מתאן
  • ביו-דיזל
  • סולר למשאית
evChargeOptions מספר המטענים לרכבים חשמליים (EV) בתחנה הזו. למרות שלחלק מעמדות הטעינה לרכבים חשמליים יש כמה מחברים, כל עמדת טעינה יכולה לטעון רק רכב אחד בכל פעם. לכן, בשדה הזה מצוין מספר עמדות הטעינה לרכבים חשמליים שזמינות בזמן נתון.
shortFormattedAddress כתובת קצרה של מקום, שאנשים יכולים לקרוא.
primaryType הסוג העיקרי של התוצאה שצוינה. לדוגמה, מקום יכול להיות מסווג כcafe או כairport. לכל מקום יכול להיות רק סוג ראשי אחד. רשימה מלאה של הערכים האפשריים זמינה במאמר סוגים נתמכים.
primaryTypeDisplayName השם לתצוגה של הסוג הראשי, מותאם לשפה של הבקשה אם רלוונטי. רשימה מלאה של הערכים האפשריים זמינה במאמר סוגים נתמכים.

מאפיינים

‫Places API (חדש) כולל כמה מאפיינים חדשים:

מאפיין תיאור
outdoorSeating במקום יש מקומות ישיבה בחוץ.
liveMusic במקום מתקיימות הופעות מוזיקה חיות.
menuForChildren יש במקום תפריט ילדים.
servesCocktails במקום מגישים קוקטיילים.
servesDessert מגישים במקום קינוחים.
servesCoffee מגישים במקום קפה.
goodForChildren המקום מתאים לילדים.
allowsDogs מותר להכניס כלבים למקום.
restroom במקום יש שירותים.
goodForGroups המקום מתאים לקבוצות.
goodForWatchingSports המקום מתאים לצפייה בספורט.

אפשרויות נגישות

‫Places API (חדש) כולל את השדות הבאים של אפשרויות נגישות:

שדה תיאור
wheelchairAccessibleParking במקום יש חנייה נגישה לכיסאות גלגלים.
wheelchairAccessibleEntrance למקום יש כניסה נגישה לכיסאות גלגלים.
wheelchairAccessibleRestroom במקום יש שירותים נגישים לכיסאות גלגלים.
wheelchairAccessibleSeating יש במקום מקומות ישיבה נגישים לכיסאות גלגלים.

סיכומים מבוססי-AI

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

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

תכונות מבוססות-AI נוספו ל-Places API (חדש)

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

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

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

מעבר לממשקי ה-Places API החדשים

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