سبک نقشه پایه جدید به زودی به پلتفرم نقشه های گوگل می آید. این به‌روزرسانی برای استایل نقشه شامل یک پالت رنگی پیش‌فرض جدید، پین‌های مدرن شده و بهبودهایی در تجربه‌ها و قابلیت استفاده از نقشه است. همه سبک‌های نقشه به‌طور خودکار در مارس 2025 به‌روزرسانی می‌شوند. برای اطلاعات بیشتر در مورد در دسترس بودن و نحوه انتخاب زودتر، به سبک نقشه جدید برای پلتفرم Google Maps مراجعه کنید.

این صفحه به‌وسیله ‏Cloud Translation API‏ ترجمه شده است.

شروع کنید

مقدمه

Maps Static API یک تصویر (اعم از GIF، PNG یا JPEG) را در پاسخ به درخواست HTTP از طریق یک URL برمی گرداند. برای هر درخواست، می توانید مکان نقشه، اندازه تصویر، سطح بزرگنمایی، نوع نقشه و قرار دادن نشانگرهای اختیاری در مکان های روی نقشه را مشخص کنید. همچنین می‌توانید نشانگرهای خود را با استفاده از نویسه‌های الفبایی برچسب‌گذاری کنید.

یک تصویر Maps Static API درون ویژگی src تگ <img> یا معادل آن در سایر زبان های برنامه نویسی تعبیه شده است.

این سند فرمت مورد نیاز URL های Maps Static API و پارامترهای موجود را شرح می دهد. همچنین به نکات و ترفندهایی در تعیین URL های شما اشاره می کند.

قبل از شروع

این سند برای توسعه دهندگان وب سایت و تلفن همراه که می خواهند تصاویر Maps Static API را در یک صفحه وب یا برنامه تلفن همراه قرار دهند در نظر گرفته شده است. مقدمه ای برای استفاده از API و مواد مرجع در پارامترهای موجود ارائه می دهد.

قبل از شروع توسعه با Maps Static API، الزامات احراز هویت (شما به یک کلید API نیاز دارید) و استفاده از API و اطلاعات صورتحساب (شما باید صورتحساب را در پروژه خود فعال کنید) را مرور کنید.

پارامترهای URL

نشانی وب Maps Static API باید به شکل زیر باشد:

https://maps.googleapis.com/maps/api/staticmap?parameters

اگر وب سایت شما از طریق HTTPS قابل دسترسی است، باید تصاویر Maps Static API را نیز از طریق HTTPS بارگیری کنید تا از هشدارهای امنیتی مرورگر جلوگیری کنید. HTTPS همچنین توصیه می‌شود اگر درخواست‌های شما شامل اطلاعات حساس کاربر، مانند موقعیت مکانی کاربر باشد:

https://maps.googleapis.com/maps/api/staticmap?parameters

چه با استفاده از HTTP یا HTTPS، پارامترهای URL خاصی مورد نیاز هستند در حالی که برخی اختیاری هستند. همانطور که در URL ها استاندارد است، تمام پارامترها با استفاده از علامت علامت ( & ) از هم جدا می شوند. لیست پارامترها و مقادیر احتمالی آنها در این سند برشمرده شده است.

مهم: در بحث پارامترهای URL از مثال‌هایی استفاده می‌شود که برای وضوح در فرم پیش‌فرض آورده شده‌اند. قبل از ارسال هر درخواستی به API، پارامترهای آن باید به درستی با URL رمزگذاری شوند. به عنوان مثال، بسیاری از پارامترها از یک کاراکتر لوله ( | ) به عنوان جداکننده استفاده می کنند که باید به صورت %7C در URL نهایی کدگذاری شود، مانند مثال سریع بالای این سند. برای اطلاعات بیشتر، به ساخت یک URL معتبر مراجعه کنید.

Maps Static API تصاویر نقشه را با استفاده از پارامترهای URL زیر تعریف می کند:

پارامترهای مکان

center (در صورت عدم وجود نشانگرها لازم است ) مرکز نقشه را با فاصله مساوی از تمام لبه های نقشه مشخص می کند. این پارامتر یک مکان را به‌عنوان یک جفت {latitude,gengitude} جدا شده با کاما (مثلاً «40.714728,-73.998672») یا یک آدرس رشته‌ای (مثلاً «شهرداری، نیویورک، نیویورک») می‌گیرد که مکان منحصربه‌فرد را در چهره نشان می‌دهد. زمین برای اطلاعات بیشتر، مکان‌ها را ببینید.
zoom (در صورت عدم وجود نشانگرها لازم است ) سطح بزرگنمایی نقشه را تعیین می کند که سطح بزرگنمایی نقشه را تعیین می کند. این پارامتر یک مقدار عددی مطابق با سطح بزرگنمایی منطقه مورد نظر می گیرد. برای اطلاعات بیشتر، سطوح بزرگنمایی را ببینید.

پارامترهای نقشه

size ( مورد نیاز ) ابعاد مستطیلی تصویر نقشه را مشخص می کند. این پارامتر رشته ای به شکل {horizontal_value} x {vertical_value} می گیرد. به عنوان مثال، 500x400 یک نقشه را با عرض 500 پیکسل در ارتفاع 400 پیکسل تعریف می کند. نقشه های کوچکتر از 180 پیکسل در عرض، یک لوگوی گوگل با اندازه کوچک نمایش داده می شود. این پارامتر تحت تأثیر پارامتر scale قرار می گیرد. اندازه خروجی نهایی حاصل ضرب مقادیر اندازه و مقیاس است.
scale ( اختیاری ) بر تعداد پیکسل های برگردانده شده تأثیر می گذارد. scale=2 دو برابر scale=1 پیکسل را برمی گرداند در حالی که همان ناحیه پوشش و سطح جزئیات را حفظ می کند (یعنی محتوای نقشه تغییر نمی کند). این در هنگام توسعه برای نمایشگرهای با وضوح بالا مفید است. مقدار پیش فرض 1 است. مقادیر پذیرفته شده 1 و 2 هستند. برای اطلاعات بیشتر به مقیاس مقادیر مراجعه کنید.
format ( اختیاری ) فرمت تصویر حاصل را مشخص می کند. به طور پیش فرض، Maps Static API تصاویر PNG را ایجاد می کند. چندین فرمت ممکن از جمله انواع GIF، JPEG و PNG وجود دارد. اینکه از کدام فرمت استفاده می کنید بستگی به نحوه ارائه تصویر دارد. JPEG معمولاً فشرده سازی بیشتری را فراهم می کند، در حالی که GIF و PNG جزئیات بیشتری را ارائه می دهند. برای اطلاعات بیشتر، فرمت های تصویر را ببینید.
maptype ( اختیاری ) نوع نقشه را برای ساخت تعریف می کند. چندین مقدار نقشه تایپ ممکن وجود دارد، از جمله roadmap ، satellite ، hybrid و terrain . برای اطلاعات بیشتر، Maps Static API Maptypes را ببینید.
language ( اختیاری ) زبانی را برای نمایش برچسب‌ها روی کاشی‌های نقشه تعریف می‌کند. توجه داشته باشید که این پارامتر فقط برای برخی از کاشی های کشور پشتیبانی می شود. اگر زبان خاص درخواست شده برای مجموعه کاشی پشتیبانی نمی شود، از زبان پیش فرض برای آن مجموعه کاشی استفاده می شود.
region ( اختیاری ) بر اساس حساسیت های ژئوپلیتیکی، مرزهای مناسب را برای نمایش تعریف می کند. کد منطقه ای را می پذیرد که به عنوان مقدار دو کاراکتری ccTLD («دامنه سطح بالا») مشخص شده است. جزئیات پوشش پلت فرم Google Maps را برای مناطق پشتیبانی شده ببینید.

پارامترهای ویژگی

map_id ( اختیاری ) شناسه یک نقشه خاص را مشخص می کند. Map ID یک نقشه را با یک سبک یا ویژگی خاص مرتبط می کند و باید متعلق به همان پروژه ای باشد که کلید API مورد استفاده برای مقداردهی اولیه نقشه است. برای اطلاعات بیشتر، به استفاده از شناسه نقشه مراجعه کنید.
markers ( اختیاری ) یک یا چند نشانگر را برای چسباندن به تصویر در مکان های مشخص شده تعریف می کنند. این پارامتر یک تعریف نشانگر منفرد با پارامترهای جدا شده با کاراکتر لوله ( | ) می گیرد. چندین نشانگر ممکن است در یک پارامتر markers قرار گیرند تا زمانی که یک سبک را نشان دهند. می‌توانید با افزودن پارامترهای markers اضافی، نشانگرهای دیگری از سبک‌های مختلف اضافه کنید. توجه داشته باشید که اگر نشانگرها را برای نقشه تهیه می کنید، نیازی به تعیین پارامترهای center و zoom (معمولاً مورد نیاز) ندارید. برای اطلاعات بیشتر، نشانگرهای API Static Maps را ببینید.
path ( اختیاری ) یک مسیر واحد از دو یا چند نقطه متصل را برای همپوشانی روی تصویر در مکان‌های مشخص شده تعریف می‌کند. این پارامتر یک رشته از تعاریف نقطه را می گیرد که با کاراکتر لوله ( | ) از هم جدا شده اند، یا یک چند خط کدگذاری شده با استفاده از پیشوند enc: در اعلان مکان مسیر. شما می توانید مسیرهای اضافی را با افزودن پارامترهای path اضافی ارائه دهید. توجه داشته باشید که اگر مسیری را برای نقشه ارائه می کنید، نیازی به تعیین پارامترهای center و zoom (معمولاً مورد نیاز) ندارید. برای اطلاعات بیشتر، Maps Static API Paths را ببینید.
visible ( اختیاری ) یک یا چند مکان را مشخص می کند که باید روی نقشه قابل مشاهده باشند، اگرچه هیچ نشانگر یا نشانگر دیگری نمایش داده نخواهد شد. از این پارامتر برای اطمینان از اینکه برخی از ویژگی‌ها یا مکان‌های نقشه در Maps Static API نشان داده می‌شوند، استفاده کنید.
style ( اختیاری ) یک سبک سفارشی را برای تغییر نمایش یک ویژگی خاص (جاده‌ها، پارک‌ها و سایر ویژگی‌های) نقشه تعریف می‌کند. این پارامتر آرگومان‌های feature و element را می‌گیرد که ویژگی‌های استایل را شناسایی می‌کند، و مجموعه‌ای از عملیات سبک را برای اعمال به ویژگی‌های انتخاب شده می‌گیرد. شما می توانید چندین سبک را با افزودن پارامترهای style اضافی ارائه دهید. برای اطلاعات بیشتر، راهنمای نقشه‌های سبک‌دار را ببینید.

پارامترهای کلید و امضا

key ( الزامی ) به شما امکان می دهد استفاده از API برنامه خود را در Google Cloud Console نظارت کنید و اطمینان حاصل می کند که Google می تواند در صورت لزوم درباره برنامه شما با شما تماس بگیرد. برای اطلاعات بیشتر، به استفاده از کلیدهای API با Maps Static API مراجعه کنید.
signature ( توصیه می‌شود ) یک امضای دیجیتالی است که برای تأیید اینکه هر سایتی که با استفاده از کلید API شما درخواست ایجاد می‌کند مجاز به انجام این کار است استفاده می‌شود. درخواست‌های بدون امضای دیجیتال ممکن است با شکست مواجه شوند. برای اطلاعات بیشتر، به استفاده از امضای دیجیتال مراجعه کنید.

محدودیت اندازه URL

URL های Maps Static API به اندازه 16384 کاراکتر محدود شده است. در عمل، احتمالاً نیازی به URL های طولانی تر از این نخواهید داشت، مگر اینکه نقشه های پیچیده با تعداد زیادی نشانگر و مسیر تولید کنید.

استفاده از پارامتر

استفاده از Maps Static API نسبتاً آسان است، زیرا فقط از یک URL پارامتری تشکیل شده است. این بخش نحوه استفاده از این پارامترها را برای ساخت URL های خود توضیح می دهد.

تعیین مکان ها

Maps Static API باید بتواند مکان‌های روی نقشه را دقیقاً شناسایی کند، هم برای متمرکز کردن نقشه در مکان صحیح (با استفاده از پارامتر center ) و/یا برای قرار دادن هر مکان علامت اختیاری (با استفاده از پارامتر markers ) در مکان‌های روی نقشه. Maps Static API از اعداد (مقادیر طول و عرض جغرافیایی) یا رشته ها (آدرس) برای تعیین این مکان ها استفاده می کند. این مقادیر یک مکان جغرافیایی کد شده را مشخص می کنند.

چندین پارامتر (مانند markers و پارامترهای path ) مکان های متعددی را می گیرند. در این موارد، مکان ها با کاراکتر لوله ( | ) از هم جدا می شوند.

طول و عرض جغرافیایی

طول و عرض جغرافیایی با استفاده از اعداد درون یک رشته متنی جدا شده با کاما که دقت آن تا 6 رقم اعشار است، تعریف می شوند. به عنوان مثال، "40.714728,-73.998672" یک مقدار ژئوکد معتبر است. دقت فراتر از 6 رقم اعشار نادیده گرفته می شود.

مقادیر طول جغرافیایی بر اساس فاصله آنها از گرینویچ، انگلستان، خانه نصف النهار اصلی است. از آنجایی که گرینویچ در عرض جغرافیایی 51.477222 قرار دارد، می‌توانیم مقدار center 51.477222,0 را وارد کنیم تا نقشه را در مرکز گرینویچ قرار دهیم:

گرینویچ، انگلستان

