Nearby Messages API הוא API של פרסום והרשמה שמאפשר להעביר מטענים קטנים של נתונים בינאריים בין מכשירי Android ו-iOS שמחוברים לאינטרנט. המכשירים לא צריכים להיות מחוברים לאותה רשת, אבל הם כן צריכים להיות מחוברים לאינטרנט.
התכונה 'שיתוף בקרבת מקום' משתמשת ב-Bluetooth עם צריכת אנרגיה נמוכה כדי להעביר קוד התאמה ייחודי בין מכשירים. השרת מאפשר החלפת הודעות בין מכשירים שמזהים את אותו קוד שיוך. כשמכשיר מזהה קוד צימוד ממכשיר סמוך, הוא שולח את קוד הצימוד לשרת של Nearby Messages כדי לאמת אותו ולבדוק אם יש הודעות לשליחה עבור קבוצת המינויים הנוכחית של האפליקציה.
התכונה 'הודעות בקרבת מקום' לא מאומתת ולא נדרש חשבון Google כדי להשתמש בה.
המנגנון המדויק להחלפת נתונים עשוי להשתנות מגרסה לגרסה. רצף האירועים הבא מציג את האירועים שמובילים להחלפת הודעות:
אפליקציה שמפרסמת תוכן שולחת בקשה לשיוך של מטען בינארי (ההודעה) לקוד זיווג ייחודי בזמן (טוקן). השרת יוצר שיוך זמני בין מטען הייעודי (payload) של ההודעה לבין האסימון.
המכשיר שממנו מפרסמים משתמש ב-Bluetooth עם צריכת אנרגיה נמוכה כדי שהטוקן יהיה ניתן לזיהוי על ידי מכשירים קרובים. המכשיר שבו מתבצעת ההגדרה משתמש גם ב-Bluetooth עם צריכת אנרגיה נמוכה כדי לסרוק אסימונים ממכשירים אחרים.
אפליקציה עם מינוי משייכת את המינוי שלה לטוקן ומשתמשת ב-Bluetooth Low Energy כדי לשלוח את הטוקן שלה לאפליקציית המוציא לאור, וכדי לזהות את הטוקן של אפליקציית המוציא לאור.
כששני הצדדים מזהים את האסימון של הצד השני, הם מדווחים עליו לשרת.
השרת מאפשר החלפת הודעות בין שני מכשירים כששניהם משויכים לאותו אסימון, ומפתחות ה-API שבהם משתמשות האפליקציות שקוראות ל-API משויכים לאותו פרויקט ב-Google Developers Console.
כשמשתמשים ב-Nearby SDK של Google Play Services, נאספים נתוחי שימוש כדי לשפר את חוויית השימוש.
- מדדי ביצועים: משך הפרסומים והמינויים ומספר ההודעות שהתקבלו נאספים כשמשתמשים ב-Nearby SDK.
- מידע על המכשיר: נאספים נתונים על דגם המכשיר, המדינה, גרסת ה-Build ושם חבילת האפליקציה, והם משויכים למדדי הביצועים כדי לזהות פלחים אזוריים ופלחים ספציפיים למכשיר.
- פרסום הודעות בסביבה: נתונים שפורסמו באמצעות התכונה 'הודעות בסביבה' מאוחסנים על ידי Google עד שההודעה לא מתפרסמת יותר. הנתונים האלה משותפים עם מנויים שנמצאים בקרבת המכשיר.
משתמשי הקצה יכולים לאשר או לדחות את האיסוף הזה דרך 'הגדרות' > Google > 'דפוסי שימוש וביצועים'.