Bu sayfa, Cloud Translation API ile çevrilmiştir.

Class DirectionFinder

Konumlar arasında yol tariflerinin alınmasını sağlar.
Aşağıdaki örnekte, Times Meydanı'ndan Central Park'a kadar yol tarifi almak, önce Lincoln Center'da durup, konumları ve yolları haritada çizmek ve haritayı bir e-posta ile göndermek için bu sınıfı nasıl kullanabileceğiniz gösterilmektedir.

// Get the directions.
var directions = Maps.newDirectionFinder()
    .setOrigin('Times Square, New York, NY')
    .addWaypoint('Lincoln Center, New York, NY')
    .setDestination('Central Park, New York, NY')
    .setMode(Maps.DirectionFinder.Mode.DRIVING)
    .getDirections();
var route = directions.routes[0];

// Set up marker styles.
var markerSize = Maps.StaticMap.MarkerSize.MID;
var markerColor = Maps.StaticMap.Color.GREEN
var markerLetterCode = 'A'.charCodeAt();

// Add markers to the map.
var map = Maps.newStaticMap();
for (var i = 0; i < route.legs.length; i++) {
  var leg = route.legs[i];
  if (i == 0) {
    // Add a marker for the start location of the first leg only.
    map.setMarkerStyle(markerSize, markerColor, String.fromCharCode(markerLetterCode));
    map.addMarker(leg.start_location.lat, leg.start_location.lng);
    markerLetterCode++;
  }
  map.setMarkerStyle(markerSize, markerColor, String.fromCharCode(markerLetterCode));
  map.addMarker(leg.end_location.lat, leg.end_location.lng);
  markerLetterCode++;
}

// Add a path for the entire route.
map.addPath(route.overview_polyline.points);

// Send the map in an email.
var toAddress = Session.getActiveUser().getEmail();
MailApp.sendEmail(
  toAddress,
  'Directions',
  'Please open: ' + map.getMapUrl() + '&key=YOUR_API_KEY', {
    htmlBody: 'See below.<br/><img src="cid:mapImage">',
    inlineImages: {
      mapImage: Utilities.newBlob(map.getMapImage(), 'image/png')
    }
  }
);

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

Google Directions API'si

Yöntemler

Yöntem	Dönüş türü	Kısa açıklama
`addWaypoint(latitude, longitude)`	`DirectionFinder`	Bir nokta (enlem/boylam) kullanarak rotanın geçmesi gereken bir ara nokta ekler.
`addWaypoint(address)`	`DirectionFinder`	Bir adres kullanarak rotanın geçmesi gereken bir referans noktası ekler.
`clearWaypoints()`	`DirectionFinder`	Mevcut ara nokta grubunu temizler.
`getDirections()`	`Object`	Kalkış noktası, varış noktası ve ayarlanan diğer seçenekleri kullanarak yol tariflerini alır.
`setAlternatives(useAlternatives)`	`DirectionFinder`	Yalnızca en yüksek sıralamaya sahip rota yerine alternatif rotaların döndürülüp döndürülmeyeceğini belirler (varsayılan olarak "false" değerine ayarlanır).
`setArrive(time)`	`DirectionFinder`	İstenen varış saatini ayarlar (geçerli durumlarda).
`setAvoid(avoid)`	`DirectionFinder`	Belirli kısıtlama türlerinden kaçınılıp kaçınılmayacağını belirler.
`setDepart(time)`	`DirectionFinder`	İstediğiniz kalkış saatini ayarlar (geçerli durumlarda).
`setDestination(latitude, longitude)`	`DirectionFinder`	Nokta (enlem/lng) kullanarak yol tarifinin hesaplanacağı bitiş konumunu ayarlar.
`setDestination(address)`	`DirectionFinder`	Bir adres kullanarak, yol tarifinin hesaplanacağı bitiş konumunu belirler.
`setLanguage(language)`	`DirectionFinder`	Yol tarifleri için kullanılacak dili ayarlar.
`setMode(mode)`	`DirectionFinder`	Ulaşım şeklini ayarlar (varsayılan olarak sürüş modundadır).
`setOptimizeWaypoints(optimizeOrder)`	`DirectionFinder`	Ara noktaları daha verimli bir sıraya göre yeniden düzenleyerek rotanın optimize edilip edilmeyeceğini belirler (varsayılan ayar "yanlış"tır).
`setOrigin(latitude, longitude)`	`DirectionFinder`	Bir nokta (enlem/lng) kullanarak yol tarifinin hesaplanacağı başlangıç konumunu belirler.
`setOrigin(address)`	`DirectionFinder`	Yol tarifinin hesaplanacağı başlangıç konumunu bir adres kullanarak belirler.
`setRegion(region)`	`DirectionFinder`	Konum adları yorumlanırken kullanılacak bir bölge ayarlar.