مقادیر طول و عرض جغرافیایی باید با یک مکان معتبر در روی زمین مطابقت داشته باشد. عرض جغرافیایی می تواند هر مقداری بین -90 و 90 داشته باشد در حالی که مقادیر طول جغرافیایی می توانند هر مقداری بین -180 و 180 داشته باشند. اگر مقدار طول و عرض جغرافیایی نامعتبر را مشخص کنید، درخواست شما به عنوان یک درخواست بد رد خواهد شد.

آدرس ها

اکثر مردم در طول و عرض جغرافیایی صحبت نمی کنند. آنها مکان ها را با استفاده از آدرس ها نشان می دهند. فرآیند تبدیل یک آدرس به یک نقطه جغرافیایی به عنوان geocoding شناخته می شود و سرویس Maps Static API می تواند در صورت ارائه آدرس های معتبر، کدگذاری جغرافیایی را برای شما انجام دهد.

در هر پارامتری که می‌توانید طول و عرض جغرافیایی ارائه دهید، می‌توانید در عوض رشته‌ای را مشخص کنید که نشانی را نشان می‌دهد. Google آدرس را ژئوکد می‌کند و به سرویس Maps Static API یک مقدار طول و عرض جغرافیایی ارائه می‌کند تا در قرار دادن نشانگرها یا تعیین مکان‌ها از آن استفاده کند. رشته باید با URL رمزگذاری شود، بنابراین آدرس‌هایی مانند «City Hall, New York, NY» باید به عنوان مثال به «City+Hall,New+York,NY» تبدیل شوند.

توجه داشته باشید که آدرس‌ها ممکن است مکان‌های دقیقی مانند آدرس‌های خیابان، چند خطوط مانند مسیرهای نام‌گذاری شده، یا مناطق چند ضلعی مانند شهرها، کشورها یا پارک‌های ملی را منعکس کنند. برای نتایج چند خطی و چند ضلعی، سرور Maps Static API از نقطه مرکزی خط/منطقه به عنوان مرکز آدرس استفاده خواهد کرد. اگر در مورد نحوه کدگذاری یک آدرس شک دارید، می توانید آدرس را با استفاده از این ابزار Geocoding آزمایش کنید.

مثال زیر یک تصویر نقشه ایستا برای برکلی، کالیفرنیا ایجاد می کند:

https://maps.googleapis.com/maps/api/staticmap?center=Berkeley,CA&zoom=14&size=400x400&key=YOUR_API_KEY&signature=YOUR_SIGNATURE

برکلی، کالیفرنیا

سطوح بزرگنمایی

نقشه‌های Google Maps دارای یک عدد صحیح «سطح بزرگ‌نمایی» هستند که وضوح نمای فعلی را مشخص می‌کند. سطوح بزرگنمایی بین 0 (پایین ترین سطح بزرگنمایی، که در آن کل جهان را می توان در یک نقشه مشاهده کرد) و 21+ (تا خیابان ها و ساختمان های فردی) در نمای پیش فرض roadmap امکان پذیر است. خطوط کلی ساختمان، در صورت وجود، روی نقشه حول سطح زوم 17 ظاهر می شوند. این مقدار از ناحیه ای به ناحیه دیگر متفاوت است و می تواند در طول زمان با تکامل داده ها تغییر کند.

Google Maps سطح زوم را 0 تنظیم می کند تا کل زمین را در بر بگیرد. هر سطح بزرگنمایی بعدی دقت را در ابعاد افقی و عمودی دو برابر می کند. اطلاعات بیشتر در مورد نحوه انجام این کار در اسناد Google Maps JavaScript API موجود است.

توجه: همه سطوح زوم در تمام نقاط روی زمین ظاهر نمی شوند. سطوح زوم بسته به مکان متفاوت است، زیرا داده‌ها در برخی از نقاط کره زمین نسبت به سایر مکان‌ها دانه‌بندی‌تر هستند.

اگر درخواستی برای سطح بزرگنمایی ارسال کنید که در آن هیچ کاشی نقشه وجود نداشته باشد، Maps Static API به جای آن یک تصویر خالی برمی گرداند.

لیست زیر سطح تقریبی جزئیاتی را که می‌توانید انتظار داشته باشید در هر سطح بزرگ‌نمایی ببینید را نشان می‌دهد:

1: جهان
5: خشکی / قاره
10: شهر
15: خیابان ها
20: ساختمان ها

این مثال دو نقشه از منهتن را با همان مقدار center اما در سطوح زوم 12 و 14 درخواست می‌کند:

https://maps.googleapis.com/maps/api/staticmap?center=40.714728,-73.998672&zoom=12&size=400x400&key=YOUR_API_KEY&signature=YOUR_SIGNATURE
https://maps.googleapis.com/maps/api/staticmap?center=40.714728,-73.998672&zoom=14&size=400x400&key=YOUR_API_KEY&signature=YOUR_SIGNATURE

منهتن دور منهتن از نزدیک

اندازه های تصویر

پارامتر size ، در ارتباط با center ، منطقه پوشش یک نقشه را مشخص می کند. همچنین اندازه خروجی نقشه را زمانی که با مقدار scale (که به طور پیش فرض 1 است) ضرب می شود، بر حسب پیکسل تعریف می کند.

این جدول حداکثر مقادیر مجاز برای پارامتر size را در هر مقدار scale نشان می دهد.

`scale=1`	`scale=2`
`640x640`	`640x640` (1280x1280 پیکسل را برمی‌گرداند)

این مثال یک "برش" از زمین در خط استوا در سطح زوم 1 را درخواست می کند:

https://maps.googleapis.com/maps/api/staticmap?center=0,0&zoom=1&size=400x50&key=YOUR_API_KEY&signature=YOUR_SIGNATURE

استوا

این مثال یک نقشه کوچک به اندازه 100 x 100 پیکسل در مرکز یک منطقه درخواست می کند. به لوگوی کوچکتر گوگل توجه کنید:

https://maps.googleapis.com/maps/api/staticmap?center=0,0&zoom=1&size=100x100&key=YOUR_API_KEY&signature=YOUR_SIGNATURE

نقشه استوای کوچک

مقادیر مقیاس

پارامتر size Maps Static API اندازه یک نقشه را بر حسب پیکسل تعیین می کند، به طوری که یک نقشه با size=200x200 به صورت 200 پیکسل در 200 پیکسل برگردانده می شود. در یک مانیتور کامپیوتر LCD که معمولاً حدود 100 پیکسل در هر اینچ (ppi) نمایش می دهد، یک نقشه 200x200 در هر بعد حدود 2 اینچ خواهد بود.

با این حال، دستگاه های تلفن همراه به طور فزاینده ای شامل صفحه نمایش هایی با وضوح بالا با تراکم پیکسلی بیش از 300ppi می شوند که یا:

