أفضل الممارسات المتعلّقة بالتفاعل مع "خرائط Google"
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
توضّح هذه الصفحة أفضل الممارسات للتفاعل مع العنصر GoogleMap في تطبيقك.
تنفيذ ميزات GoogleMap على مثيل الخرائط نفسه
تتوفّر واجهات Maps API أيضًا كجزء من حزمة Navigation SDK، ويمكنك استخدامها لإنشاء تجارب خاصة بالخرائط (غير متعلّقة بالتنقّل). إذا كان تطبيقك يتضمّن تجربة خريطة غير مخصّصة للتنقّل وتجربة تنقّل، ننصحك باستخدام واجهة برمجة التطبيقات Maps and Navigation API على مثيل الخريطة نفسه.
استخدِم getMapAsync للحصول على مثيل GoogleMap
يمكنك الحصول على عنصر GoogleMap باستخدام SupportNavigationFragment#getMapAsync أو NavigationView#getMapAsync. ننصحك باستخدام هذه الطريقة بدلاً من الاحتفاظ بنسخة GoogleMap التي قد تصبح قديمة بعد إعادة إنشاء NavigationView الأساسي.
يجب أيضًا الحرص على تنظيف GoogleMap الذي تم استرداده من خلال هذه الطريقة بعد عدم الحاجة إليه. لمزيد من المعلومات، يُرجى الاطّلاع على أفضل الممارسات لتنظيف المثيلات.
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-08-31 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-08-31 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eImplement \u003ccode\u003eGoogleMap\u003c/code\u003e features on a separate map instance from navigation experiences to avoid conflicts and optimize performance.\u003c/p\u003e\n"],["\u003cp\u003eUse \u003ccode\u003egetMapAsync\u003c/code\u003e to retrieve the \u003ccode\u003eGoogleMap\u003c/code\u003e object instead of holding onto an instance, ensuring you have the most up-to-date map object and preventing stale data.\u003c/p\u003e\n"],["\u003cp\u003eRemember to clean up the \u003ccode\u003eGoogleMap\u003c/code\u003e object after use to prevent memory leaks and maintain optimal app performance, referring to the Instance cleanup best practices for detailed guidance.\u003c/p\u003e\n"]]],[],null,["# GoogleMap interaction best practices\n\nThis page explains best practices for interacting with the `GoogleMap` object in\nyour app.\n\nImplement `GoogleMap` features on the same maps instance\n--------------------------------------------------------\n\nMaps APIs are also available as part of Navigation SDK, which you can use to\nbuild map specific (non-navigation) experiences. If your app includes both a\nnon-navigation map experience and a navigation experience, we recommend using\nthe Maps and Navigation API on the same map instance.\n\nUse `getMapAsync` to obtain the `GoogleMap` instance\n----------------------------------------------------\n\nYou can obtain a `GoogleMap` object using either\n`SupportNavigationFragment#getMapAsync` or `NavigationView#getMapAsync`. We\nrecommend this method over holding onto the `GoogleMap` instance that might\nbecome stale once the `NavigationView` underneath is recreated.\n\nAlso be sure to clean up the `GoogleMap` retrieved from this method after it is\nno longer needed. For more information, see [Instance cleanup best\npractices](/maps/documentation/navigation/android-sdk/instance-cleanup-best-practices)."]]
