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

Class DirectionFinder

Konumlar arasındaki yol tariflerinin alınmasına olanak tanır.
Aşağıdaki örnekte, Times Square'den Central Park'a giden yol tarifini almak için bu sınıfı nasıl kullanabileceğiniz gösterilmektedir. Bu yol tarifinde, önce Lincoln Center'da durulur, konumlar ve yol bir haritada işaretlenir ve harita bir e-postayla gönderilir.

// 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:

Google Directions API

Yöntemler

Yöntem	Dönüş türü	Kısa açıklama
`addWaypoint(latitude, longitude)`	`DirectionFinder`	Bir nokta (lat/lng) kullanarak rotanın geçmesi gereken bir ara nokta ekler.
`addWaypoint(address)`	`DirectionFinder`	Adres kullanarak rotanın geçmesi gereken bir yol noktası ekler.
`clearWaypoints()`	`DirectionFinder`	Mevcut yol noktası grubunu temizler.
`getDirections()`	`Object`	Başlangıç, varış noktası ve ayarlanan diğer seçenekleri kullanarak yol tarifini alır.
`setAlternatives(useAlternatives)`	`DirectionFinder`	Yalnızca en yüksek puan alan rota yerine alternatif rotaların döndürülüp döndürülmeyeceğini belirler (varsayılan olarak false değerini alır).
`setArrive(time)`	`DirectionFinder`	İstenilen varış saatini belirler (varsa).
`setAvoid(avoid)`	`DirectionFinder`	Belirli türde kısıtlamalardan kaçınılıp kaçınılmayacağını belirler.
`setDepart(time)`	`DirectionFinder`	İstediğiniz kalkış saatini belirler (geçerli olduğunda).
`setDestination(latitude, longitude)`	`DirectionFinder`	Bir nokta (lat/lng) kullanarak yol tarifinin hesaplanacağı bitiş konumunu belirler.
`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 belirler (varsayılan olarak sürüş).
`setOptimizeWaypoints(optimizeOrder)`	`DirectionFinder`	Dönüm noktalarını daha verimli bir sırayla yeniden düzenleyerek sağlanan rotayı optimize edilip edilmeyeceğini belirler (varsayılan olarak yanlıştır).
`setOrigin(latitude, longitude)`	`DirectionFinder`	Bir nokta (lat/lng) kullanarak yol tarifinin hesaplanacağı başlangıç konumunu ayarlar.
`setOrigin(address)`	`DirectionFinder`	Bir adres kullanarak yol tarifinin hesaplanacağı başlangıç konumunu ayarlar.
`setRegion(region)`	`DirectionFinder`	Konum adlarını yorumlarken kullanılacak bölgeyi ayarlar.

Ayrıntılı dokümanlar

`addWaypoint(latitude, longitude)`

Bir nokta (lat/lng) 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

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

Return

DirectionFinder: Aramaların zincirlenmesini kolaylaştırmak için kullanılan DirectionFinder nesnesi.

`addWaypoint(address)`

Adres kullanarak rotanın geçmesi gereken bir yol noktası ekler.

// Creates a DirectionFinder with a wapoint at Lincoln Center.
const 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ırmak için kullanılan DirectionFinder nesnesi.

`clearWaypoints()`

Mevcut yol noktası grubunu temizler.

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

Return

DirectionFinder: Aramaların zincirlenmesini kolaylaştırmak için kullanılan DirectionFinder nesnesi

`getDirections()`

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

// Logs how long it would take 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: Burada açıklandığı gibi, yol tarifi için rota grubunu içeren bir JSON nesnesi

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

Google Directions API

`setAlternatives(useAlternatives)`

Yalnızca en yüksek puan alan rota yerine alternatif rotaların döndürülüp döndürülmeyeceğini belirler (varsayılan olarak false değerini alır). Doğru ise ortaya çıkan nesnenin routes dizisi birden fazla giriş içerebilir.

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

Parametreler

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

Return

DirectionFinder: Aramaların zincirlenmesini kolaylaştırmak için kullanılan DirectionFinder nesnesi

`setArrive(time)`

İstenilen varış saatini belirler (varsa).

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

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

Return

DirectionFinder: Aramaların zincirlenmesini kolaylaştırmak için kullanılan DirectionFinder nesnesi

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

Google Directions API

`setAvoid(avoid)`

Belirli türde kısıtlamalardan 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

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

Return

DirectionFinder: Aramaların zincirlenmesini kolaylaştırmak için kullanılan DirectionFinder nesnesi

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

Google Directions API

`setDepart(time)`

İstediğiniz kalkış saatini belirler (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

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

Return

DirectionFinder: Aramaların zincirlenmesini kolaylaştırmak için kullanılan DirectionFinder nesnesi.

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

Google Directions API

`setDestination(latitude, longitude)`

Bir nokta (lat/lng) kullanarak yol tarifinin hesaplanacağı bitiş konumunu belirler.

// Creates a DirectionFinder with the destination set to Central Park.
const 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ırmak için kullanılan DirectionFinder nesnesi

`setDestination(address)`

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

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

Parametreler

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

Return

DirectionFinder: Aramaların zincirlenmesini kolaylaştırmak için kullanılan 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

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

Return

DirectionFinder: Aramaların zincirlenmesini kolaylaştırmak için kullanılan DirectionFinder nesnesi

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

Google Haritalar API'lerinde Dil Desteği

`setMode(mode)`

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

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

Parametreler

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

Return

DirectionFinder: Aramaların zincirlenmesini kolaylaştırmak için kullanılan DirectionFinder nesnesi

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

Google Directions API

`setOptimizeWaypoints(optimizeOrder)`

Dönüm noktalarını daha verimli bir sırayla yeniden düzenleyerek sağlanan rotayı optimize edilip edilmeyeceğini belirler (varsayılan olarak yanlıştır).

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

Parametreler

Ad	Tür	Açıklama
`optimizeOrder`	`Boolean`	Sırayı optimize etmek için doğru, aksi takdirde yanlış değerini alır.

Return

DirectionFinder: Aramaların zincirlenmesini kolaylaştırmak için kullanılan DirectionFinder nesnesi

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

Google Directions API

`setOrigin(latitude, longitude)`

Bir nokta (lat/lng) kullanarak yol tarifinin 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

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

Return

DirectionFinder: Aramaların zincirlenmesini kolaylaştırmak için kullanılan DirectionFinder nesnesi

`setOrigin(address)`

Bir adres kullanarak yol tarifinin hesaplanacağı 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

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

Return

DirectionFinder: Aramaların zincirlenmesini kolaylaştırmak için kullanılan DirectionFinder örneği

`setRegion(region)`

Konum adlarını yorumlarken kullanılacak bölgeyi 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

Ad	Tür	Açıklama
`region`	`String`	Kullanılacak bölge kodu

Return

DirectionFinder: Aramaların zincirlenmesini kolaylaştırmak için kullanılan DirectionFinder nesnesi

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

Google Directions API