מידע על ממשקי ה-API החדשים של מקומות Google

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

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

ממשק API של פרטי מקום

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

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

API של Place Photo

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

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

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

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

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

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

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

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

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

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

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

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

API להשלמה אוטומטית ואסימוני סשן

Automatic (New) API הוא שירות אינטרנט שמחזיר חיזויים של מקומות וחיזויים של שאילתות בתגובה לבקשת HTTP. בבקשה מציינים מחרוזת חיפוש טקסט וגבולות גיאוגרפיים ששולטים באזור החיפוש.

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

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

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

שדות

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

שדה תיאור
regularSecondaryOpeningHours מתאר שעות מסוימות לפעולות מסוימות. שעות פתיחה משניות שונות משעות הפתיחה הראשיות של העסק. לדוגמה, מסעדה יכולה להגדיר את שעות הנסיעה או את שעות האספקה כשעות המשניות.
paymentOptions אפשרויות התשלום שמקבלים במקום. מקום יכול לקבל יותר מאפשרות תשלום אחת. אם הנתונים של אפשרות התשלום לא זמינים, ההגדרה של שדה אפשרות התשלום לא תהיה זמינה. האפשרויות כוללות:
  • כרטיס אשראי
  • כרטיס חיוב מיידי
  • מזומן בלבד
  • תשלום דרך NFC
parkingOptions אפשרויות החניה שהמקום מציע. האפשרויות כוללות:
  • חניונים בחינם
  • חניונים בתשלום
  • חניה ברחוב בחינם
  • שירותי החניה של רכבים
  • חניון בחינם
  • חניון בתשלום
subDestinations מקומות ייחודיים שקשורים למקום מסוים. לדוגמה, טרמינלים בנמלי תעופה נחשבים כיעדי משנה של נמל תעופה.
fuelOptions המידע העדכני ביותר על אפשרויות הדלק הזמינות בתחנת דלק. המידע הזה מתעדכן באופן קבוע. האפשרויות כוללות:
  • סולר
  • רגילים ללא לידים
  • ביניים
  • Premium
  • 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 במקום יש מקומות ישיבה נגישים לכיסאות גלגלים.

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

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