סקירה כללית

בחירת פלטפורמה: Android iOS JavaScript שירות אינטרנט
Places API הוא שירות שמקבל בקשות HTTP לנתוני מיקום במגוון שיטות. הוא מחזיר נתוני מיקום מעוצבים ותמונות של מוסדות, מיקומים גיאוגרפיים או נקודות עניין בולטות.

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

איך משתמשים ב-Places API

השלבים הבאים מתארים תרחיש שימוש אופייני לשימוש בשירות Places API. בזמן פיתוח הפתרון תוכלו להשתמש בנקודות קצה נוספות, כמו 'חיפוש בקרבת מקום' ו'תמונות של מקום'.
1 שנתחיל? קודם כול צריך להגדיר את הפרויקט ב-Google Cloud, מבצעים את ההוראות להגדרה ואז לקרוא איך משתמשים במפתח ה-API. ב-Places API (חדש), אפשר גם להשתמש באסימוני OAuth.
2 ביצוע חיפוש טקסט בסיסי אפשר לבצע חיפוש טקסט פשוט באמצעות Text Search (חדש) או Text Search.
3 לפרטים נוספים הרבה ממשקי API של הפלטפורמה של מפות Google מחזירים מזהה מקום כחלק מתשובה. אפשר להשתמש במזהה המקום כדי לקבל פרטים על מקום. מידע נוסף זמין בקטעים פרטי מקום (חדש) ופרטי מקום.
4 איך מצלמים תמונה של מקום השירות 'תמונה של מקום' מאפשר גישה למיליוני התמונות שמאוחסנים במסד הנתונים של 'מקומות'. אפשר להשתמש באפשרויות תמונה של מקום (חדש) או פרטי מקום כדי לגשת לתמונות של מקום.