הפעלת ה-SDK לצרכנים

לפני שתתחילו בהליכים האלה, חשוב לוודא שהפעלתם את וה-SDK לצרכן, כפי שמתואר בסעיפים הקודמים.

כדי לאתחל את Consumer SDK:

  1. איך מקבלים את המכונה ConsumerAPI
  2. הפעלת ה-SDK של מפות Google כדי לבקש את המרינר המועדף

אחזור של המופע ConsumerApi

כדי להשתמש ב-Consumer SDK, צריך לאתחל את ה-singleton ConsumerApi באפליקציה באופן אסינכרוני. שיטת האתחול לוקחת את מחלקה AuthTokenFactory כדי ליצור אסימוני JWT חדשים למשתמש במקרה הצורך.

השדה providerId הוא מזהה הפרויקט של פרויקט Google Cloud. לקבלת מידע נוסף ליצירת פרויקט ב-Fleet Engine, ראו: יוצרים פרויקט ב-Fleet Engine במדריך של Fleet Engine.

צריך להטמיע את AuthTokenFactory באפליקציה כפי שמתואר בקטע אימות ב-Consumer SDK.

Java

Task<ConsumerApi> consumerApiTask = ConsumerApi.initialize(
    this, "myProviderId", authTokenFactory);

consumerApiTask.addOnSuccessListener(
  consumerApi -> this.consumerApi = consumerApi);

Kotlin

val consumerApiTask =
  ConsumerApi.initialize(this, "myProviderId", authTokenFactory)

consumerApiTask?.addOnSuccessListener { consumerApi: ConsumerApi ->
  this@YourActivity.consumerApi = consumerApi
}

SDK של מפות וכלים לעיבוד מפות Google

גרסה 2.0.0 ואילך של Consumer SDK תומכת ב-SDK של מפות ל-Android בגרסה 18.1.0 ואילך. בטבלה הבאה מופיע סיכום של כלי הרינדור שמוגדר כברירת מחדל לפי גרסת ה-SDK של מפות Google ומידת התמיכה של שני כלי הרינדור. אם אפשר, כדאי להשתמש בכלי העדכני ביותר לרינדור. אם אתם חייבים להשתמש בכלי לרינדור מדור קודם, מציינים אותו במפורש באמצעות MapsInitializer.initialize()

גרסת SDK של מפות Google תמיכה בכלי לרינדור העדכני ביותר תמיכה במעבד הגרפיקה הקודם כלי לעיבוד שמוגדר כברירת מחדל
גרסה 18.1.0 ומטה כן כן דור קודם*
V18.2.0 כן כן פורסמו לאחרונה

* לאחר השקת כלי הרינדור החדש של מפות Google, הכלי האחרון לעיבוד יהיה כברירת מחדל.

אם אתם חייבים להשתמש בכלי לרינדור מועדף, כדאי להריץ את כל פעולות הרינדור של ממשק המשתמש after OnMapsSdkInitializedCallback מחזירה תוצאה. רינדור UI הפעולות האלה כוללות את הפעולות הבאות:

  • ניפוח של תצוגה שמכילה את GoogleMapView או ConsumerMapView.

  • המערכת ממקמת סמנים בדומיין ConsumerMapView.

אם לא תבצעו את הפעולות האלה לאחר קבלת תוצאה אחת (OnMapsSdkInitializedCallback), ה-SDK של מפות Google לא מקצה את ובמקום זאת, עיבוד המפה המועדף ותצוגת המפה עוברת עיבוד כברירת מחדל.

אתחול ה-SDK של מפות Google לפני הפעלת ה-SDK לצרכן

  1. צריך להתקשר לכיתת Application או לסטארט-אפ Activity MapsInitializer.initialize()

  2. ממתינים לתוצאה של בקשת הרינדור לפני אתחול ה-SDK לצרכנים.

בדוגמאות הבאות יש פרטים נוספים.

Java

@Override
protected void onCreate(Bundle savedInstanceState) {
  super.onCreate(savedInstanceState);
  setContentView(R.layout.main);
  initViews();

  MapsInitializer.initialize(getApplicationContext(), Renderer.LATEST,
      new OnMapsSdkInitializedCallback() {
        @Override
        public void onMapsSdkInitialized(Renderer renderer) {
          switch (renderer) {
            case LATEST:
              Log.i("maps_renderer", "LATEST renderer");
              break;
            case LEGACY:
              Log.i("maps_renderer", "LEGACY renderer");
              break;
          }

          initializeConsumerSdk();
        }
      });
}

Kotlin

fun onCreate(savedInstanceState: Bundle?) {
  super.onCreate(savedInstanceState)
  setContentView(R.layout.main)
  initViews()

  MapsInitializer.initialize(
    getApplicationContext(), Renderer.LATEST,
    object : OnMapsSdkInitializedCallback() {
      fun onMapsSdkInitialized(renderer: Renderer?) {
        when (renderer) {
          LATEST -> Log.i("maps_renderer", "LATEST renderer")
          LEGACY -> Log.i("maps_renderer", "LEGACY renderer")
        }
        initializeConsumerSdk()
      }
    })
  }

הערות לגבי SSL/TLS

באופן פנימי, הטמעת SDK לצרכנים משתמשת ב-SSL או ב-TLS כדי לתקשר באופן מאובטח עם השירות Fleet Engine. יכול להיות שתצטרכו להשתמש ב-Android API בגרסה 23 ומטה תיקון SecurityProvider לתקשורת עם השרת. למידע נוסף על עבודה עם SSL ב-Android, ראו Security GMS Provider. המאמר גם מכיל דוגמאות קוד לתיקון ספק האבטחה.

המאמרים הבאים

הגדרת מפה