מבוא
Places API הוא שירות שמקבל בקשות HTTP לנתוני מיקום באמצעות מגוון שיטות. היא מחזירה נתוני מיקום ותמונות מפורמטים על עסקים, מיקומים גיאוגרפיים או נקודות עניין בולטות.למה כדאי להשתמש ב-Places API (חדש)
ליצור תכונות שמודעות למיקום כדי להפוך נתוני מיקום מפורטים לזמינים למשתמשים. הנתונים שזמינים דרך Places API (חדש) מבוססים על אחד ממודלי המקומות המדויקים, העדכניים והמקיפים ביותר של העולם האמיתי. הנה כמה תרחישי שימוש לדוגמה באפליקציות:
- הצגת דירות להשכרה באזורים מטרופוליניים מרכזיים עם תוצאות שמטורגטות ספציפית לערים.
- לכלול פרטים על המקום בעדכון סטטוס של איסוף או משלוח.
- להציג רשימה של פארקים באזור מסוים, יחד עם תמונות וביקורות שנשלחו על ידי משתמשים.
- לספק לאנשים שמתכננים נסיעות פרטים ליצירת קשר, ביקורות ורמות מחירים של מקומות לינה לאורך הדרך.
מה אפשר לעשות עם Places API (חדש)
אתם יכולים להשתמש ב-Places API (חדש) כדי לכלול את התכונות הבאות באפליקציות שלכם:
- הצגת תוצאות חיפוש של מקומות מתוך שאילתות שונות של משתמשים, כמו קלט טקסט, מיקומים בקרבת מקום ושאילתות לא חד-משמעיות או קטגוריות של משתמשים.
- הפעלת תכונות של השלמה אוטומטית לסוגים שונים של חיפושים, כמו שאילתות טקסט ספציפיות או שאילתות קטגוריות.
- לשנות את סוג הפרטים שמוחזרים על מקום מסוים, כמו שעות הפעילות, סיכום, ביקורות של משתמשים ותמונה.
- הוסיפו תמונות באיכות גבוהה למיקומים שמוצגים באפליקציה שלכם.
ממשקי API רבים של Google Maps Platform תומכים במזהי מקומות, שבאמצעותם אפשר לזהות באופן ייחודי מקום במסד הנתונים של מקומות 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. במהלך פיתוח הפתרון, אפשר להשתמש בנקודות קצה נוספות, כמו חיפוש בקרבת מקום (חדש) ו-Place Photos (חדש).| 1 | הגדרה | מגדירים חיוב, מפעילים את Places API (חדש) ושולחים את הבקשה הראשונה. |
| 2 | איך מחפשים טקסט בסיסי | מבצעים חיפוש טקסט באמצעות חיפוש טקסט (חדש). |
| 3 | שימוש במזהה המקום לקבלת פרטים נוספים | ממשקי API רבים בפלטפורמה של מפות Google מחזירים מזהה מקום כחלק מהתשובה. אפשר להשתמש במזהי מקומות כדי לקבל פרטי מקום (חדש). |
| 4 | איך מקבלים תמונה של מקום | Place Photos (חדש) מאפשר לכם לגשת למיליוני תמונות שמאוחסנות במסד הנתונים של המקומות. אפשר להשתמש בתמונות של מקום (חדש) כדי לגשת לתמונות של מקום. |