למה כדאי להשתמש ב-Places API (חדש)
אתם יכולים ליצור תכונות מבוססות-מיקום כדי לספק למשתמשים נתוני מיקום מפורטים. הנתונים שזמינים דרך Places API (חדש) מבוססים על אחד מהמודלים המקיפים, המדויקים והעדכניים ביותר של מקומות בעולם האמיתי. ריכזנו כאן כמה תרחישים לדוגמה לאפליקציות:
- הצגת דירות אירוח באזורים מטרופולינים גדולים, עם תוצאות שמטורגטות במיוחד לערים.
- כדאי לכלול את פרטי המקום בעדכון לגבי סטטוס האיסוף או המשלוח.
- הצגת רשימה של פארקים באזור, יחד עם תמונות וביקורות שנשלחו על ידי משתמשים.
- לספק לאנשים שמתכננים נסיעות פרטים ליצירת קשר, ביקורות ורמות מחירים של מוסדות לאורך הדרך.
מה אפשר לעשות עם Places API (חדש)
אתם יכולים להשתמש ב-Places API (חדש) כדי לכלול באפליקציות שלכם את התכונות הבאות:
- הצגת תוצאות חיפוש של מקומות מסוגים שונים של שאילתות משתמשים, כמו קלט טקסט, מיקומים בקרבת מקום ושאילתות משתמשים לא ברורות או קטגוריות.
- מפעילים את התכונות של ההשלמה האוטומטית לסוגים שונים של חיפוש, בין שבשאילתות טקסט ספציפיות ובין שבשאילתות לפי קטגוריה.
- לצמצם את סוגי הפרטים שמוחזרים לגבי מקום מסוים, כמו שעות פעילות, סיכום, ביקורות של משתמשים ותמונה.
- מומלץ להוסיף תמונות באיכות גבוהה למיקומים שמוצגים באפליקציה.
הרבה ממשקי API של הפלטפורמה של מפות Google תומכים במזהי מקומות, שבהם מזהה המקום הוא מזהה ייחודי של מקום במסד הנתונים של מקומות Google ובמפות Google. יש הרבה דרכים לקבל מזהה מקום, כולל מ-Places API (חדש), אבל גם מ-Geocoding API, מ-Routes API ומ-Address Validation API.
אחרי שתקבלו מזהה מקום, תוכלו להשתמש ב-Places API (הגרסה החדשה) כדי לבקש פרטים נוספים על מקום מסוים או על אתר תיירות מסוים, כמו הכתובת המלאה, מספר הטלפון, הדירוג של המשתמשים והביקורות.
איך פועל Places API (חדש)
Places API (חדש) מקבל בקשות ככתובת URL רגילה עם נקודת קצה ספציפית של שירות, כמו /places או places:searchText, ומחזיר תשובה בפורמט JSON.
Places API (חדש) תומך בהרשאה באמצעות מפתח API ואסימון OAuth.
בדוגמה הבאה נשלחת בקשה מסוג Place Details (New) כדי להציג את רכיבי הכתובת של מזהה מקום באמצעות מפתח API:
https://places.googleapis.com/v1/places/GyuEmsRBfy61i59si0?fields=addressComponents &key=YOUR_API_KEY
איך משתמשים ב-Places API (חדש)
השלבים הבאים מתארים תרחיש לדוגמה לשימוש בשירות Places API. כשתבנו את הפתרון, תוכלו להשתמש בנקודות קצה נוספות, כמו חיפוש בקרבת מקום (חדש) ו'תמונות של מקומות' (חדש).| 1 | הגדרה | מתחילים בהגדרת הפרויקט ב-Google Cloud ומבצעים את הוראות ההגדרה הבאות. לאחר מכן, אפשר לקרוא איך משתמשים במפתח ה-API. |
| 2 | ביצוע חיפוש טקסט בסיסי | מריצים חיפוש טקסט באמצעות חיפוש טקסט (חדש). |
| 3 | שימוש במזהה המקום כדי לקבל פרטים נוספים | הרבה ממשקי API בפלטפורמה של מפות Google מחזירים מזהה מקום כחלק מתשובה. משתמשים במזהי מקומות כדי לקבל פרטי מקום (חדש). |
| 4 | איך מקבלים תמונה של מקום | התכונה 'תמונות של מקומות' (חדשה) מאפשרת לכם לגשת למיליוני התמונות שמאוחסנות במסד הנתונים של Places. אתם יכולים להשתמש בתמונות של מקום (חדש) כדי לגשת לתמונות של מקום מסוים. |