قبلاز شروع این رویهها، مطمئن شوید که سرویسهای مناسب و Consumer SDK را همانطور که در بخشهای قبلی توضیح داده شده است فعال کردهاید.
برای مقداردهی اولیه Consumer SDK، این مراحل را دنبال کنید:
دریافت نمونه ConsumerApi
برای استفاده از Consumer SDK، برنامهتان باید سینگلتون ConsumerApi را بهصورت ناهمگام مقداردهی اولیه کند. روش مقداردهی اولیه کلاس
AuthTokenFactory را میگیرد تا درصورت لزوم، نشانهای JWT جدیدی برای کاربر تولید کند.
providerId همان شناسه پروژه Google Cloud Project شما است. برای اطلاعات بیشتر درباره ایجاد پروژه Fleet Engine، به ایجاد پروژه Fleet Engine در راهنمای Fleet Engine مراجعه کنید.
برنامه شما باید AuthTokenFactory را همانطور که در اصالتسنجی کیت توسعه نرمافزار مصرفکننده شرح داده شده است پیادهسازی کند.
جاوا
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
}
کیت توسعه نرمافزار Maps و پردازنده گرافیکی نقشهها
«کیت توسعه نرمافزار مصرفکننده» نسخه ۲.۰.۰ و جدیدتر از «کیت توسعه نرمافزار Maps ویژه Android» نسخه ۱۸.۱.۰ و جدیدتر پشتیبانی میکند. جدول زیر خلاصهای از موتور پرداز پیشفرض براساس نسخه Maps SDK
و پشتیبانیپذیری هر دو موتور پرداز را نشان میدهد. درصورت امکان، از جدیدترین پردازنده گرافیکی استفاده کنید.
اگر باید از پردازنده قدیمی استفاده کنید، آن را بهطور صریح بااستفاده از
MapsInitializer.initialize() مشخص کنید.
| نسخه کیت توسعه نرمافزار Maps | از جدیدترین پردازنده پشتیبانی میکند | از پردازنده قدیمی پشتیبانی میکند | پردازنده پیشفرض |
|---|---|---|---|
| نسخه ۱۸.۱.۰ و پایینتر | بله | بله | قدیمی* |
| V18.2.0 | بله | بله | جدیدترین |
* با عرضه پردازنده جدید Maps، پردازنده «جدیدترین» پیشفرض خواهد بود.
اگر باید از پردازنده ترجیحی استفاده کنید، همه عملیات پردازش واسط کاربر را
پساز اینکه OnMapsSdkInitializedCallback نتیجهای را برگرداند اجرا کنید. عملیات پردازش رابط کاربری شامل عملیات زیر میشود:
بزرگ کردن نمایی که حاوی
GoogleMapViewیاConsumerMapViewاست.درحال قرار دادن نشانگرها روی
ConsumerMapView.
اگر این عملیات را پساز دریافت نتیجه
OnMapsSdkInitializedCallback اجرا نکنید، Maps SDK پردازنده ترجیحی شما را اختصاص نمیدهد و نمای نقشه بهجای آن توسط پردازنده پیشفرض پردازش میشود.
پیشاز مقداردهی اولیه «کیت توسعه نرمافزار مصرفکننده»، «کیت توسعه نرمافزار Maps» را مقداردهی اولیه کنید
در کلاس
Applicationیا راهاندازیActivity، MapsInitializer.initialize() را فراخوانی کنیدپیشاز مقداردهی اولیه «کیت توسعه نرمافزار مصرفکننده»، منتظر نتیجه درخواست پردازنده بمانید.
برای جزئیات، مثالهای زیر را ببینید.
جاوا
@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
در داخل، پیادهسازی Consumer SDK از SSL/TLS برای برقراری ارتباط ایمن استفاده میکند
با سرویس Fleet Engine. نسخههای ۲۳ یا قدیمیتر میانای برنامهسازی کاربردی Android ممکن است برای برقراری ارتباط با سرور به وصله SecurityProvider نیاز داشته باشند. برای اطلاعات بیشتر درباره کار با SSL در Android، به ارائهدهنده GMS امنیتی مراجعه کنید.
این مقاله همچنین حاوی نمونه کدهایی برای وصله کردن ارائهدهنده امنیتی است.