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