ה-Places API החדש כולל את ממשקי ה-API הבאים:
במסמך הזה יש סקירה כללית של ממשקי ה-API החדשים.
ממשק API של פרטי מקום
מזהה מקום משמש לזיהוי ייחודי של מקום במסד הנתונים של מקומות Google ובמפות Google. בעזרת מזהה מקום, תוכלו לבקש פרטים על מוסד או נקודת עניין מסוימים על ידי שליחת בקשה לפרטי מקום (חדש). בקשה של פרטי מקום (חדש) מחזירה מידע מקיף על המקום שצוין, כגון כתובת מלאה, מספר טלפון, דירוג משתמשים וביקורות.
יש הרבה דרכים לקבל מזהה מקום. אתם יכולים להשתמש:
- חיפוש טקסט (חדש)
- חיפוש בקרבת מקום (חדש)
- Geocoding API
- Routes API
- Address Validation API
- השלמה אוטומטית של מקומות
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 |
אפשרויות התשלום שמקבלים במקום. מקום יכול לקבל יותר
מאפשרות תשלום אחת. אם הנתונים של אפשרות התשלום לא זמינים, ההגדרה של שדה אפשרות התשלום לא תהיה זמינה. האפשרויות כוללות:
|
parkingOptions |
אפשרויות החניה שהמקום מציע. האפשרויות כוללות:
|
subDestinations |
מקומות ייחודיים שקשורים למקום מסוים. לדוגמה, טרמינלים בנמלי תעופה נחשבים כיעדי משנה של נמל תעופה. |
fuelOptions |
המידע העדכני ביותר על אפשרויות הדלק הזמינות
בתחנת דלק. המידע הזה מתעדכן באופן קבוע. האפשרויות כוללות:
|
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 החדשים, תוכלו להיעזר במסמכי התיעוד הבאים בנושא ההעברה: