Maps Service

نقشه‌ها

این سرویس به اسکریپت‌ها اجازه می‌دهد تا نقشه‌های ایستا تولید کنند، مسیرها را پیدا کنند، آدرس‌ها را به مختصات جغرافیایی تبدیل کنند و ارتفاعات را نمونه‌برداری کنند.

کلاس‌ها

نام	شرح مختصر
Avoid	یک enum که انواع محدودیت‌هایی را که باید هنگام یافتن مسیرها از آنها اجتناب کرد، نشان می‌دهد.
Color	یک enum که رنگ‌های نامگذاری شده‌ی موجود برای استفاده در تصاویر نقشه را نشان می‌دهد.
Direction Finder	امکان بازیابی مسیرها بین مکان‌ها را فراهم می‌کند.
Direction Finder Enums	مجموعه‌ای از enumها که توسط Direction Finder استفاده می‌شود.
Elevation Sampler	امکان نمونه‌برداری از ارتفاعات در مکان‌های خاص را فراهم می‌کند.
Format	یک enum که قالب تصویر نقشه را نشان می‌دهد.
Geocoder	امکان تبدیل بین آدرس و مختصات جغرافیایی را فراهم می‌کند.
Maps	امکان جهت‌یابی، کدگذاری جغرافیایی، نمونه‌برداری ارتفاعی و ایجاد تصاویر نقشه ثابت را فراهم می‌کند.
Marker Size	یک enum که اندازه یک نشانگر اضافه شده به نقشه را نشان می‌دهد.
Mode	یک enum که نشان‌دهنده‌ی نحوه‌ی سفر مورد استفاده هنگام یافتن مسیرها است.
Static Map	امکان ایجاد و تزئین تصاویر نقشه ثابت را فراهم می‌کند.
Static Map Enums	مجموعه‌ای از enumها که توسط Static Map استفاده می‌شود.
Type	یک enum که نوع نقشه‌ای که قرار است رندر شود را نشان می‌دهد.

Avoid

خواص

ملک	نوع	توضیحات
TOLLS	Enum	از پرداخت عوارض خودداری کنید.
HIGHWAYS	Enum	از بزرگراه‌ها دوری کنید.

Color

خواص

ملک	نوع	توضیحات
BLACK	Enum
BROWN	Enum
GREEN	Enum
PURPLE	Enum
YELLOW	Enum
BLUE	Enum
GRAY	Enum
ORANGE	Enum
RED	Enum
WHITE	Enum

Direction Finder

روش‌ها

روش	نوع بازگشتی	شرح مختصر
add Waypoint(latitude, longitude)	Direction Finder	با استفاده از یک نقطه (lat/lng)، یک نقطه‌ی مسیر که مسیر باید از آن عبور کند، اضافه می‌کند.
add Waypoint(address)	Direction Finder	با استفاده از یک آدرس، یک نقطه‌ی مسیر که مسیر باید از آن عبور کند، اضافه می‌کند.
clear Waypoints()	Direction Finder	مجموعه فعلی نقاط مسیر را پاک می‌کند.
get Directions()	Object	مسیرها را با استفاده از مبدا، مقصد و سایر گزینه‌های تنظیم‌شده دریافت می‌کند.
set Alternatives(useAlternatives)	Direction Finder	تعیین می‌کند که آیا مسیرهای جایگزین، به جای فقط مسیر با بالاترین رتبه، بازگردانده شوند یا خیر (پیش‌فرض false است).
set Arrive(time)	Direction Finder	زمان رسیدن مورد نظر را (در صورت وجود) تنظیم می‌کند.
set Avoid(avoid)	Direction Finder	تنظیم می‌کند که آیا از انواع خاصی از محدودیت‌ها اجتناب شود یا خیر.
set Depart(time)	Direction Finder	زمان دلخواه حرکت را (در صورت لزوم) تنظیم می‌کند.
set Destination(latitude, longitude)	Direction Finder	با استفاده از یک نقطه (lat/lng)، نقطه پایانی را برای محاسبه جهت‌ها تعیین می‌کند.
set Destination(address)	Direction Finder	با استفاده از یک آدرس، نقطه پایانی برای محاسبه مسیرها را تعیین می‌کند.
set Language(language)	Direction Finder	زبانی را که برای دستورالعمل‌ها استفاده می‌شود تنظیم می‌کند.
set Mode(mode)	Direction Finder	حالت سفر را تنظیم می‌کند (پیش‌فرض روی رانندگی است).
set Optimize Waypoints(optimizeOrder)	Direction Finder	تنظیم می‌کند که آیا مسیر ارائه شده با مرتب‌سازی مجدد نقاط مسیر به ترتیب کارآمدتر، بهینه‌سازی شود یا خیر (پیش‌فرض روی false ).
set Origin(latitude, longitude)	Direction Finder	با استفاده از یک نقطه (lat/lng)، نقطه شروع برای محاسبه جهت‌ها را تعیین می‌کند.
set Origin(address)	Direction Finder	با استفاده از یک آدرس، نقطه شروع محاسبه مسیرها را تعیین می‌کند.
set Region(region)	Direction Finder	منطقه‌ای را برای استفاده هنگام تفسیر نام مکان‌ها تنظیم می‌کند.