اندازه یک تصویر 200x200 پیکسل را به تنها 0.7 اینچ کاهش دهید، برچسب ها و نمادها برای خواندن بسیار کوچک هستند. یا
مقیاس (بزرگنمایی) تصویر را برای بهبود خوانایی، در نتیجه یک تصویر فازی یا پیکسلی ایجاد کنید.

خیلی کوچک	خیلی مبهم

هنگام توسعه برای دستگاه های تلفن همراه، می توانید از پارامتر scale API برای بازگرداندن تصاویر نقشه با وضوح بالاتر استفاده کنید که مشکلات بالا را حل می کند. مقدار scale با size ضرب می شود تا اندازه خروجی واقعی تصویر بر حسب پیکسل، بدون تغییر ناحیه پوشش نقشه مشخص شود. مقدار scale پیش فرض 1 است. مقادیر پذیرفته شده 1 و 2 هستند.

به عنوان مثال، مقدار مقیاس 2 همان منطقه پوشش نقشه را به عنوان یک درخواست بدون مقیاس مشخص، اما با دو برابر تعداد پیکسل در هر بعد برمی گرداند. این شامل جاده‌ها و برچسب‌ها می‌شود، به طوری که در صفحه‌های با وضوح بالا، اندازه کوچک و همچنین وقتی که توسط مرورگر مقیاس‌بندی می‌شوند، خوانا باشند.

150*150	150x150&مقیاس=2

چنین تصویری در مرورگرهای دسکتاپ نیز عملکرد خوبی دارد، زمانی که در تگ img یا div با ارتفاع و عرض تنظیم شده با استفاده از CSS قرار داده شود. مرورگر تصویر را به اندازه صحیح، بدون افت کیفیت، کوچک می کند.

این جدول سه درخواست تصویر مختلف را نشان می دهد.

اولین مورد برای یک تصویر 100x100 است که هیچ مقدار مقیاس مشخص نشده است. به درستی روی دسکتاپ نمایش داده می شود، اما برای خواندن در دستگاه تلفن همراه بسیار کوچک است.
دومی اندازه نقشه را دو برابر می کند. در دسکتاپ، CSS آن را در عنصر img 100x100 قرار می دهد، اما در کوچک کردن تصویر، جاده ها و برچسب ها خیلی کوچک می شوند. در دستگاه تلفن همراه، تصویر اندازه مناسبی دارد، اما باز هم، جاده ها و برچسب ها ناخوانا هستند.
درخواست سوم برای نقشه 100x100 با scale=2 است. تصویر با جزئیات 200 پیکسل برگردانده می شود. دسکتاپ آن را کاملاً کاهش می دهد، به طوری که از درخواست اصلی 100x100 قابل تشخیص نیست، در حالی که مرورگر تلفن همراه از وضوح اضافی ارائه شده توسط API سود می برد.

درخواست های تصویر
دستگاه	`100x100`	`200x200`	`100x100&scale=2`
دسکتاپ (با `height="100px"` و `width="100px"` در تگ `img` )
وضوح بالا (شبیه سازی شده)

نکته : پلتفرم‌های تلفن همراه، مانند Android و iOS، برنامه‌ها را قادر می‌سازند تا با تعیین تصاویر جداگانه برای هر وضوح، از صفحه‌نمایش با وضوح بالا پشتیبانی کنند. پارامتر مقیاس درخواست یک تصویر نقشه را برای یک صفحه نمایش با وضوح استاندارد و نقشه منطبق برای یک صفحه نمایش با وضوح بالا را به ترتیب با تنظیم scale=1 و scale=2 آسان می کند.

برای اطلاعات بیشتر در مورد توسعه نمایشگرهای موبایل و وضوح بالا، مطالعه زیر توصیه می شود:

پشتیبانی از چندین صفحه در اسناد توسعه دهنده اندروید.
توصیه های Webkit.org برای توسعه وب سایت های با DPI بالا .
پشتیبانی از صفحه نمایش با وضوح بالا در کتابخانه توسعه دهندگان iOS.

فرمت های تصویر

تصاویر ممکن است در چندین قالب گرافیکی وب رایج بازگردانده شوند: GIF ، JPEG و PNG . پارامتر format یکی از مقادیر زیر را می گیرد:

png8 یا png (پیش‌فرض) فرمت 8 بیتی PNG را مشخص می‌کند.
png32 فرمت PNG 32 بیتی را مشخص می کند.
gif فرمت GIF را مشخص می کند.
jpg فرمت فشرده سازی JPEG را مشخص می کند.
jpg-baseline فرمت فشرده سازی JPEG غیر مترقی را مشخص می کند.

این نمونه ها نقشه ها را با فرمت های gif و png درخواست می کنند:

  https://maps.googleapis.com/maps/api/staticmap?center=40.714728,-73.998672&format=gif&zoom=14&size=400x400&key=YOUR_API_KEY&signature=YOUR_SIGNATURE
  https://maps.googleapis.com/maps/api/staticmap?center=40.714728,-73.998672&format=png&&zoom=14&size=400x400&key=YOUR_API_KEY&signature=YOUR_SIGNATURE

jpg و jpg-baseline معمولاً کوچک‌ترین اندازه تصویر را ارائه می‌کنند، اگرچه این کار را از طریق فشرده‌سازی «از دست دادن» انجام می‌دهند که ممکن است تصویر را تخریب کند. gif ، png8 و png32 فشرده‌سازی بدون تلفات را فراهم می‌کنند.

اکثر تصاویر JPEG پیشرونده هستند، به این معنی که آنها یک تصویر درشت تر را زودتر بارگذاری می کنند و با رسیدن اطلاعات بیشتر، وضوح تصویر را اصلاح می کنند. این اجازه می دهد تا تصاویر به سرعت در صفحات وب بارگذاری شوند و در حال حاضر گسترده ترین استفاده از JPEG است. با این حال، برخی از کاربردهای JPEG به تصاویر غیرپیشرو (پایه) نیاز دارند. در چنین مواردی، ممکن است بخواهید از فرمت jpg-baseline استفاده کنید که غیر پیشرونده است.

انواع نقشه

Maps Static API نقشه‌ها را در قالب‌های مختلفی ایجاد می‌کند که در زیر فهرست شده‌اند:

roadmap (پیش فرض) یک تصویر نقشه راه استاندارد را مشخص می کند، همانطور که معمولاً در وب سایت Google Maps نشان داده می شود. اگر مقدار maptype مشخص نشده باشد، Maps Static API به صورت پیش‌فرض از کاشی‌های roadmap استفاده می‌کند.
satellite یک تصویر ماهواره ای را مشخص می کند.
terrain یک تصویر نقشه تسکین فیزیکی را مشخص می کند که زمین و پوشش گیاهی را نشان می دهد.
hybrid ترکیبی از تصویر ماهواره ای و نقشه راه را مشخص می کند که یک لایه شفاف از خیابان های اصلی و نام مکان ها را روی تصویر ماهواره ای نشان می دهد.

می توانید تفاوت بین نقشه راه و انواع زمین را در این مثال کد مشاهده کنید.