Ayrıntılı belgeler

`addWaypoint(latitude, longitude)`

Bir nokta (enlem/boylam) kullanarak rotanın geçmesi gereken bir ara nokta ekler.

// Creates a DirectionFinder with a wapoint at Lincoln Center.
var directionFinder = Maps.newDirectionFinder().addWaypoint(40.772628, -73.984243);

Parametreler

Ad	Tür	Açıklama
`latitude`	`Number`	Referans noktasının enlemi.
`longitude`	`Number`	Referans noktasının boylamı.

Return

DirectionFinder: Aramaların zincirlenmesini kolaylaştıran DirectionFinder nesnesi.

`addWaypoint(address)`

Bir adres kullanarak rotanın geçmesi gereken bir referans noktası ekler.

// Creates a DirectionFinder with a wapoint at Lincoln Center.
var directionFinder = Maps.newDirectionFinder().addWaypoint('Lincoln Center, New York, NY');

Parametreler

Ad	Tür	Açıklama
`address`	`String`	Adres.

Return

DirectionFinder: Aramaların zincirlenmesini kolaylaştıran DirectionFinder nesnesi.

`clearWaypoints()`

Mevcut ara nokta grubunu temizler.

var directionFinder = Maps.newDirectionFinder()
// ...
// Do something interesting here ...
// ...
// Remove all waypoints added with addWaypoint().
directionFinder.clearWaypoints();

Return

DirectionFinder: Aramaların zincirlenmesini kolaylaştıran DirectionFinder nesnesi

`getDirections()`

Kalkış noktası, varış noktası ve ayarlanan diğer seçenekleri kullanarak yol tariflerini alır.

// Logs how long it would take to walk from Times Square to Central Park.
var directions = Maps.newDirectionFinder()
    .setOrigin('Times Square, New York, NY')
    .setDestination('Central Park, New York, NY')
    .setMode(Maps.DirectionFinder.Mode.WALKING)
    .getDirections();
Logger.log(directions.routes[0].legs[0].duration.text);

Return

Object: Burada açıklandığı gibi, yol tarifleri için rota grubunu içeren bir JSON nesnesidir

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

Google Directions API'si

`setAlternatives(useAlternatives)`

Yalnızca en yüksek sıralamaya sahip rota yerine alternatif rotaların döndürülüp döndürülmeyeceğini belirler (varsayılan olarak "false" değerine ayarlanır). Doğru ise sonuçta ortaya çıkan nesnenin routes dizisi birden fazla giriş içerebilir.

// Creates a DirectionFinder with alernative routes enabled.
var directionFinder = Maps.newDirectionFinder().setAlternatives(true);

Parametreler

Ad	Tür	Açıklama
`useAlternatives`	`Boolean`	Alternatif rotaları döndürmek için true (doğru), aksi takdirde false (doğru)

Return

DirectionFinder: Aramaların zincirlenmesini kolaylaştıran DirectionFinder nesnesi

`setArrive(time)`

İstenen varış saatini ayarlar (geçerli durumlarda).

// Creates a DirectionFinder with an arrival time of 2 hours from now.
var now = new Date();
var arrive = new Date(now.getTime() + (2 * 60 * 60 * 1000));
var directionFinder = Maps.newDirectionFinder().setArrive(arrive);

Parametreler

Ad	Tür	Açıklama
`time`	`Date`	varış saati

Return

DirectionFinder: Aramaların zincirlenmesini kolaylaştıran DirectionFinder nesnesi

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

Google Directions API'si

`setAvoid(avoid)`

Belirli kısıtlama türlerinden kaçınılıp kaçınılmayacağını belirler.

// Creates a DirectionFinder that avoid highways.
var directionFinder = Maps.newDirectionFinder().setAvoid(Maps.DirectionFinder.Avoid.HIGHWAYS);

Parametreler

Ad	Tür	Açıklama
`avoid`	`String`	`Avoid` için sabit bir değer

Return

DirectionFinder: Aramaların zincirlenmesini kolaylaştıran DirectionFinder nesnesi

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

Google Directions API'si

`setDepart(time)`

İstediğiniz kalkış saatini ayarlar (geçerli durumlarda).

// Creates a DirectionFinder with a departure time of 1 hour from now.
var now = new Date();
var depart = new Date(now.getTime() + (1 * 60 * 60 * 1000));
var directionFinder = Maps.newDirectionFinder().setDepart(depart);

Parametreler

Ad	Tür	Açıklama
`time`	`Date`	kalkış saati

Return

