למה כדאי להשתמש ב-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 תומך בשתי גרסאות של API: Places API הם ממשקי ה-API הקיימים ו-Places API (חדש) הם הגרסאות הבאות של ה-API.
לאחר ההשקה של Places API (החדש), המשימה הראשונה שלכם היא להחליט באיזו קבוצה של ממשקי API להשתמש. זה נכון ללקוחות חדשים או ללקוחות קיימים שכבר משתמשים בממשקי ה-API. השתמשו במדריך הזה כדי ללמוד על ההבדלים העיקריים בין שני ממשקי ה-API.
איך פועל Places API
Places API (חדש)
Places API (חדש) מקבל בקשות ככתובת URL רגילה עם נקודת קצה ספציפית של שירות, כמו /places או places:searchText, ומחזיר תגובת JSON. Places API (חדש) תומך בהרשאה באמצעות מפתח API ואסימון OAuth.
בדוגמה הבאה נשלחת בקשה לפרטי מקום להחזרת רכיבי הכתובת
של מזהה מקום באמצעות מפתח API:
https://places.googleapis.com/v1/places/GyuEmsRBfy61i59si0?fields=addressComponents &key=YOUR_API_KEY
Places API
Places API מקבל בקשות ככתובת URL רגילה עם נקודת קצה ספציפית של שירות, כמו /place או /photo. נקודות הקצה מקבלות גם
את סוג הפורמט שצוין בבקשה – JSON או XML. בבקשת השירות, המערכת משתמשת בפרמטרים שרלוונטיים לנקודת הקצה הספציפית הזאת כדי לצמצם את הנתונים שמוחזרים.
בדוגמה הבאה נשלחת בקשה לפרטי מקום להחזרת רכיבי הכתובת
של מזהה מקום בפורמט JSON:
https://maps.googleapis.com/maps/api/place/details/json?place_id=ChIJrTLr-GyuEmsRBfy61i59si0 &fields=address_components &key=YOUR_API_KEY
במקרה הזה, השירות משתמש במזהה המקום שצוין כדי למצוא את המקום המבוקש ולהחזיר את רכיבי הכתובת בפורמט JSON.
משאבים
הטבלה הבאה מסכמת את המשאבים הזמינים דרך Places API.
| Places API | Places API (חדש) | הערה |
|---|---|---|
| חיפוש מקום | חיפוש טקסט (חדש) | אין גרסה חדשה של 'חיפוש מקום'. התכונה 'חיפוש טקסט (חדש)' החליפה אותה. |
| חיפוש בקרבת מקום | חיפוש בקרבת מקום (חדש) | כל הבקשות שמשתמשות ב-API הקיים שכוללות שאילתת טקסט צריכות להשתמש בחיפוש טקסט (חדש) כי חיפוש בקרבת מקום (חדש) לא תומך בקלט טקסט. |
| חיפוש טקסט | חיפוש טקסט (חדש) | |
| פרטי מקום | פרטי מקום (חדש) | |
| תמונה של מקום | תמונה של מקום (חדש) | |
| השלמה אוטומטית של מקומות | השלמה אוטומטית (חדש) | בתצוגה מקדימה |
| השלמה אוטומטית של שאילתות | השלמה אוטומטית (חדש) | יכולות נוספו לגרסת תצוגה מקדימה של השלמה אוטומטית (חדש) |
איך משתמשים ב-Places API
השלבים הבאים מתארים תרחיש אופייני של שימוש בשירות Places API. בזמן פיתוח הפתרון תוכלו להשתמש בנקודות קצה נוספות, כמו 'חיפוש בקרבת מקום' ו'תמונות של מקום'.| 1 | להגדרה | מתחילים בהגדרת הפרויקט ב-Google Cloud, מבצעים את הוראות ההגדרה שמפורטות בהמשך ולומדים איך להשתמש במפתח ה-API. ב-Places API (חדש), אפשר להשתמש גם באסימוני OAuth. |
| 2 | כדאי לנסות חיפוש טקסט בסיסי | ניתן לחפש טקסט פשוט באמצעות חיפוש טקסט (חדש) או חיפוש טקסט. |
| 3 | פרטים נוספים זמינים לפי מזהה המקום | הרבה ממשקי API של הפלטפורמה של מפות Google מחזירים מזהה מקום כחלק מתשובה. אפשר להשתמש במזהה המקום כדי לקבל פרטים על המקום. כדאי לעיין בפרטי מקום (חדש) ובפרטי המקום. |
| 4 | איך מצלמים תמונה של מקום | שירות 'תמונות של מקומות' מעניק לך גישה למיליוני תמונות שמאוחסנות במסד הנתונים של מקומות. אפשר להשתמש בתמונה של המקום (חדש) או בפרטי המקום כדי לגשת לתמונות של מקום מסוים. |