https://maps.googleapis.com/maps/api/staticmap?center=40.714728,-73.998672&zoom=12&size=400x400&maptype=roadmap&key=YOUR_API_KEY&signature=YOUR_SIGNATURE
https://maps.googleapis.com/maps/api/staticmap?center=40.714728,-73.998672&zoom=12&size=400x400&maptype=terrain&key=YOUR_API_KEY&signature=YOUR_SIGNATURE

نقشه معمولی منهتن نقشه زمین منهتن

نقشه های ترکیبی از تصاویر ماهواره ای و ویژگی های برجسته نقشه راه برای ایجاد یک نقشه ترکیبی استفاده می کنند. نمونه های زیر انواع نقشه های ماهواره ای و ترکیبی را نشان می دهد:

https://maps.googleapis.com/maps/api/staticmap?center=40.714728,-73.998672&zoom=12&size=400x400&maptype=satellite&key=YOUR_API_KEY&signature=YOUR_SIGNATURE
https://maps.googleapis.com/maps/api/staticmap?center=40.714728,-73.998672&zoom=12&size=400x400&maptype=hybrid&key=YOUR_API_KEY&signature=YOUR_SIGNATURE

نقشه ماهواره ای منهتن نقشه زمین منهتن

نقشه های سبک

با اعمال سبک های خود، ارائه نقشه استاندارد گوگل را سفارشی کنید. راهنمای نقشه‌های سبک‌دار را ببینید.

نشانگرها

پارامتر markers مجموعه ای از یک یا چند نشانگر (پین نقشه) را در مجموعه ای از مکان ها تعریف می کند. هر نشانگر تعریف شده در یک بیانیه markers باید همان سبک بصری را نشان دهد. اگر می‌خواهید نشانگرهایی با سبک‌های مختلف نمایش دهید، باید چندین پارامتر markers با اطلاعات سبک جداگانه ارائه کنید.

پارامتر markers مجموعه ای از تخصیص مقادیر ( توصیفگرهای نشانگر ) با فرمت زیر را می گیرد:

markers= markerStyles | markerLocation1 | markerLocation2 |... و غیره

مجموعه markerStyles در ابتدای اعلامیه markers اعلام می شود و شامل صفر یا چند توصیفگر سبک است که با کاراکتر pipe ( | ) از هم جدا شده اند و به دنبال آن مجموعه ای از یک یا چند مکان نیز با کاراکتر pipe ( | ) از هم جدا شده اند.

از آنجایی که هم اطلاعات سبک و هم اطلاعات مکان از طریق کاراکتر لوله مشخص می شود، اطلاعات سبک باید ابتدا در هر توصیفگر نشانگر ظاهر شود. هنگامی که سرور Maps Static API با یک مکان در توصیفگر نشانگر مواجه شد، همه پارامترهای نشانگر دیگر نیز مکان‌ها فرض می‌شوند.

سبک های نشانگر

مجموعه توصیفگرهای سبک نشانگر مجموعه ای از تخصیص ارزش است که با کاراکتر لوله ( | ) از هم جدا شده اند. این توصیفگر سبک، ویژگی های بصری را برای استفاده در هنگام نمایش نشانگرها در این توصیفگر نشانگر تعریف می کند. این توصیفگرهای سبک حاوی تخصیص کلید/مقدار زیر هستند:

size: (اختیاری) اندازه نشانگر را از مجموعه {tiny, mid, small} مشخص می کند. اگر هیچ پارامتر size تنظیم نشده باشد، نشانگر در اندازه پیش فرض (عادی) خود ظاهر می شود.
color: (اختیاری) یک رنگ 24 بیتی (مثال: color=0xFFFFCC ) یا یک رنگ از پیش تعریف شده از مجموعه {black, brown, green, purple, yellow, blue, gray, orange, red, white} را مشخص می کند.
توجه داشته باشید که شفافیت‌ها (که با استفاده از مقادیر رنگ هگز 32 بیتی مشخص شده‌اند) در نشانگرها پشتیبانی نمی‌شوند، اگرچه برای مسیرها پشتیبانی می‌شوند.
label : (اختیاری) یک نویسه الفبای عددی با حروف بزرگ را از مجموعه {AZ, 0-9} مشخص می کند. (الزام نویسه‌های بزرگ برای این نسخه از API جدید است.) توجه داشته باشید که نشانگرهای پیش‌فرض و اندازه mid تنها نشانگرهایی هستند که قادر به نمایش پارامتر alphanumeric-character هستند. نشانگرهای tiny و small قادر به نمایش یک کاراکتر الفبایی نیستند.

مقیاس بندی نشانگر

مقدار scale با اندازه تصویر نشانگر ضرب می شود تا اندازه خروجی واقعی نشانگر بر حسب پیکسل تولید شود. مقدار مقیاس پیش فرض 1 است. مقادیر پذیرفته شده 1، 2 و 4 هستند.

محدودیت اندازه پیکسل در تصاویر پس از اعمال مقیاس اعمال می شود. به عنوان مثال، اگر نشانگر روی scale:2 تنظیم شده باشد، نشانگر می تواند بزرگتر از حداکثر اندازه 4096 پیکسل باشد، البته تا زمانی که پس از مقیاس بندی به کمتر از 4096 پیکسل کاهش یابد. هنگام نمایش نقشه‌های با وضوح بالاتر، از مقیاس‌بندی نشانگر در ارتباط با مقیاس‌بندی نقشه استفاده کنید.

مکان های نشانگر

هر توصیفگر نشانگر باید شامل مجموعه ای از یک یا چند مکان باشد که مشخص می کند نشانگر در نقشه کجا قرار گیرد. این مکان ها ممکن است به عنوان مقادیر طول و عرض جغرافیایی یا به عنوان آدرس مشخص شوند. این مکان ها با استفاده از کاراکتر لوله ( | ) از هم جدا می شوند.

توجه : اگر انتخاب کنید مکان‌های نشانگر را با استفاده از روشی که به کدگذاری جغرافیایی نیاز دارد، مانند رشته‌های آدرس یا چند خطی قابل خواندن توسط انسان، تعیین کنید، درخواست حداکثر به ۱۵ نشانگر محدود می‌شود. این محدودیت فقط برای مکان های نشانگر که نیاز به کدگذاری جغرافیایی دارند اعمال می شود. برای مکان های نشانگر مشخص شده با مختصات طول و عرض جغرافیایی اعمال نمی شود.

پارامترهای مکان مکان نشانگر را بر روی نقشه مشخص می کنند. اگر مکان خارج از نقشه باشد، به شرطی که پارامترهای center و zoom ارائه شده باشد، آن نشانگر در تصویر ساخته شده ظاهر نمی شود. با این حال، اگر این پارامترها ارائه نشده باشند، سرور Maps Static API به طور خودکار تصویری را می سازد که حاوی نشانگرهای ارائه شده است. ( موقعیت یابی ضمنی را ببینید.)

