اپنی ایپ میں نقشے کیسے شامل کریں: Embeds، انٹرایکٹو نقشے اور اسٹور لوکیٹرز

اپنی ایپ میں نقشہ شامل کرنے کے لیے پہلے طے کریں کہ آپ کو جامد embed چاہیے (ایک مقام پر پن، جیسے “ہماری دکان تلاش کریں”) یا انٹرایکٹو نقشہ (آپ کے ڈیٹا سے بہت سے پن، فلٹرز، clustering، “میرے قریب”)۔ ایک مقام کے لیے embedded نقشہ سب سے تیز ہے اور Google کے Maps Embed API کے ساتھ مفت ہے۔ انٹرایکٹو نقشوں کے لیے JavaScript نقشہ لائبریری استعمال کریں، یعنی Google Maps JavaScript API، Mapbox GL JS، یا اوپن سورس Leaflet کے ساتھ ایک tile provider۔ ہر جگہ کا latitude اور longitude اپنے ڈیٹا بیس میں محفوظ کریں، اور اپنی API key کو اپنے ڈومین تک محدود کریں۔ ذیل کی فراہم کنندگان کی تفصیلات ستمبر 2026 تک ہر فراہم کنندہ کی اپنی دستاویزات سے لی گئی ہیں۔

آپ کو کس قسم کا نقشہ چاہیے

زیادہ تر چھوٹی کاروباری سائٹوں کو صرف پہلی قطار کی ضرورت ہوتی ہے۔ ڈائریکٹریاں، مارکیٹ پلیسز اور لسٹنگ سائٹس کو تیسری اور چوتھی قطار کی ضرورت ہوتی ہے۔

آپ کے آپشنز

Google Maps Platform

Google کی شروعاتی گائیڈ کے مطابق آپ کو ایک billing فعال Cloud پروجیکٹ بنانا ہوگا اور وہ APIs فعال کرنی ہوں گی جو آپ چاہتے ہیں۔ اس کی pay-as-you-go قیمت میں Dynamic Maps سمیت Essentials SKUs کو ماہانہ 10,000 مفت events کی حد ملتی ہے، اور اس سے اوپر Dynamic Maps کو پہلے حجم کے درجے پر فی 1,000 events $7.00 درج کیا گیا ہے۔ Maps Embed SKU لامحدود اور مفت درج ہے۔ Google ماہانہ سبسکرپشن پلانز بھی فروخت کرتا ہے۔ موجودہ اعداد کے لیے Google Maps Platform pricing دیکھیں۔

Mapbox

Mapbox کا pricing صفحہ ویب پر Mapbox GL JS کے لیے ماہانہ 50,000 مفت نقشہ loads درج کرتا ہے، اس کے بعد فی 1,000 loads $5.00۔ دیکھیں Mapbox pricing۔

Leaflet اور OpenStreetMap

Leaflet خود کو موبائل دوست انٹرایکٹو نقشوں کے لیے ایک اوپن سورس JavaScript لائبریری بتاتا ہے، جس کا حجم تقریباً 42 KB JavaScript ہے۔ اسے نقشے کے tiles (نقشے کی تصویریں) کہیں سے چاہئیں۔ OpenStreetMap کے عوامی tile servers پرکشش لگتے ہیں، مگر tile استعمال کی پالیسی نظر آنے والے attribution کا تقاضا کرتی ہے، بڑے پیمانے پر ڈاؤن لوڈ سے منع کرتی ہے، کوئی سروس کی ضمانت نہیں دیتی، اور کاروباری سروسز کو خبردار کرتی ہے کہ رسائی واپس لی جا سکتی ہے۔ حقیقی پروڈکٹ کے لیے ایسا کمرشل یا خود ہوسٹ کردہ tile ذریعہ استعمال کریں جو Leaflet کے ساتھ کام کرے۔

API کیز: عوامی، مگر محدود

براؤزر میں استعمال ہونے والی نقشہ کیز ہر اس شخص کو نظر آتی ہیں جو آپ کا صفحہ کھولے۔ یہ متوقع ہے، مگر اس کا مطلب ہے کہ کوئی آپ کی کی کاپی کر کے آپ کے بل پر استعمال چلا سکتا ہے۔ Google کی سیکیورٹی رہنمائی یہ ہے کہ ویب سائٹ (HTTP referrer) پابندیاں شامل کریں جن میں آپ کے ڈومینز ہوں، اور API پابندیاں کہ کی صرف انہی APIs کے لیے کام کرے جو آپ استعمال کرتے ہیں۔

سرور سائیڈ سروسز کی کیز، جیسے ہزاروں پتوں کی geocoding، الگ کیز ہونی چاہئیں جو سرور سیکرٹس میں رکھی جائیں، صفحے میں نہیں۔ اس کے علاوہ فراہم کنندہ کے کنسول میں بجٹ الرٹس یا کوٹا مقرر کریں تاکہ کوئی غلطی بڑا بل نہ بن جائے۔

Geocoding: پتوں کو ایک بار کوآرڈینیٹس میں بدلیں

نقشے latitude اور longitude پلاٹ کرتے ہیں، پتے نہیں۔ پتے کو کوآرڈینیٹس میں بدلنا geocoding کہلاتا ہے، اور زیادہ تر فراہم کنندگان اسے فی درخواست چارج کرتے ہیں۔ مؤثر طریقہ یہ ہے:

1. جب کوئی لسٹنگ محفوظ ہو، سرور پر اس کے پتے کی geocoding کریں۔
2. latitude اور longitude ڈیٹا بیس میں محفوظ کریں۔
3. نقشہ محفوظ شدہ کوآرڈینیٹس پڑھے؛ صفحہ دیکھنے پر کبھی geocode نہ کرے۔

ہر فراہم کنندہ کی شرائط چیک کریں کہ geocoding کے نتائج کتنی دیر محفوظ رکھ سکتے ہیں؛ یہ مختلف ہیں۔

مثالی پرامپٹس

ایک embedded نقشہ:

Contact صفحے پر Maps Embed API کے ذریعے ایک embedded Google نقشہ شامل کرو جو ہمارا پتہ (12 High Street, Leeds) دکھائے، کی GOOGLE_MAPS_EMBED_KEY میں ہو۔ اس کے نیچے ایک “ہدایات حاصل کریں” لنک رکھو۔ فون پر اسے پوری چوڑائی دو اور اسے lazy-load کرو۔

لسٹنگز کا انٹرایکٹو نقشہ:

listings ٹیبل میں latitude اور longitude شامل کرو۔ جب کوئی لسٹنگ بنے یا اس کا پتہ بدلے، تو GEOCODING_API_KEY والی کی سے سرور پر اس کی geocoding کرو اور کوآرڈینیٹس محفوظ کرو۔ Browse صفحے پر Leaflet سے ہر لسٹنگ کا مارکر دکھانے والا نقشہ بناؤ، اور مارکرز ملنے پر clustering کرو۔ مارکر پر کلک کرنے سے عنوان، قیمت اور ایک لنک دکھے۔ نقشہ اور لسٹ ایک ہی فلٹرز استعمال کریں۔

“میرے قریب”:

ایک “Near me” بٹن شامل کرو جو وزیٹر کے مقام کی اجازت مانگے اور 10 کلومیٹر کے اندر کی لسٹنگز فاصلے کے حساب سے ترتیب دے کر دکھائے۔ اگر وہ مقام تک رسائی سے انکار کرے تو اسے شہر ٹائپ کرنے دو۔

مرحلہ وار طریقہ

1. اوپر کے جدول سے نقشے کی قسم چنیں۔
2. فراہم کنندہ کا اکاؤنٹ اور ایک پروجیکٹ بنائیں، اور صرف وہی APIs فعال کریں جن کی ضرورت ہے۔
3. کیز بنائیں: ایک براؤزر کی key جو آپ کے ڈومینز تک محدود ہو (تعمیر کے دوران preview ڈومین سمیت) اور، اگر ضرورت ہو، geocoding کے لیے ایک سرور key۔
4. کیز کو سیکرٹس کے طور پر محفوظ کریں اور اپنے بلڈر سے انہیں استعمال کرنے کو کہیں؛ براؤزر کی key پھر بھی محدود رہتی ہے، حالانکہ وہ صفحے میں آ جاتی ہے۔
5. ہر جگہ کے کوآرڈینیٹس اپنے ڈیٹا بیس میں محفوظ کریں۔
6. نقشہ بنائیں: مارکرز، popups، clustering، اور مناسب ڈیفالٹ زوم۔
7. اس کے ساتھ ایک لسٹ رکھیں۔ اکیلا نقشہ فون پر اور اسکرین ریڈرز کے لیے استعمال میں مشکل ہے۔ وہی نتائج لسٹ کی شکل میں دکھائیں۔
8. فراہم کنندہ کے کنسول میں بجٹ الرٹ مقرر کریں۔
9. لائیو ڈومین پر شائع اور جانچیں، کیونکہ ریفرر پابندیاں اکثر لائیو ڈومین شامل کیے جانے تک نقشے کو روک دیتی ہیں۔

عام غلطیاں

• بغیر پابندی کی کیز۔ کوئی بھی انہیں اپنی سائٹ پر دوبارہ استعمال کر سکتا ہے۔
• ہر صفحہ دیکھنے پر geocoding۔ سست اور مہنگا؛ محفوظ کرتے وقت ایک بار geocode کریں۔
• کی پابندیوں میں لائیو ڈومین بھول جانا۔ preview میں کام کرتا ہے، پروڈکشن میں خالی سلیٹی باکس بنتا ہے۔
• صرف نقشے والے لے آؤٹ۔ لسٹ کے بغیر پن چھوٹی اسکرینز پر تکلیف دہ اور ناقابل رسائی ہوتے ہیں۔
• کلسٹرنگ کے بغیر سینکڑوں مارکرز۔ ناقابل پڑھائی اور سست۔
• attribution غائب ہونا۔ زیادہ تر نقشہ اور tile فراہم کنندگان اسے لازمی کرتے ہیں، اور اسے چھپانا ان کی شرائط توڑتا ہے۔
• صفحہ لوڈ پر مقام مانگنا۔ صرف تب پوچھیں جب صارف “Near me” پر ٹیپ کرے۔

چیک لسٹ

• کام کے لیے درست نقشے کی قسم چنی گئی
• براؤزر کی key آپ کے ڈومینز اور درکار APIs تک محدود ہے
• سرور سائیڈ کیز سیکرٹس میں رکھی گئی ہیں
• کوآرڈینیٹس ڈیٹا بیس میں محفوظ ہیں، ایک بار geocode شدہ
• نتائج لسٹ کی شکل میں بھی دکھائے گئے ہیں
• بہت سے مارکرز کے لیے clustering ہے
• attribution نظر آتا ہے
• فراہم کنندہ کے ساتھ بجٹ الرٹ مقرر ہے
• شائع شدہ ڈومین پر اور فون پر جانچ ہو چکی ہے

Mythex کے ساتھ نقشے شامل کرنا

Mythex میں بلٹ اِن نقشوں کا انضمام نہیں ہے؛ آپ اپنی فراہم کنندہ کی key لاتے ہیں، اسے پروجیکٹ سیکرٹ کے طور پر شامل کرتے ہیں (یا جب ایجنٹ سیکرٹس کارڈ دکھائے تو وہیں چسپاں کریں)، اور چیٹ میں نقشہ مانگتے ہیں، جیسا کہ کوئی بھی API انضمام کریں میں بیان ہے۔ کوآرڈینیٹس پروجیکٹ کے ڈیٹا بیس میں جاتے ہیں۔ یاد رکھیں کہ کی کی ویب سائٹ پابندیوں میں اپنے preview اور شائع شدہ دونوں ڈومین شامل کریں، اور سیکرٹس بدلنے کے بعد دوبارہ پبلش کریں۔

نقشے عموماً سرچ اور لسٹنگز کے ساتھ ہوتے ہیں: دیکھیں اپنی ایپ میں سرچ کیسے شامل کریں، ڈائریکٹری ویب سائٹ کیسے بنائیں اور چھوٹے کاروبار کی ویب سائٹ کیسے بنائیں۔

سوالات