مشاركة عبر

إنشاء حساب Azure Maps باستخدام قالب ARM

  • مقالة

يمكنك إنشاء حساب Azure Maps باستخدام قالب Azure Resource Manager (ARM). بعد أن يكون لديك حساب، يمكنك تنفيذ API في موقع الويب الخاص بك أو تطبيق الهاتف المحمول.

قالب Azure Resource Manager هو ملف JavaScript Object Notation (JSON) الذي يحدد البنية الأساسية والتكوين لمشروعك. يستخدم القالب عبارات توضيحية. يمكنك وصف النشر المقصود دون كتابة تسلسل أوامر البرمجة لإنشاء النشر.

إذا كانت بيئتك تلبي المتطلبات الأساسية وكنت معتاداً على استخدام قوالب "ARM"، فحدد زر "Deploy to Azure". سيتم فتح القالب في مدخل Azure.

Button to deploy the Resource Manager template to Azure.

المتطلبات الأساسية

لإكمال هذه المقالة:

مراجعة القالب

يُعدّ النموذج المستخدم في هذا التشغيل السريع مأخوذاً من قوالب التشغيل السريع من Azure.

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "metadata": {
    "_generator": {
      "name": "bicep",
      "version": "0.25.53.49325",
      "templateHash": "695164742048978243"
    }
  },
  "parameters": {
    "accountName": {
      "type": "string",
      "defaultValue": "[uniqueString(resourceGroup().id)]",
      "metadata": {
        "description": "The name for your Azure Maps account. This value must be globally unique."
      }
    },
    "location": {
      "type": "string",
      "allowedValues": [
        "westeurope",
        "eastus",
        "westus2",
        "northeurope",
        "westcentralus",
        "usgovvirginia",
        "usgovarizona"
      ],
      "metadata": {
        "description": "Specifies the location for all the resources."
      }
    },
    "pricingTier": {
      "type": "string",
      "defaultValue": "G2",
      "allowedValues": [
        "G2"
      ],
      "metadata": {
        "description": "The pricing tier SKU for the account."
      }
    },
    "kind": {
      "type": "string",
      "defaultValue": "Gen2",
      "allowedValues": [
        "Gen2"
      ],
      "metadata": {
        "description": "The pricing tier for the account."
      }
    }
  },
  "resources": [
    {
      "type": "Microsoft.Maps/accounts",
      "apiVersion": "2023-06-01",
      "name": "[parameters('accountName')]",
      "location": "[parameters('location')]",
      "sku": {
        "name": "[parameters('pricingTier')]"
      },
      "kind": "[parameters('kind')]"
    }
  ]
}

تم تعريف مورد حساب Azure Maps في هذا القالب:

نشر القالب

  1. حدد الصورة التالية لتسجيل الدخول إلى Azure وفتح قالب. ينشئ القالب حساب Azure Maps.

    Button to deploy the Resource Manager template to Azure.

  2. حدد القيم التالية أو أدخلها.

    ARM template deploy portal

    ما لم يتم تحديده، استخدم القيمة الافتراضية لإنشاء حساب Azure Maps الخاص بك.

    • الاشتراك: «select an Azure subscription».
    • لمجموعة الموارد: حدد "Create new"، وأدخل اسماً فريداً لمجموعة الموارد، ثم حدّد "OK".
    • الموقع: حدد موقعًا.
    • اسم الحساب: أدخل اسماً لحساب Azure Maps الخاص بك، والذي يجب أن يكون فريداً عالمياً.
    • Pricing Tier: حدد مستوى التسعير المناسب، والقيمة الافتراضية للقالب هي G2.

  3. حدد "Review + create".

  4. قم بتأكيد الإعدادات في صفحة المراجعة وحدد إنشاء. بمجرد النشر بنجاح، تحصل على إعلام:

    ARM template deploy portal notification

يتم استخدام مدخل Azure لنشر القالب. يمكنك أيضاً استخدام مدخل Azure وAzure PowerShell وواجهة برمجة تطبيقات REST. لمعرفة طرق النشر الأخرى، راجع نشر القوالب.

مراجعة الموارد الموزعة

يمكنك استخدام مدخل Azure للتحقق من حساب Azure Maps وعرض المفاتيح. يمكنك أيضاً استخدام البرنامج النصي Azure CLI التالي لسرد مفاتيح حسابك.

az maps account keys list --name MyMapsAccount --resource-group MyResourceGroup

تنظيف الموارد

عندما لم تعد هناك حاجة، احذف مجموعة الموارد، والتي تحذف أيضاً حساب Azure Maps. حذف مجموعة الموارد باستخدام Azure CLI:

az group delete --name MyResourceGroup

الخطوات التالية

لمعرفة المزيد حول خرائط Azure وAzure Resource Manager، راجع المقالات التالية: