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