סקירה כללית

בחירת פלטפורמה: 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 (New) הם גרסאות הדור הבא של ממשקי ה-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 הקיים שכוללות שאילתת טקסט, צריך להשתמש בכלי חיפוש טקסט (חדש) מפני שחיפוש בקרבת מקום (חדש) לא תומך בקלט טקסט.
חיפוש טקסט חיפוש טקסט (חדש)
פרטי מקום פרטי מקום (חדש)
תמונה של מקום תמונה של מקום (חדש)
השלמה אוטומטית של מקומות אין גרסה של ממשק ה-API של מקומות Google (חדש)
השלמה אוטומטית של שאילתות אין גרסה של ממשק ה-API של מקומות Google (חדש)

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

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