یک نمونه بیانیه نشانگر در اینجا نشان داده شده است. توجه داشته باشید که ما یک مجموعه از سبک ها و سه مکان را تعریف می کنیم:

https://maps.googleapis.com/maps/api/staticmap?center=Williamsburg,Brooklyn,NY&zoom=13&size=400x400&
markers=color:blue%7Clabel:S%7C11211%7C11206%7C11222&key=YOUR_API_KEY&signature=YOUR_SIGNATURE

سه کد پستی بروکلین

برای تعریف نشانگرها با سبک های مختلف، باید چندین پارامتر markers ارائه کنیم. این مجموعه پارامترهای markers سه نشانگر را تعریف می کند: یک نشانگر آبی با برچسب "S" در 62.107733، -145.5419، یک نشانگر سبز کوچک در "Delta Junction, AK" و یک نشانگر زرد با اندازه متوسط با برچسب "C" در "Tok, AK" ". این نشانگرها در این مثال نشان داده شده اند:

https://maps.googleapis.com/maps/api/staticmap?center=63.259591,-144.667969&zoom=6&size=400x400
&markers=color:blue%7Clabel:S%7C62.107733,-145.541936&markers=size:tiny%7Ccolor:green%7CDelta+Junction,AK
&markers=size:mid%7Ccolor:0xFFFF00%7Clabel:C%7CTok,AK"&key=YOUR_API_KEY&signature=YOUR_SIGNATURE

سه شهر آلاسکا، نشانگرهای مختلف

آیکون های سفارشی

به جای استفاده از نمادهای نشانگر گوگل، می توانید به جای آن از نمادهای سفارشی خود استفاده کنید. نمادهای سفارشی با استفاده از توصیفگر icon در پارامتر markers مشخص می شوند. به عنوان مثال:

markers=icon: URLofIcon | markerLocation

icon با استفاده از یک URL (که باید با URL رمزگذاری شده باشد) مشخص کنید. می‌توانید از نشانی‌های اینترنتی ایجاد شده توسط سرویس‌های کوتاه‌کننده URL مانند https://goo.gl استفاده کنید. اکثر سرویس‌های کوتاه‌کننده URL دارای مزیت رمزگذاری خودکار URLها هستند.

می توانید یک نقطه لنگر برای نماد سفارشی مشخص کنید. نقطه لنگر نحوه قرارگیری نماد را در رابطه با مکان های مشخص شده markers تنظیم می کند. به طور پیش فرض، نقطه لنگر یک نماد سفارشی، مرکز پایین تصویر نماد است. می توانید با استفاده از توصیفگر anchor در ارتباط با icon خود، یک نقطه لنگر متفاوت را مشخص کنید. anchor را به‌عنوان یک نقطه x، y نماد (مانند 10,5 )، یا به‌عنوان یک تراز از پیش تعریف‌شده با استفاده از یکی از مقادیر زیر تنظیم کنید: top ، bottom ، left ، right ، center ، topleft ، topright ، پایین bottomleft ، یا bottomright . به عنوان مثال:

markers=anchor:bottomright|icon: URLofIcon | markerLocation1 | markerLocation2

در هر درخواست می توانید از پنج آیکون سفارشی منحصر به فرد استفاده کنید. این محدودیت به این معنی نیست که شما فقط به 5 مکان علامت گذاری شده در نقشه خود محدود شده اید. هر نماد منحصر به فرد ممکن است با بیش از یک مکان markers روی نقشه شما استفاده شود.

فرمت آیکون:

تصاویر نماد ممکن است در فرمت‌های PNG، JPEG یا GIF باشند، اگرچه PNG توصیه می‌شود.
اندازه نمادها ممکن است حداکثر تا 4096 پیکسل باشد (64x64 برای تصاویر مربعی).

نمونه آیکون های سفارشی

مثال 1 آیکون های سفارشی ایجاد می کند و نمادها را با استفاده از لنگرها قرار می دهد.

https://maps.googleapis.com/maps/api/staticmap?&size=600x400&style=visibility:on
&style=feature:water%7Celement:geometry%7Cvisibility:on
&style=feature:landscape%7Celement:geometry%7Cvisibility:on
&markers=anchor:32,10%7Cicon:https://goo.gl/5y3S82%7CCanberra+ACT
&markers=anchor:topleft%7Cicon:http://tinyurl.com/jrhlvu6%7CMelbourne+VIC
&markers=anchor:topright%7Cicon:https://goo.gl/1oTJ9Y%7CSydney+NSW&key=YOUR_API_KEY
&signature=YOUR_SIGNATURE

سه شهر استرالیا، نمادهای سفارشی مختلف با لنگرها قرار گرفته اند.

مثال 2 همان نمادهای سفارشی را مانند مثال 1 ایجاد می کند، اما موقعیت نمادها را با استفاده از لنگرها، با تکیه بر لنگر پیش فرض مرکز پایین تنظیم نمی کند.

https://maps.googleapis.com/maps/api/staticmap?&size=600x400&style=visibility:on
&style=feature:water%7Celement:geometry%7Cvisibility:on
&style=feature:landscape%7Celement:geometry%7Cvisibility:on
&markers=icon:https://goo.gl/5y3S82%7CCanberra+ACT
&markers=icon:http://tinyurl.com/jrhlvu6%7CMelbourne+VIC
&markers=icon:https://goo.gl/1oTJ9Y%7CSydney+NSW&key=YOUR_API_KEY&signature=YOUR_SIGNATURE

مسیرهای API استاتیک Maps

پارامتر path مجموعه‌ای از یک یا چند مکان را تعریف می‌کند که توسط یک مسیر برای همپوشانی روی تصویر نقشه به هم متصل شده‌اند. پارامتر path مجموعه ای از تخصیص مقادیر ( مشخص کننده های مسیر ) را با فرمت زیر می گیرد:

path= pathStyles | pathLocation1 | pathLocation2 |... و غیره

توجه داشته باشید که هر دو نقطه مسیر با استفاده از کاراکتر لوله ( | ) از یکدیگر جدا می شوند. از آنجایی که هم اطلاعات سبک و هم اطلاعات نقطه از طریق کاراکتر لوله مشخص می شود، اطلاعات سبک باید ابتدا در هر توصیف کننده مسیر ظاهر شود. هنگامی که سرور Maps Static API با مکانی در توصیفگر مسیر مواجه شد، تمام پارامترهای مسیر دیگر نیز مکان‌هایی فرض می‌شوند.

سبک های مسیر

مجموعه توصیفگرهای سبک مسیر مجموعه ای از انتساب مقادیر است که با کاراکتر لوله ( | ) از هم جدا شده اند. این توصیفگر سبک، ویژگی های بصری را برای استفاده در هنگام نمایش مسیر تعریف می کند. این توصیفگرهای سبک حاوی تخصیص کلید/مقدار زیر هستند:

