למה כדאי להשתמש ב-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 | איך מקבלים תמונה של מקום | שירות 'תמונה של מקום' (חדש) מעניק לכם גישה למיליוני התמונות שמאוחסנות במסד הנתונים של 'מקומות'. משתמשים באפשרות תמונה של מקום (חדש) כדי לגשת לתמונות של מקום מסוים. |