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 ترکیبی از نقشه‌های ماهواره‌ای و نقشه‌های جاده‌ای، که یک لایه شفاف از خیابان‌های اصلی و نام مکان‌ها را روی نقشه ماهواره‌ای نشان می‌دهد.