weight: (اختیاری) ضخامت مسیر را بر حسب پیکسل مشخص می کند. اگر پارامتر weight تنظیم نشده باشد، مسیر به ضخامت پیش فرض (5 پیکسل) ظاهر می شود.
color: (اختیاری) یک رنگ را به صورت 24 بیتی (مثال: color=0xFFFFCC ) یا مقدار هگزادسیمال 32 بیتی (مثال: color=0xFFFFCCFF ) یا از مجموعه {black, brown, green, purple, yellow, blue, gray, orange, red, white} مشخص می کند. {black, brown, green, purple, yellow, blue, gray, orange, red, white} .
هنگامی که یک مقدار هگز 32 بیتی مشخص می شود، دو کاراکتر آخر مقدار شفافیت آلفای 8 بیتی را مشخص می کنند. این مقدار بین 00 (کاملا شفاف) و FF (کاملاً مات) متغیر است. توجه داشته باشید که شفافیت ها در مسیرها پشتیبانی می شوند، اگرچه برای نشانگرها پشتیبانی نمی شوند.
fillcolor : (اختیاری) هم نشان می دهد که مسیر یک ناحیه چند ضلعی را مشخص می کند و هم رنگ پر را برای استفاده به عنوان پوشش در آن ناحیه مشخص می کند. مجموعه مکان های زیر لازم نیست یک حلقه "بسته" باشد. سرور Maps Static API به طور خودکار به اولین و آخرین نقطه می پیوندد. با این حال، توجه داشته باشید که هر ضربه ای در قسمت بیرونی ناحیه پر شده بسته نخواهد شد مگر اینکه به طور خاص محل شروع و پایان یکسانی را ارائه دهید.
geodesic : (اختیاری) نشان می دهد که مسیر درخواستی باید به عنوان یک خط ژئودزیکی تفسیر شود که از انحنای زمین پیروی می کند. هنگامی که نادرست است، مسیر به صورت یک خط مستقیم در فضای صفحه نمایش داده می شود. پیش فرض به نادرست.

چند نمونه از تعاریف مسیر:

خط آبی نازک، شفافیت 50%: path=color:0x0000ff80|weight:1
خط قرمز ثابت: path=color:0xff0000ff|weight:5
خط سفید ضخیم یکدست: path=color:0xffffffff|weight:10

این سبک های مسیر اختیاری هستند. اگر ویژگی های پیش فرض مورد نظر است، می توانید از تعریف ویژگی های مسیر صرف نظر کنید. در آن صورت، اولین "آرگمون" توصیفگر مسیر به جای اولین نقطه اعلام شده (موقعیت) خواهد بود.

نقاط مسیر

برای ترسیم یک مسیر، پارامتر path نیز باید از دو یا چند نقطه عبور داده شود. سپس Maps Static API مسیر را در امتداد آن نقاط به ترتیب مشخص شده به هم متصل می کند. هر pathPoint در pathDescriptor که با | از هم جدا شده است نشان داده می شود (لوله) شخصیت.

مثال زیر یک مسیر آبی با کدورت پیش‌فرض 50% از Union Square NY تا Times Square، NY را تعریف می‌کند.

مسیر از میدان یونیون به میدان تایمز

مشخصات پارامتر path عبارتند از:

path=color:0x0000ff|weight:5|40.737102,-73.990318|40.749825,-73.987963|40.752946,-73.987384|40.755823,-73.986397

مثال زیر همان مسیر را به جای تعریف یک خط قرمز ثابت با شفافیت 100٪ تعریف می کند:

مسیر از میدان یونیون به میدان تایمز

مشخصات این پارامتر path عبارتند از:

path=color:0xff0000ff|weight:5|40.737102,-73.990318|40.749825,-73.987963|40.752946,-73.987384|40.755823,-73.986397

مثال بعدی یک منطقه چند ضلعی را در منهتن تعریف می کند که از یک سری تقاطع به عنوان مکان عبور کرده است:

مسیر از میدان یونیون به میدان تایمز

مشخصات این پارامتر path عبارتند از:

path=color:0x00000000|weight:5|fillcolor:0xFFFF0033|8th+Avenue+%26+34th+St,New+York,NY|\
8th+Avenue+%26+42nd+St,New+York,NY|Park+Ave+%26+42nd+St,New+York,NY,NY|\
Park+Ave+%26+34th+St,New+York,NY,NY

توجه داشته باشید که خود مسیر را نامرئی و ناحیه چند ضلعی را 15 درصد opacity قرار می دهیم.

چند خطوط کدگذاری شده

به جای یک سری مکان، می‌توانید با استفاده از پیشوند enc: در اعلان موقعیت path یک مسیر را به‌عنوان چندخط کدگذاری شده اعلام کنید.

مثال زیر مسیر بزرگراه آلاسکا را از داوسون کریک، پیش از میلاد تا دلتا جانکشن، AK با چند خط کدگذاری شده نشان می‌دهد:

https://maps.googleapis.com/maps/api/staticmap
?size=400x400&center=59.900503,-135.478011&zoom=4
&path=weight:3%7Ccolor:orange%7Cenc:_fisIp~u%7CU%7D%7Ca@pytA_~b@hhCyhS~hResU%7C%7Cx@oig@rwg@amUfbjA%7Df%5BroaAynd@%7CvXxiAt%7BZwdUfbjAewYrqGchH~vXkqnAria@c_o@inc@k%7Bg@i%60%5Do%7CF%7DvXaj%5Ch%60%5Dovs@?yi_@rcAgtO%7Cj_AyaJren@nzQrst@zuYh%60%5Dv%7CGbldEuzd@%7C%7Cx@spD%7CtrAzwP%7Cd_@yiB~vXmlWhdPez%5C_%7BKm_%60@~re@ew%5ErcAeu_@zhyByjPrst@ttGren@aeNhoFemKrvdAuvVidPwbVr~j@or@f_z@ftHr%7BZlwBrvdAmtHrmT%7BrOt%7BZz%7DE%7Cc%7C@o%7CLpn~AgfRpxqBfoVz_iAocAhrVjr@rh~@jzKhjp@%60%60NrfQpcHrb%5Ek%7CDh_z@nwB%7Ckb@a%7BR%7Cyh@uyZ%7CllByuZpzw@wbd@rh~@%7C%7CFhqs@teTztrAupHhyY%7Dt%5Dhuf@e%7CFria@o%7DGfezAkdW%7C%7D%5BocMt_Neq@ren@e~Ika@pgE%7Ci%7CAfiQ%7C%60l@uoJrvdAgq@fppAsjGhg%60@%7ChQpg%7BAi_V%7C%7Cx@mkHhyYsdP%7CxeA~gF%7C%7D%5Bmv%60@t_NitSfjp@c%7DMhg%60@sbChyYq%7De@rwg@atFff%7D@ghN~zKybk@fl%7DA%7DcPftcAite@tmT__Lha@u~DrfQi%7DMhkSqyWivIumCria@ciO_tHifm@fl%7DA%7Brc@fbjAqvg@rrqAcjCf%7Ci@mqJtb%5Es%7C@fbjA%7BwDfs%60BmvEfqs@umWt_Nwn%5Epen@qiBr%60xAcvMr%7BZidg@dtjDkbM%7Cd_@
&key=YOUR_API_KEY&signature=YOUR_SIGNATURE

