إظهار إسناد حقوق الطبع والنشر الصحيح

عند استخدام خدمة خرائط Azure Render، إما كخريطة أساسية أو طبقة، يطلب منك عرض إسناد حقوق النشر لموفر البيانات المناسب على الخريطة. يجب عرض هذه المعلومات في الزاوية السفلية اليمنى من الخريطة.

The above image is an example of a map from the Render service showing the copyright attribution when using the road style

الصورة أعلاه هي مثال على خريطة من خدمة Render تعرض نمط الطريق. وهي تُظهِر إسناد حقوق الطبع والنشر في الزاوية السفلية اليمنى من الخريطة.

The above image is an example of a map from the Render service showing the copyright attribution when using the satellite style

الصورة أعلاه هي مثال على خريطة من خدمة Render تعرض نمط القمر الصناعي. لاحظ أن هناك موفر بيانات آخر مدرجاً.

واجهة برمجة تطبيقات Get Map Attribution

تمكنك واجهة برمجة تطبيقات Get Map Attribution من طلب معلومات تعيين إسناد حقوق الطبع والنشر بحيث يمكنك عرضها على الخريطة داخل تطبيقاتك.

متى يتم استخدام واجهة برمجة تطبيقات Get Map Attribution

يجب عرض معلومات إسناد حقوق النشر للخريطة على الخريطة في أي تطبيقات تستخدم واجهة برمجة تطبيقات Render، بما في ذلك تطبيقات الويب والهاتف المحمول.

يتم عرض الإسناد وتحديثه تلقائيا على الخريطة عند استخدام أي من خرائط Azure SDKs، بما في ذلك Web وAndroidوiOSSDKs.

عند استخدام تجانبات الخريطة من خدمة Render في خريطة تابعة لجهة خارجية، يجب عرض وتحديث معلومات إسناد حقوق الطبع والنشر على الخريطة.

يتغير محتوى الخريطة كلما حدد المستخدم نمطاً مختلفاً أو قام بالتكبير أو التصغير أو تحريك الخريطة. يؤدي كل إجراء من إجراءات المستخدم هذه إلى إطلاق حدث. عند إطلاق أيٍّ من هذه الأحداث، تحتاج إلى استدعاء واجهة برمجة تطبيقات Get Map Attribution. بمجرد حصولك على معلومات إسناد حقوق الطبع والنشر المحدثة، تحتاج بعد ذلك إلى عرضها في الزاوية السفلية اليمنى من الخريطة.

نظراً لأن موفري البيانات يمكن أن يختلفوا اعتماداً على المنطقة ومستوى التكبير/التصغير، فإن واجهة برمجة تطبيقات Get Map Attribution تأخذ هذه المعلمات كإدخال وتعرض نص الإسناد المقابل.

كيفية استخدام واجهة برمجة تطبيقات Get Map Attribution

تحتاج إلى المعلومات التالية لتشغيل attribution الأمر:

المعلمة النوع ‏‏الوصف
نسخة واجهة برمجة التطبيقات سلسلة رقم إصدار واجهة برمجة تطبيقات Azure Maps.
الحدود صفيف سلسلة تمثل المنطقة المستطيلة لمربع إحاطة. يتم تعريف معلمة الحدود بواسطة إحداثيات مربع الإحاطة الأربعة. أول 2 هما خط الطول وخط العرض WGS84 اللذان يحددان الزاوية الجنوبية الغربية والزاوية الثانية وآخر 2 هما خط الطول وخط العرض WGS84 اللذان يحددان الزاوية الشمالية الشرقية. يتم عرض السلسلة بالتنسيق التالي: [SouthwestCorner_Longitude, SouthwestCorner_Latitude, NortheastCorner_Longitude, NortheastCorner_Latitude].
tilesetId TilesetID مجموعة الإطارات المتجانبة هي مجموعة من بيانات النقط أو المتجهات مقسمة إلى شبكة موحدة من الإطارات المربعة عند مستويات التكبير/التصغير المعينة مسبقاً. تحتوي كل مجموعة تجانب على tilesetId لاستخدامها عند تقديم الطلبات. يتم إنشاء tilesetId لمجموعات الإطارات المتجانبة التي تم إنشاؤها باستخدام Azure Maps Creator من خلال Tileset Create API. ثمة مجموعات تجانب جاهزة للاستخدام توفرها خرائط Azure، مثل microsoft.base.road، microsoft.base.hybrid ويمكن microsoft.weather.radar.mainالعثور على قائمة كاملة وثائق Get Map Attribution REST API.
تكبير/تصغير integer مستوى التكبير/التصغير للتجانب المحدد. يعتمد النطاق الصالح على الإطار المتجانب، راجع جدول TilesetID للحصول على قيم صالحة لمجموعة تجانب معينة. لمزيدٍ من المعلومات، راجع مقالة مستويات التكبير/التصغير وشبكة التجانب.
subscription-key سلسلة أحد مفاتيح خرائط Azure المقدمة من حساب Azure Map. لمزيدٍ من المعلومات، راجع مقالة المصادقة مع خرائط Azure.

قم بتشغيل طلب GET التالي للحصول على إسناد حقوق الطبع والنشر المقابل لعرضه على الخريطة:

https://atlas.microsoft.com/map/attribution?subscription-key={Your-Azure-Maps-Subscription-key}&api-version=2.1&tilesetId=microsoft.base&zoom=6&bounds=-122.414162,47.579490,-122.247157,47.668372

معلومات اضافيه