Direction Finder Enums

خواص

ملک	نوع	توضیحات
Avoid	Avoid
Mode	Mode

Elevation Sampler

روش‌ها

روش	نوع بازگشتی	شرح مختصر
sample Location(latitude, longitude)	Object	داده‌های ارتفاع را برای یک نقطه واحد (عرض/طول) برمی‌گرداند.
sample Locations(points)	Object	داده‌های ارتفاع را برای یک سری از نقاط (عرض/طول) برمی‌گرداند.
sample Locations(encodedPolyline)	Object	داده‌های ارتفاعی را برای نقاط موجود در یک چندخطی کدگذاری شده برمی‌گرداند.
sample Path(points, numSamples)	Object	داده‌های ارتفاع را برای تعدادی از نمونه‌ها در امتداد یک خط، که با استفاده از مجموعه‌ای از نقاط تعریف شده‌اند، برمی‌گرداند.
sample Path(encodedPolyline, numSamples)	Object	داده‌های ارتفاعی را برای تعدادی از نمونه‌ها در امتداد یک خط، که با استفاده از یک چندخطی کدگذاری شده تعریف شده است، برمی‌گرداند.

Format

خواص

ملک	نوع	توضیحات
PNG	Enum	فرمت PNG هشت بیتی.
PNG8	Enum	فرمت PNG هشت بیتی.
PNG32	Enum	فرمت PNG 32 بیتی.
GIF	Enum	فرمت گیف.
JPG	Enum	فرمت JPEG.
JPG_BASELINE	Enum	فرمت JPEG غیر پیشرونده.

Geocoder

روش‌ها

روش	نوع بازگشتی	شرح مختصر
geocode(address)	Object	نقاط جغرافیایی تقریبی را برای یک آدرس مشخص دریافت می‌کند.
reverse Geocode(latitude, longitude)	Object	آدرس‌های تقریبی را برای یک نقطه جغرافیایی مشخص دریافت می‌کند.
set Bounds(swLatitude, swLongitude, neLatitude, neLongitude)	Geocoder	مرزهای ناحیه‌ای را که باید در نتایج اولویت بیشتری داشته باشد، تعیین می‌کند.
set Language(language)	Geocoder	زبانی را که قرار است در نتایج استفاده شود، تنظیم می‌کند.
set Region(region)	Geocoder	منطقه‌ای را برای استفاده هنگام تفسیر نام مکان‌ها تنظیم می‌کند.

Maps

خواص

ملک	نوع	توضیحات
Direction Finder	Direction Finder Enums
Static Map	Static Map Enums

روش‌ها

روش	نوع بازگشتی	شرح مختصر
decode Polyline(polyline)	Number[]	یک رشته چندخطی کدگذاری شده را به آرایه‌ای از نقاط رمزگشایی می‌کند.
encode Polyline(points)	String	آرایه‌ای از نقاط را به صورت یک رشته کدگذاری می‌کند.
new Direction Finder()	Direction Finder	یک شیء جدید DirectionFinder ایجاد می‌کند.
new Elevation Sampler()	Elevation Sampler	یک شیء ElevationSampler ایجاد می‌کند.
new Geocoder()	Geocoder	یک شیء Geocoder جدید ایجاد می‌کند.
new Static Map()	Static Map	یک شیء StaticMap جدید ایجاد می‌کند.
reset Authentication Api Key()	void	اعتبارنامه‌های احراز هویت را برای استفاده از سهمیه‌های پیش‌فرض، بازنشانی می‌کند.
set Authentication By Api Key(apiKey)	void	استفاده از کلید API را برای تأیید اعتبار درخواست‌ها جهت استفاده از سهمیه‌های اضافی فعال می‌کند.
set Authentication By Api Key(apiKey, signingKey)	void	استفاده از کلید API و کلید امضا را برای تأیید اعتبار درخواست‌ها جهت استفاده از سهمیه‌های اضافی در StaticMap فعال می‌کند.

Marker Size

خواص

ملک	نوع	توضیحات
TINY	Enum	بازارهای کوچک (کوچکترین بازارهای موجود).
MID	Enum	ماژیک‌های سایز متوسط ​​(بزرگترین ماژیک‌های موجود).
SMALL	Enum	نشانگرهای کوچک.

Mode

خواص

ملک	نوع	توضیحات
DRIVING	Enum	مسیرهای رانندگی از طریق جاده‌ها.
WALKING	Enum	مسیرهای پیاده‌روی از طریق مسیرهای عابر پیاده و پیاده‌روها (در صورت وجود).
BICYCLING	Enum	مسیرهای دوچرخه‌سواری از طریق مسیرهای دوچرخه‌سواری و خیابان‌های ترجیحی (در صورت وجود).
TRANSIT	Enum	مسیرهای حمل و نقل عمومی (در صورت وجود).

