Class Maps

Haritalar

Yön bulma, coğrafi kodlama, rakım örnekleme ve statik harita görüntüleri oluşturma sağlar.

Özellikler

MülkTürAçıklama
DirectionFinderDirectionFinderEnums
StaticMapStaticMapEnums

Yöntemler

YöntemDönüş türüKısa açıklama
decodePolyline(polyline)Number[]Kodlanmış bir çoklu çizgi dizesini tekrar bir nokta dizisine dönüştürür.
encodePolyline(points)StringBir nokta dizisini dize olarak kodlar.
newDirectionFinder()DirectionFinderYeni bir DirectionFinder nesnesi oluşturur.
newElevationSampler()ElevationSamplerElevationSampler nesnesi oluşturur.
newGeocoder()GeocoderYeni bir Geocoder nesnesi oluşturur.
newStaticMap()StaticMapYeni bir StaticMap nesnesi oluşturur.
resetAuthenticationApiKey()voidVarsayılan kota izinlerini kullanmak için kimlik doğrulama bilgilerini sıfırlar.
setAuthenticationByApiKey(apiKey)voidEk kotalardan yararlanmak için isteklerin kimliğini doğrulamak üzere API anahtarının kullanılmasını sağlar.
setAuthenticationByApiKey(apiKey, signingKey)voidStaticMap'teki ek kotalardan yararlanmak için isteklerin kimliğini doğrulamak üzere API anahtarı ve imzalama anahtarı kullanımını sağlar.

Ayrıntılı belgeler

decodePolyline(polyline)

Kodlanmış bir çoklu çizgi dizesini tekrar bir nokta dizisine dönüştürür. 

// 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]);
}

Parametreler

AdTürAçıklama
polylineStringÇözülecek kodlanmış bir çoklu çizgi.

Return

Number[]: Enlem-boylam çiftleri dizisi (lat0, long0, lat1, long1, ...).

Aşağıdaki kaynakları da incelemenizi öneririz:

encodePolyline(points)

Bir nokta dizisini dize olarak kodlar. 

// 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);

Parametreler

AdTürAçıklama
pointsNumber[]Kodlanacak enlem/boylam çiftleri dizisi.

Return

String: Bu noktaları temsil eden kodlanmış bir dize.

Aşağıdaki kaynakları da incelemenizi öneririz:

newDirectionFinder()

Yeni bir DirectionFinder nesnesi oluşturur.

Return

DirectionFinder: Yeni bir yön bulucu nesnesi.

newElevationSampler()

ElevationSampler nesnesi oluşturur.

Return

ElevationSampler: Yeni bir yükseklik örnekleyici nesnesi.

newGeocoder()

Yeni bir Geocoder nesnesi oluşturur.

Return

Geocoder: Yeni bir coğrafi kod çözücü nesnesi.

newStaticMap()

Yeni bir StaticMap nesnesi oluşturur.

Return

StaticMap: Yeni bir statik harita nesnesi.

resetAuthenticationApiKey()

Varsayılan kota izinlerini kullanmak için kimlik doğrulama bilgilerini sıfırlar. Bu yöntem, isteklerin kimliğini doğrulamak için API anahtarı kullandığınızda işe yarar. Bu yöntem, kimlik doğrulama bilgileri sağlamadan Maps yöntemlerini kullanmak istediğinizde varsayılan kota izinlerine geri dönmek için kullanılabilir. 

Maps.resetAuthenticationApiKey();

Verdiği hatalar

Error: setAuthentication(clientId, signingKey) kimlik doğrulama için kullanılıyorsa.

setAuthenticationByApiKey(apiKey)

Ek kotalardan yararlanmak için isteklerin kimliğini doğrulamak üzere API anahtarının kullanılmasını sağlar.

Bu yöntem, isteklerin kimliğini doğrulamak için kullanılan bir API anahtarı ayarlamak üzere kullanılır. Bu yöntem çağrıldığında kota tüketimi ve faturalandırma, fiyatlandırma sayfasında belirtildiği şekilde, sağlanan API anahtarıyla ilişkili Google Cloud projesine yansıtılır. Kimlik doğrulama bilgileri sağlamadan varsayılan kota izinleriyle Maps yöntemlerini kullanabilirsiniz. StaticMap kullanıyorsanız lütfen bunun yerine setAuthenticationByApiKey(apiKey, signingKey) yöntemini kullanın. 

Maps.setAuthenticationByApiKey('BBdgJpSbLtAtmkBFjgLt310qT6iekggfDdVqLC0');

Parametreler

AdTürAçıklama
apiKeyStringHızlı başlangıç kılavuzunda belirtilen adımları uygulayarak Google Cloud Console'dan alınabilen bir API anahtarı.

Verdiği hatalar

Error: apiKey, null ise veya setAuthentication(clientId, signingKey) kimlik doğrulama için zaten kullanılıyorsa

setAuthenticationByApiKey(apiKey, signingKey)

StaticMap'teki ek kotalardan yararlanmak için isteklerin kimliğini doğrulamak üzere API anahtarı ve imzalama anahtarı kullanımını sağlar. signingKey, Static Map API'ye yapılan istekler için zorunlu olsa da bu yöntem, diğer Haritalar hizmetlerinin kimliğini doğrulamak için de kullanılabilir. Bu durumlarda signingKey parametresi yoksayılır.

Bu yöntem, isteklerin kimliğini doğrulamak için kullanılan bir API anahtarı ve imzalama anahtarı ayarlamak için kullanılır. StaticMap için imza anahtarı gerekir. Test amacıyla imza olmadan az sayıda istek kabul eder ancak üretimde eşiğe ulaşıldığında bu istekler başarısız olmaya başlar. Daha fazla ayrıntıyı burada bulabilirsiniz. 

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

Parametreler

AdTürAçıklama
apiKeyStringHızlı başlangıç kılavuzunda belirtilen adımları uygulayarak Google Cloud Console'dan alınabilen bir API anahtarı.
signingKeyStringDijital imza kılavuzunda belirtilen adımları uygulayarak Google Cloud Console'dan alınabilen bir imzalama anahtarı. Bu parametre, StaticMap için gereklidir ve diğer Haritalar hizmetlerinde yoksayılır.

Verdiği hatalar

Error: apiKey, null ise veya setAuthentication(clientId, signingKey) kimlik doğrulama için zaten kullanılıyorsa

Aşağıdaki kaynakları da incelemenizi öneririz:

Kullanımdan kaldırılan yöntemler