DirectionFinder: Aramaların zincirlenmesini kolaylaştıran DirectionFinder nesnesi.

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

Google Directions API'si

`setDestination(latitude, longitude)`

Nokta (enlem/lng) kullanarak yol tarifinin hesaplanacağı bitiş konumunu ayarlar.

// Creates a DirectionFinder with the destination set to Central Park.
var directionFinder = Maps.newDirectionFinder().setDestination(40.777052, -73.975464);

Parametreler

Ad	Tür	Açıklama
`latitude`	`Number`	bitiş konumunun enlemi
`longitude`	`Number`	bitiş konumunun boylamı

Return

DirectionFinder: Aramaların zincirlenmesini kolaylaştıran DirectionFinder nesnesi

`setDestination(address)`

Bir adres kullanarak, yol tarifinin hesaplanacağı bitiş konumunu belirler.

// Creates a DirectionFinder with the destination set to Central Park.
var directionFinder = Maps.newDirectionFinder().setDestination('Central Park, New York, NY');

Parametreler

Ad	Tür	Açıklama
`address`	`String`	son adres

Return

DirectionFinder: Aramaların zincirlenmesini kolaylaştıran DirectionFinder nesnesi

`setLanguage(language)`

Yol tarifleri için kullanılacak dili ayarlar.

// Creates a DirectionFinder with the language set to French.
var directionFinder = Maps.newDirectionFinder().setLanguage('fr');

Parametreler

Ad	Tür	Açıklama
`language`	`String`	BCP-47 dil tanımlayıcısı

Return

DirectionFinder: Aramaların zincirlenmesini kolaylaştıran DirectionFinder nesnesi

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

Google Haritalar API'lerinde Dil Desteği

`setMode(mode)`

Ulaşım şeklini ayarlar (varsayılan olarak sürüş modundadır).

// Creates a DirectionFinder with the mode set to walking.
var directionFinder = Maps.newDirectionFinder().setMode(Maps.DirectionFinder.Mode.WALKING);

Parametreler

Ad	Tür	Açıklama
`mode`	`String`	`Mode` için sabit bir değer

Return

DirectionFinder: Aramaların zincirlenmesini kolaylaştıran DirectionFinder nesnesi

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

Google Directions API'si

`setOptimizeWaypoints(optimizeOrder)`

Ara noktaları daha verimli bir sıraya göre yeniden düzenleyerek rotanın optimize edilip edilmeyeceğini belirler (varsayılan ayar "yanlış"tır).

// Creates a DirectionFinder with wapoint optimization enabled.
var directionFinder = Maps.newDirectionFinder().setOptimizeWaypoints(true);

Parametreler

Ad	Tür	Açıklama
`optimizeOrder`	`Boolean`	sırayı optimize etmek için true (doğru), aksi takdirde false (yanlış)

Return

DirectionFinder: Aramaların zincirlenmesini kolaylaştıran DirectionFinder nesnesi

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

Google Directions API'si

`setOrigin(latitude, longitude)`

Bir nokta (enlem/lng) kullanarak yol tarifinin hesaplanacağı başlangıç konumunu belirler.

// Creates a DirectionFinder with the origin set to Times Square.
var directionFinder = Maps.newDirectionFinder().setOrigin(40.759011, -73.984472);

Parametreler

Ad	Tür	Açıklama
`latitude`	`Number`	başlangıç konumunun enlemi
`longitude`	`Number`	başlangıç konumunun boylamı

Return

DirectionFinder: Aramaların zincirlenmesini kolaylaştıran DirectionFinder nesnesi

`setOrigin(address)`

Yol tarifinin hesaplanacağı başlangıç konumunu bir adres kullanarak belirler.

// Creates a DirectionFinder with the origin set to Times Square.
var directionFinder = Maps.newDirectionFinder().setOrigin('Times Square, New York, NY');

Parametreler

Ad	Tür	Açıklama
`address`	`String`	başlangıç adresi

Return

DirectionFinder: Arama zincirini kolaylaştıran DirectionFinder örneği

`setRegion(region)`

Konum adları yorumlanırken kullanılacak bir bölge ayarlar. Desteklenen bölge kodları, Google Haritalar tarafından desteklenen ccTLD'lere karşılık gelir. Örneğin, bölge kodu "uk", "maps.google.co.uk" adresine karşılık gelir.

// Creates a DirectionFinder with the region set to France.
var directionFinder = Maps.newDirectionFinder().setRegion('fr');

Parametreler

Ad	Tür	Açıklama
`region`	`String`	kullanılacak bölge kodunu

Return

DirectionFinder: Aramaların zincirlenmesini kolaylaştıran DirectionFinder nesnesi

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

Google Directions API'si