Static Map

روش‌ها

روش	نوع بازگشتی	شرح مختصر
add Address(address)	Static Map	یک آدرس جدید به تعریف مسیر فعلی اضافه می‌کند.
add Marker(latitude, longitude)	Static Map	با استفاده از یک نقطه (عرض/طول) یک نشانگر به نقشه اضافه می‌کند.
add Marker(address)	Static Map	با استفاده از یک آدرس، یک نشانگر به نقشه اضافه می‌کند.
add Path(points)	Static Map	با استفاده از آرایه‌ای از نقاط، مسیری را به نقشه اضافه می‌کند.
add Path(polyline)	Static Map	با استفاده از یک چندخطی کدگذاری شده، مسیری را به نقشه اضافه می‌کند.
add Point(latitude, longitude)	Static Map	یک نقطه جدید (lat/lng) به تعریف مسیر فعلی اضافه می‌کند.
add Visible(latitude, longitude)	Static Map	یک موقعیت نقطه‌ای (عرض/طول) اضافه می‌کند که باید در نقشه قابل مشاهده باشد.
add Visible(address)	Static Map	یک مکان آدرس اضافه می‌کند که باید در نقشه قابل مشاهده باشد.
begin Path()	Static Map	تعریف یک مسیر جدید را آغاز می‌کند.
clear Markers()	Static Map	مجموعه نشانگرهای فعلی را پاک می‌کند.
clear Paths()	Static Map	مجموعه مسیرهای فعلی را پاک کنید.
clear Visibles()	Static Map	مجموعه فعلی مکان‌های قابل مشاهده را پاک می‌کند.
end Path()	Static Map	تعریف مسیری که با beginPath() آغاز شده است را کامل می‌کند.
get As(contentType)	Blob	داده‌های درون این شیء را به صورت یک blob تبدیل‌شده به نوع محتوای مشخص‌شده، برمی‌گرداند.
get Blob()	Blob	داده‌های تصویر را به صورت یک Blob دریافت می‌کند.
get Map Image()	Byte[]	داده‌های خام تصویر را به صورت آرایه‌ای از بایت‌ها دریافت می‌کند.
get Map Url()	String	آدرس اینترنتی (URL) تصویر نقشه را دریافت می‌کند.
set Center(latitude, longitude)	Static Map	مرکز نقشه را با استفاده از یک نقطه (lat/lng) تنظیم می‌کند.
set Center(address)	Static Map	مرکز نقشه را با استفاده از یک آدرس تنظیم می‌کند.
set Custom Marker Style(imageUrl, useShadow)	Static Map	تصویر نشانگر سفارشی را برای استفاده هنگام ایجاد نشانگرهای جدید تنظیم می‌کند.
set Format(format)	Static Map	قالب تصویر نقشه را تنظیم می‌کند.
set Language(language)	Static Map	زبان مورد استفاده برای متن روی نقشه را تنظیم می‌کند (در صورت وجود).
set Map Type(mapType)	Static Map	نوع نقشه‌ای که نمایش داده می‌شود را تعیین می‌کند.
set Marker Style(size, color, label)	Static Map	سبک نشانگر را برای استفاده هنگام ایجاد نشانگرهای جدید تنظیم می‌کند.
set Mobile(useMobileTiles)	Static Map	تنظیم می‌کند که آیا از مجموعه‌های کاشی تخصصی برای دستگاه‌های تلفن همراه استفاده شود یا خیر.
set Path Style(weight, color, fillColor)	Static Map	سبک مسیر مورد استفاده هنگام ایجاد مسیرهای جدید را تنظیم می‌کند.
set Size(width, height)	Static Map	عرض و ارتفاع تصویر نقشه را بر حسب پیکسل تنظیم می‌کند.
set Zoom(zoom)	Static Map	ضریب بزرگنمایی یا سطح بزرگنمایی مورد استفاده برای نقشه را تنظیم می‌کند.

Static Map Enums

خواص

ملک	نوع	توضیحات
Color	Color
Format	Format
Marker Size	Marker Size
Type	Type

Type

خواص

ملک	نوع	توضیحات
ROADMAP	Enum	یک نقشه راه استاندارد، همانطور که معمولاً در وب‌سایت نقشه‌های گوگل نشان داده می‌شود.
SATELLITE	Enum	یک نقشه ماهواره‌ای.
TERRAIN	Enum	نقشه فیزیکی برجسته، که زمین و پوشش گیاهی را نشان می‌دهد.
HYBRID	Enum	ترکیبی از نقشه‌های ماهواره‌ای و نقشه‌های جاده‌ای، که یک لایه شفاف از خیابان‌های اصلی و نام مکان‌ها را روی نقشه ماهواره‌ای نشان می‌دهد.