מבוא
באמצעות Places SDK ל-Android תוכלו ליצור אפליקציות שמתבססות על המיקום של המשתמש ומגיבות בהתאם לעסקים המקומיים ולמקומות אחרים שנמצאים בסביבת המכשיר. המשמעות היא שתוכלו ליצור אפליקציות עשירות שמבוססות על מקומות שיש להם משמעות למשתמשים, כדי להשלים את השירותים הפשוטים שמבוססים על מיקום גיאוגרפי שמוצעים על ידי שירותי המיקום של Android.
מושגים
הממשקים הבאים מספקים את נקודות הכניסה הראשיות ל-Places SDK ל-Android:
Places
מספק גישה פרוגרמטית למסד הנתונים של Google עם פרטי מקומות ועסקים מקומיים, וגם למיקום הנוכחי של המכשיר.Autocomplete
מספק ווידג'טים מוכנים מראש להצגת תחזיות למקומות בתגובה לשאילתות חיפוש של משתמשים.
מקום מוגדר כמרחב פיזי שיש לו שם. אפשר גם להגדיר מקום ככל דבר שאפשר למצוא במפה.
דוגמאות לכך הן עסקים מקומיים, נקודות עניין ומיקומים גיאוגרפיים. ב-API, מקום מיוצג על ידי הממשק Place
. הוא כולל מידע כמו שם המקום והכתובת שלו, המיקום הגיאוגרפי, מזהה המקום, מספר הטלפון, סוג המקום, כתובת ה-URL של האתר ועוד.
סקירה כללית על ממשקי API
אתם יכולים לעזור ללקוחות להבין איפה הם נמצאים ומה יש בסביבה שלהם:
- השלמה אוטומטית של מקומות ממלאת באופן אוטומטי את השם ו/או הכתובת של מקום מסוים כשהמשתמשים מקלידים.
- פרטי המקום מאפשרים לקבל מידע מפורט יותר על מקום מסוים.
- חיפוש בקרבת מקום מחזיר רשימה של מקומות על סמך מיקום ורדיוס חיפוש.
- תמונות של מקומות מאפשרת להציג תמונות באיכות גבוהה של מקום מסוים.
- חיפוש טקסט מחזיר מקומות על סמך מחרוזת טקסט לחיפוש.
- מזהי מקומות שומרים את המזהה הייחודי של מקום אחד או יותר, כדי לאחזר את פרטי המקום על פי דרישה.
מדיניות ותנאים
כל האפליקציות שמשתמשות ב-Places SDK ל-Android חייבות לעמוד בדרישות שמפורטות בתנאי השימוש של הפלטפורמה של מפות Google, בקטע שימוש וחיוב ובקטע הצגת שיוך (Attribution).