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

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

כדי להפעיל את Consumer SDK, צריך לבצע את השלבים הבאים:

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

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

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

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

עליך להטמיע את AuthTokenFactory באפליקציה כפי שמתואר ב-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

Consumer SDK גרסה 2.0.0 ואילך תומך ב-SDK של מפות Google ל-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, ראו אבטחה GMS ספק. המאמר גם מכיל דוגמאות קוד לתיקון ספק האבטחה.

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

הגדרת מפה