Class DirectionFinder

YönBulucu

Konumlar arasındaki yol tariflerinin alınmasına izin verir.
Aşağıdaki örnekte, bu sınıfı kullanarak Times Square'den Central Park'a giderken önce Lincoln Center'da durup yol tarifi almanın, konumları ve rotayı haritada işaretlemenin ve haritayı e-postayla göndermenin nasıl yapılacağı gösterilmektedir.

// Get the directions.
const 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();
const route = directions.routes[0];

// Set up marker styles.

let markerLetterCode = 'A'.charCodeAt();

// Add markers to the map.
const map = Maps.newStaticMap();
for (let i = 0; i < route.legs.length; i++) {
  const leg = route.legs[i];
  if (i === 0) {
    // Add a marker for the start location of the first leg only.
    map.setMarkerStyle(
        Maps.StaticMap.MarkerSize.MID,
        Maps.StaticMap.Color.GREEN,
        String.fromCharCode(markerLetterCode),
    );
    map.addMarker(leg.start_location.lat, leg.start_location.lng);
    markerLetterCode++;
  }
  map.setMarkerStyle(
      Maps.StaticMap.MarkerSize.MID,
      Maps.StaticMap.Color.GREEN,
      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.
const 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:

Yöntemler

YöntemDönüş türüKısa açıklama
addWaypoint(latitude, longitude)DirectionFinderBir nokta (enlem/boylam) kullanarak rotanın geçmesi gereken bir ara nokta ekler.
addWaypoint(address)DirectionFinderAdres kullanarak rotanın geçmesi gereken bir ara nokta ekler.
clearWaypoints()DirectionFinderGeçerli yol noktaları grubunu temizler.
getDirections()ObjectBaşlangıç, hedef ve ayarlanan diğer seçenekleri kullanarak yol tarifi alır.
setAlternatives(useAlternatives)DirectionFinderEn yüksek puanlı rota yerine alternatif rotaların döndürülüp döndürülmeyeceğini ayarlar (varsayılan olarak false).
setArrive(time)DirectionFinderİstenen varış zamanını ayarlar (geçerli olduğunda).
setAvoid(avoid)DirectionFinderBelirli kısıtlama türlerinden kaçınılıp kaçınılmayacağını belirler.
setDepart(time)DirectionFinderİstenen kalkış saatini ayarlar (geçerli olduğunda).
setDestination(latitude, longitude)DirectionFinderBir nokta (enlem/boylam) kullanarak yol tarifinin hesaplanacağı bitiş konumunu ayarlar.
setDestination(address)DirectionFinderBir adres kullanarak yol tarifinin hesaplanacağı bitiş konumunu ayarlar.
setLanguage(language)DirectionFinderYol tarifleri için kullanılacak dili ayarlar.
setMode(mode)DirectionFinderUlaşım şeklini ayarlar (varsayılan olarak araba kullanılır).
setOptimizeWaypoints(optimizeOrder)DirectionFinderSağlanan rotanın, ara noktaları daha verimli bir sırayla yeniden düzenleyerek optimize edilip edilmeyeceğini belirler (varsayılan olarak false'dır).
setOrigin(latitude, longitude)DirectionFinderBir nokta (enlem/boylam) kullanarak yol tariflerinin hesaplanacağı başlangıç konumunu ayarlar.
setOrigin(address)DirectionFinderBir adres kullanarak yol tariflerini hesaplamak için başlangıç konumunu ayarlar.
setRegion(region)DirectionFinderKonum adlarını yorumlarken 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.
const directionFinder = Maps.newDirectionFinder().addWaypoint(
    40.772628,
    -73.984243,
);

Parametreler

AdTürAçıklama
latitudeNumberAra noktanın enlemi.
longitudeNumberAra noktanın boylamı.

Return

DirectionFinder — Çağrıların zincirlenmesini kolaylaştıran DirectionFinder nesnesi.


addWaypoint(address)

Adres kullanarak rotanın geçmesi gereken bir ara nokta ekler.

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

Parametreler

AdTürAçıklama
addressStringAdres

Return

DirectionFinder: Çağrıların zincirlenmesini kolaylaştıran DirectionFinder nesnesi.


clearWaypoints()

Geçerli yol noktaları grubunu temizler.

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

Return

DirectionFinder: Çağrıların zincirlenmesini kolaylaştıran DirectionFinder nesnesi.


getDirections()

Başlangıç noktası, hedef ve ayarlanan diğer seçenekleri kullanarak yol tarifi alır.

// Logs how long it takes to walk from Times Square to Central Park.
const 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: Yol tarifleri için rota kümesini içeren bir JSON nesnesi. Burada açıklandığı gibidir.

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


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 ayarlar (varsayılan olarak false). true ise sonuçta elde edilen nesnenin routes dizisi birden fazla giriş içerebilir.

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

Parametreler

AdTürAçıklama
useAlternativesBooleanAlternatif rotaları döndürmek için true, aksi takdirde false.

Return

DirectionFinder: Çağrıların zincirlenmesini kolaylaştıran DirectionFinder nesnesi.


setArrive(time)

İstenen varış zamanını ayarlar (geçerli olduğunda).

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

Parametreler

AdTürAçıklama
timeDateVarış saati.

Return

DirectionFinder: Çağrıların zincirlenmesini kolaylaştıran DirectionFinder nesnesi.

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


setAvoid(avoid)

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

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

Parametreler

AdTürAçıklama
avoidStringAvoid öğesinden alınan sabit bir değer.

Return

DirectionFinder: Çağrıların zincirlenmesini kolaylaştıran DirectionFinder nesnesi.

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


setDepart(time)

İstenen kalkış saatini ayarlar (geçerli olduğunda).

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

Parametreler

AdTürAçıklama
timeDateKalkış saati.

Return

DirectionFinder: Çağrıların zincirlenmesini kolaylaştıran DirectionFinder nesnesi.

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


setDestination(latitude, longitude)

Bir nokta (enlem/boylam) kullanarak yol tarifinin hesaplanacağı bitiş konumunu ayarlar.

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

Parametreler

AdTürAçıklama
latitudeNumberBitiş konumunun enlemi.
longitudeNumberBitiş konumunun boylamı.

Return

DirectionFinder: Çağrıların zincirlenmesini kolaylaştıran DirectionFinder nesnesi.


setDestination(address)

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

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

Parametreler

AdTürAçıklama
addressStringBitiş adresi.

Return

DirectionFinder: Çağrıları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.
const directionFinder = Maps.newDirectionFinder().setLanguage('fr');

Parametreler

AdTürAçıklama
languageStringBCP-47 dil tanımlayıcısı.

Return

DirectionFinder: Çağrıların zincirlenmesini kolaylaştıran DirectionFinder nesnesi.

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


setMode(mode)

Ulaşım şeklini ayarlar (varsayılan olarak araba kullanılır).

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

Parametreler

AdTürAçıklama
modeStringMode öğesinden alınan sabit bir değer.

Return

DirectionFinder: Çağrıların zincirlenmesini kolaylaştıran DirectionFinder nesnesi.

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


setOptimizeWaypoints(optimizeOrder)

Sağlanan rotanın, ara noktaları daha verimli bir sırayla yeniden düzenleyerek optimize edilip edilmeyeceğini belirler (varsayılan olarak false'dır).

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

Parametreler

AdTürAçıklama
optimizeOrderBooleantrue siparişi optimize etmek için false başka bir şekilde.

Return

DirectionFinder: Çağrıların zincirlenmesini kolaylaştıran DirectionFinder nesnesi.

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


setOrigin(latitude, longitude)

Bir nokta (enlem/boylam) kullanarak yol tariflerinin hesaplanacağı başlangıç konumunu ayarlar.

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

Parametreler

AdTürAçıklama
latitudeNumberBaşlangıç konumunun enlemi.
longitudeNumberBaşlangıç konumunun boylamı.

Return

DirectionFinder: Çağrıların zincirlenmesini kolaylaştıran DirectionFinder nesnesi.


setOrigin(address)

Bir adres kullanarak yol tariflerini hesaplamak için başlangıç konumunu ayarlar.

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

Parametreler

AdTürAçıklama
addressStringBaşlangıç adresi.

Return

DirectionFinder: Çağrıların zincirlenmesini kolaylaştıran DirectionFinder örneği.


setRegion(region)

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

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

Parametreler

AdTürAçıklama
regionStringKullanılacak bölge kodu.

Return

DirectionFinder — Çağrıların zincirlenmesini kolaylaştıran DirectionFinder nesnesi.

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