למה כדאי להשתמש ב-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 רגילה עם
נקודת קצה (endpoint) של שירות, כמו /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 רגילה עם
נקודת קצה (endpoint) של שירות, כמו /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 | ביצוע חיפוש טקסט בסיסי | מבצעים חיפוש טקסט פשוט באמצעות חיפוש טקסט (חדש) או Text Search (חיפוש טקסט). |
| 3 | לפרטים נוספים | הרבה ממשקי API של הפלטפורמה של מפות Google מחזירים מזהה מקום כחלק מתשובה. משתמשים ב מזהה של מקום כדי לקבל פרטים על מקום מסוים. מידע נוסף זמין בקטעים פרטי מקום (חדש) ופרטי מקום. |
| 4 | איך מצלמים תמונה של מקום | השירות 'תמונה של מקום' נותן לך גישה למיליוני התמונות שמאוחסנים ב'מקומות'. מסד נתונים. שימוש בתמונה של מקום (חדש) או פרטי מקום כדי לגשת לתמונות של מקום מסוים. |