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