סקירה כללית

בחירת פלטפורמה: Android iOS JavaScript Web Service
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 (חדש) מקבל בקשות ככתובת 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 הקיים וכוללות שאילתה בטקסט, צריך להשתמש ב-חיפוש טקסט (חדש) כי חיפוש בקרבת מקום (חדש) לא תומך בקלט טקסט.
חיפוש טקסט חיפוש טקסט (חדש)
פרטי המקום פרטי המקום (חדש)
Place Photo Place Photo (חדש)
השלמה אוטומטית למקומות השלמה אוטומטית (חדש)
השלמה אוטומטית של שאילתות השלמה אוטומטית (חדש) יכולות נוספות להשלמה אוטומטית (חדש)

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

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