بزرگراه آلاسکا

مانند مسیرهای استاندارد، اگر آرگومان fillcolor به پارامتر path ارسال شود، مسیرهای چند خطی کدگذاری شده نیز ممکن است مناطق چند ضلعی را مشخص کنند.

مثال زیر یک منطقه چند ضلعی را برای بروکلین، نیویورک نشان می دهد:

https://maps.googleapis.com/maps/api/staticmap
?size=400x400&center=40.653279,-73.959816&zoom=11
&path=fillcolor:0xAA000033%7Ccolor:0xFFFFFF00%7Cenc:%7DzswFtikbMjJzZ%7CRdPfZ%7DDxWvBjWpF~IvJnEvBrMvIvUpGtQpFhOQdKpz%40bIx%7BA%7CPfYlvApz%40bl%40tcAdTpGpVwQtX%7Di%40%7CGen%40lCeAda%40bjA%60q%40v%7D%40rfAbjA%7CEwBpbAd_%40he%40hDbu%40uIzWcWtZoTdImTdIwu%40tDaOXw_%40fc%40st%40~VgQ%7C%5BuPzNtA%60LlEvHiYyLs%5EnPhCpG%7DSzCNwHpz%40cEvXg%40bWdG%60%5DlL~MdTmEnCwJ%5BiJhOae%40nCm%5B%60Aq%5DqE_pAaNiyBuDurAuB%7D%7DAy%60%40%7CEKv_%40%3F%7C%5BqGji%40lAhYyH%60%40Xiw%40tBerAs%40q%5DjHohAYkSmW%3FaNoaAbR%7DLnPqNtMtIbRyRuDef%40eT_z%40mW_Nm%7CB~j%40zC~hAyUyJ_U%7BZ%3F%3FcPvg%40%7Ds%40sHsc%40_z%40cj%40kp%40YePoNyYyb%40_iAyb%40gBw%5EbOokArcA%7DGwJuzBre%40i%5Ctf%40sZnd%40oElb%40hStW%7B%5Dvv%40%3F%3Fkz%40~vAcj%40zKa%60Atf%40uQj_Aee%40pU_UrcA
&key=YOUR_API_KEY&signature=YOUR_SIGNATURE

Polyline کدگذاری شده بروکلین با امضا

درگاه های دید

تصاویر ممکن است با تعیین مکان های قابل مشاهده با استفاده از پارامتر visible ، یک درگاه دید را مشخص کنند. پارامتر visible به سرویس Maps Static API دستور می دهد تا نقشه ای بسازد که مکان های موجود قابل مشاهده باقی بمانند. (این پارامتر ممکن است با نشانگرها یا مسیرهای موجود ترکیب شود تا یک منطقه قابل مشاهده نیز تعریف شود.) تعریف یک viewport به این روش، نیاز به تعیین سطح دقیق زوم را برطرف می کند.

مثال بعدی نقشه‌ای را درخواست می‌کند که در مرکز بوستون، MA شامل MIT و میدان هاروارد در کمبریج، MA می‌باشد:

https://maps.googleapis.com/maps/api/staticmap?center=Boston,MA
&visible=77+Massachusetts+Ave,Cambridge,MA%7CHarvard+Square,Cambridge,MA&size=512x512&key=YOUR_API_KEY&signature=YOUR_SIGNATURE

نقشه کمبریج

موقعیت یابی ضمنی نقشه

به طور معمول، برای تعیین مکان و سطح بزرگنمایی نقشه تولید شده خود، باید پارامترهای center و zoom URL را مشخص کنید. با این حال، اگر markers ، path یا پارامترهای visible را ارائه می‌کنید، می‌توانید به جای آن به Maps Static API اجازه دهید مرکز صحیح و سطح بزرگنمایی را به طور ضمنی و بر اساس ارزیابی موقعیت این عناصر تعیین کند.

در صورت ارائه دو یا چند عنصر، Maps Static API یک مرکز و سطح بزرگنمایی مناسب را تعیین می کند و حاشیه های سخاوتمندانه ای را برای عناصر موجود فراهم می کند. این مثال نقشه ای شامل سانفرانسیسکو، اوکلند و سن خوزه، کالیفرنیا را نشان می دهد:

https://maps.googleapis.com/maps/api/staticmap?size=512x512&maptype=roadmap\
&markers=size:mid%7Ccolor:red%7CSan+Francisco,CA%7COakland,CA%7CSan+Jose,CA&key=YOUR_API_KEY&signature=YOUR_SIGNATURE

نقشه راه

اندازه تصویر بزرگتر

اگر به تصاویری با اندازه‌های بزرگتر از ۶۴۰×۶۴۰ پیکسل (یا ۱۲۸۰×۱۲۸۰ پیکسل با مقیاس ۲) نیاز دارید، لطفاً با تیم پشتیبانی تماس بگیرید و اطلاعات زیر را ارائه دهید:

مورد استفاده شما و اینکه چرا به تصاویر با اندازه بزرگ نیاز دارید.
این که آیا به استفاده از سایر APIهای پلتفرم Google Maps (Maps JavaScript API، Maps Embed API، Maps SDK برای Android، یا Maps SDK برای iOS) فکر کرده‌اید و چرا آنها نیازهای شما را برآورده نمی‌کنند.
اسکرین شات، تمسخر، یا نمونه هایی از نحوه استفاده از تصاویر با اندازه بزرگ.
میزان مصرف تخمینی ماهانه شما برای تصاویر با اندازه بزرگ.

ما درخواست شما را بر اساس اطلاعاتی که ارائه می‌کنید بررسی می‌کنیم و تعیین می‌کنیم که آیا مورد استفاده شما با شرایط خدمات پلتفرم Google Maps مطابقت دارد یا خیر.

حداکثر اندازه ای که می توانیم ارائه کنیم 2048 x 2048 پیکسل است.

عیب یابی و پشتیبانی

برای اطلاعات بیشتر در مورد استفاده از Maps Static API، به صفحه پشتیبانی نگاهی بیندازید.

Maps Static API ممکن است زمانی که مشکلی پیش می‌آید خطا یا هشداری صادر کند. اگر متوجه شدید که چیزی در نقشه گم شده است، باید هشدارها را بررسی کنید. همچنین ایده خوبی است که قبل از راه اندازی یک برنامه جدید، هشدارها را بررسی کنید. توجه داشته باشید که هشدارها ممکن است بلافاصله آشکار نشوند زیرا در سربرگ HTTP ظاهر می شوند. برای اطلاعات بیشتر، راهنمای خطاها و هشدارها را ببینید.