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