تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
مقدمة
باستخدام حزمة "خرائط Google" لنظام Flutter، يمكنك إضافة خرائط تستند إلى بيانات "خرائط Google" إلى تطبيقك على iOS أو Android. تتعامل حزمة تطوير البرامج (SDK) تلقائيًا مع إمكانية الوصول إلى خوادم "خرائط Google" وعرض الخريطة والاستجابة لإيماءات المستخدمين، مثل النقرات وعمليات السحب. يمكنك أيضًا إضافة علامات ومضلّعات وتركيبات أرضية ونوافذ معلومات إلى خريطتك. توفّر هذه العناصر معلومات إضافية عن المواقع الجغرافية على الخريطة، وتسمح للمستخدم بالتفاعل مع الخريطة.
تستخدم مكوّنات Flutter الإضافية قنوات Dart لاستدعاء واجهات برمجة التطبيقات الخاصة بالمنصات. يتفاعل مطوّرو Flutter مع حزمة واحدة موجّهة للتطبيقات. تتعرّف هذه الحزمة على النظام الأساسي الذي يتم تشغيل التطبيق عليه، وتدمج طلبات البيانات من واجهة برمجة التطبيقات مع الرمز البرمجي الأصلي المناسب.
الجمهور
هذه المستندات مخصّصة للمستخدمين الذين لديهم معرفة بمفاهيم تطوير Flutter. يجب أيضًا أن تكون على دراية بـ خرائط Google من وجهة نظر المستخدم. باستخدام هذا الدليل، يمكنك البدء في استكشاف التطبيقات وتطويرها باستخدام حزمة
Google Maps for Flutter. للاطّلاع على تفاصيل محدّدة حول الفئات والطُرق، راجِع مستندات المرجع.
متطلبات السمات
إذا كنت تستخدم حزمة Google Maps for Flutter في تطبيقك، عليك تضمين نص تحديد المصدر كجزء من قسم الإشعارات القانونية في تطبيقك. تنصح Google بتضمين الإشعارات القانونية كعنصر قائمة مستقل أو كجزء من عنصر القائمة "حول".
للحصول على نص تحديد المصدر، يمكنك طلب نقطة النهاية showLicensePage.
المنصّات المعتمدة
باستخدام حزمة "خرائط Google" المتوافقة مع Flutter، يمكنك إنشاء تطبيقات تستهدف أنظمة التشغيل iOS وAndroid والويب.
تاريخ التعديل الأخير: 2025-08-29 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-08-29 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eThe Google Maps for Flutter package enables developers to integrate Google Maps into their iOS, Android, and web applications, offering features like markers, polylines, and interactive elements.\u003c/p\u003e\n"],["\u003cp\u003eBefore utilizing the package, ensure you have a project with a billing account and the necessary SDKs and API keys enabled, along with designated Project Owners and Billing Administrators.\u003c/p\u003e\n"],["\u003cp\u003eDevelopers using the package should be familiar with Flutter development and Google Maps from a user perspective, adhering to the Google Maps Platform Terms of Service and applicable laws.\u003c/p\u003e\n"],["\u003cp\u003eApplications incorporating the Google Maps for Flutter package must include attribution text in a legal notices section, accessible through a dedicated menu item or an "About" section.\u003c/p\u003e\n"],["\u003cp\u003eThe package supports iOS, Android, and web platforms; for Maps URLs functionality, the target device requires the installation of the relevant Google Maps app.\u003c/p\u003e\n"]]],[],null,["# Before you begin\n\n| Before using the Google Maps for Flutter package, you need a project with a billing account and the Maps SDK for Android, Maps SDK for iOS, and Maps JavaScript API enabled, depending on the platform(s) you are targeting. You also need an API key. Google recommends creating multiple Project Owners and Billing Administrators, so that you'll always have someone with these roles available to your team. For instructions, see [Getting started with Google Maps Platform](/maps/get-started) and [Grant roles in the Google Cloud console](https://cloud.google.com/iam/docs/grant-role-console).\n\nIntroduction\n------------\n\nWith the Google Maps for Flutter package, you can add maps based on Google maps\ndata to your iOS or Android application. The SDK automatically handles access to\nthe Google Maps servers, map display, and response to user gestures such as\nclicks and drags. You can also add markers, polylines, ground overlays, and info\nwindows to your map. These objects provide additional information for map\nlocations, and allow user interaction with the map.\n\nWhen using the SDK you need to comply with the [Google Maps Platform Terms of\nService](https://cloud.google.com/maps-platform/terms) and ensure that your app\ncomplies with applicable laws.\n\nFlutter plugins use Dart channels to call platform-specific APIs. Flutter\ndevelopers interact with a single, app-facing package. This package recognizes\nthe platform that the app is running on and federates the API calls to the\nappropriate native code\n\nAudience\n--------\n\nThis documentation is designed for people familiar with [Flutter\ndevelopment](https://flutter.dev/?utm_source=devsite&utm_medium=maps_docs&utm_campaign=maps_docs) concepts. You should also be\nfamiliar with [Google Maps](https://maps.google.com/) from a user's point of\nview. With this guide, you can start exploring and developing applications with\nthe Google Maps for Flutter package. To learn about specific details of classes and\nmethods, check out the [reference\ndocumentation](https://api.flutter.dev/index.html?utm_source=devsite&utm_medium=maps_docs&utm_campaign=maps_docs).\n\nAttribution requirements\n------------------------\n\nIf you use the Google Maps for Flutter package in your application, you must\ninclude the attribution text as part of a legal notices section in your\napplication. Google recommend including legal notices as an independent menu\nitem, or as part of an \"About\" menu item.\n\nTo get the attribution text, call the [`showLicensePage`](https://api.flutter.dev/flutter/material/showLicensePage.html?utm_source=devsite&utm_medium=maps_docs&utm_campaign=maps_docs)\nendpoint.\n\nSupported platforms\n-------------------\n\nWith the Google Maps for Flutter package, you can build apps that target iOS,\nAndroid and the Web.\n\nRefer to the Flutter documentation for the development environments requirements\nand current versions of [target\nplatforms](https://docs.flutter.dev/reference/supported-platforms%0A?utm_source=devsite&utm_medium=maps_docs&utm_campaign=maps_docs).\n\nTo use [Maps\nURLs](https://developers.google.com/maps/documentation/ios-sdk/urlscheme), your\ntarget device needs the appropriate Google Maps app installed. For mobile\ndevices, this includes [Google Maps for\niOS](https://itunes.apple.com/app/id585027354) or\n[Google Maps for Android](https://play.google.com/store/apps/details?id=com.google.android.apps.maps&hl=en_US&gl=US&pli=1)."]]
