Class 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 فعال می‌کند.

مستندات دقیق

decodePolyline(polyline)

یک رشته چندخطی کدگذاری شده را به آرایه‌ای از نقاط رمزگشایی می‌کند.

// Decodes a string representation of the latitudes and longitudes of
// Minneapolis and Milwaukee respectively.
const polyline = 'qvkpG`qhxPbgyI_zq_@';
const points = Maps.decodePolyline(polyline);
for (let i = 0; i < points.length; i += 2) {
  Logger.log('%s, %s', points[i], points[i + 1]);
}

پارامترها

نام نوع توضیحات
polyline String یک چندخطی کدگذاری شده برای رمزگشایی.

بازگشت

Number[] — آرایه‌ای از جفت‌های طول و عرض جغرافیایی (lat0، long0، lat1، long1، ...).

همچنین ببینید

encodePolyline(points)

آرایه‌ای از نقاط را به صورت یک رشته کدگذاری می‌کند.

// The latitudes and longitudes of New York and Boston respectively.
const points = [40.77, -73.97, 42.34, -71.04];
const polyline = Maps.encodePolyline(points);

پارامترها

نام نوع توضیحات
points Number[] آرایه‌ای از جفت‌های طول و عرض جغرافیایی برای رمزگذاری.

بازگشت

String - یک رشته کدگذاری شده که آن نقاط را نشان می‌دهد.

همچنین ببینید

newDirectionFinder()

یک شیء جدید DirectionFinder ایجاد می‌کند.

بازگشت

DirectionFinder — یک شیء جدید یابنده جهت.

newElevationSampler()

یک شیء ElevationSampler ایجاد می‌کند.

بازگشت

ElevationSampler - یک شیء نمونه‌بردار ارتفاعی جدید.

newGeocoder()

یک شیء Geocoder جدید ایجاد می‌کند.

بازگشت

Geocoder - یک شیء ژئوکودر جدید.

newStaticMap()

یک شیء StaticMap جدید ایجاد می‌کند.

بازگشت

StaticMap - یک شیء نقشه استاتیک جدید.

resetAuthenticationApiKey()

اعتبارنامه‌های احراز هویت را برای استفاده از سهمیه‌های پیش‌فرض بازنشانی می‌کند. این روش زمانی کار می‌کند که از کلید API برای احراز هویت درخواست‌ها استفاده می‌کنید. اگر می‌خواهید از متدهای Maps بدون ارائه اعتبارنامه‌های احراز هویت استفاده کنید، می‌توانید از این روش برای بازگشت به سهمیه‌های پیش‌فرض استفاده کنید.

Maps.resetAuthenticationApiKey();

پرتاب‌ها

Error — اگر setAuthentication(clientId, signingKey) برای احراز هویت استفاده شود.

setAuthenticationByApiKey(apiKey)

استفاده از کلید API را برای تأیید اعتبار درخواست‌ها جهت استفاده از سهمیه‌های اضافی فعال می‌کند.

این متد برای تنظیم یک کلید API استفاده می‌شود که برای احراز هویت درخواست‌ها استفاده می‌شود. وقتی این متد فراخوانی می‌شود، سهمیه مصرف و هزینه از پروژه Google Cloud مرتبط با کلید API ارائه شده طبق برگه قیمت‌گذاری محاسبه می‌شود. شما می‌توانید از متدهای Maps با سهمیه‌های پیش‌فرض و بدون ارائه اعتبارنامه احراز هویت استفاده کنید. اگر از StaticMap استفاده می‌کنید، لطفاً به جای آن از متد setAuthenticationByApiKey(apiKey, signingKey) استفاده کنید.

Maps.setAuthenticationByApiKey('BBdgJpSbLtAtmkBFjgLt310qT6iekggfDdVqLC0');

پارامترها

نام نوع توضیحات
api Key String یک کلید API که می‌توان آن را از کنسول ابری گوگل با دنبال کردن مراحل ذکر شده در راهنمای شروع سریع دریافت کرد.

پرتاب‌ها

Error — اگر apiKey null باشد، یا اگر setAuthentication(clientId, signingKey) از قبل برای احراز هویت استفاده شده باشد

setAuthenticationByApiKey(apiKey, signingKey)

استفاده از کلید API و کلید امضا را برای تأیید اعتبار درخواست‌ها جهت استفاده از سهمیه‌های اضافی در StaticMap فعال می‌کند. در حالی که signingKey برای درخواست‌ها به Static Map API مورد نیاز است، این روش می‌تواند برای تأیید اعتبار سایر سرویس‌های Maps نیز استفاده شود. در این موارد، پارامتر signingKey نادیده گرفته می‌شود.

این متد برای تنظیم یک کلید API و کلید امضا استفاده می‌شود که برای احراز هویت درخواست‌ها استفاده می‌شود. کلید امضا برای StaticMap مورد نیاز است، این متد تعداد کمی از درخواست‌های بدون امضا را برای اهداف آزمایشی می‌پذیرد، اما به محض اینکه در محیط عملیاتی شما به آستانه‌ی امضا برسد، درخواست‌ها شروع به شکست می‌کنند. جزئیات بیشتر را می‌توانید اینجا بیابید.

Maps.setAuthenticationByApiKey('BBdgJpSbLtAtmkBFjgLt310qT6iekggfDdVqLC0',
'7_pry-Skg0PKxds-7nvdl91mB5=');

پارامترها

نام نوع توضیحات
api Key String یک کلید API که می‌توان آن را از کنسول ابری گوگل با دنبال کردن مراحل ذکر شده در راهنمای شروع سریع دریافت کرد.
signing Key String یک کلید امضا که می‌توان آن را از کنسول ابری گوگل با دنبال کردن مراحل ذکر شده در راهنمای امضای دیجیتال دریافت کرد. این کلید برای StaticMap مورد نیاز است و برای سایر سرویس‌های نقشه نادیده گرفته می‌شود.

پرتاب‌ها

Error — اگر apiKey null باشد، یا اگر setAuthentication(clientId, signingKey) از قبل برای احراز هویت استفاده شده باشد

همچنین ببینید

متدهای منسوخ شده