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öntem | Dönüş türü | Kısa açıklama |
|---|---|---|
add | Direction | Bir nokta (enlem/boylam) kullanarak rotanın geçmesi gereken bir ara nokta ekler. |
add | Direction | Adres kullanarak rotanın geçmesi gereken bir ara nokta ekler. |
clear | Direction | Mevcut yol noktaları grubunu temizler. |
get | Object | Başlangıç, hedef ve ayarlanan diğer seçenekleri kullanarak yol tarifi alır. |
set | Direction | En yüksek puanlı rota yerine alternatif rotaların döndürülüp döndürülmeyeceğini ayarlar (varsayılan olarak false). |
set | Direction | İstenen varış zamanını ayarlar (geçerli olduğunda). |
set | Direction | Belirli kısıtlama türlerinden kaçınılıp kaçınılmayacağını ayarlar. |
set | Direction | İstenen kalkış saatini ayarlar (geçerli olduğunda). |
set | Direction | Bir nokta (enlem/boylam) kullanarak yol tarifinin hesaplanacağı bitiş konumunu ayarlar. |
set | Direction | Bir adres kullanarak yol tarifinin hesaplanacağı bitiş konumunu ayarlar. |
set | Direction | Yol tarifleri için kullanılacak dili ayarlar. |
set | Direction | Ulaşım modunu ayarlar (varsayılan olarak araba kullanılır). |
set | Direction | 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). |
set | Direction | Bir nokta (enlem/boylam) kullanarak yol tariflerinin hesaplanacağı başlangıç konumunu ayarlar. |
set | Direction | Bir adres kullanarak yol tariflerini hesaplamak için başlangıç konumunu ayarlar. |
set | Direction | Konum 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
| Ad | Tür | Açıklama |
|---|---|---|
latitude | Number | Ara noktanın enlemi. |
longitude | Number | Ara 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
| Ad | Tür | Açıklama |
|---|---|---|
address | String | Adres |
Return
DirectionFinder: Çağrıların zincirlenmesini kolaylaştıran DirectionFinder nesnesi.
clearWaypoints()
Mevcut 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ıç, 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
| Ad | Tür | Açıklama |
|---|---|---|
use | Boolean | Alternatif 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
| Ad | Tür | Açıklama |
|---|---|---|
time | Date | Varış 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ı ayarlar.
// Creates a DirectionFinder that avoid highways. const directionFinder = Maps.newDirectionFinder().setAvoid( Maps.DirectionFinder.Avoid.HIGHWAYS, );
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
avoid | String | Avoid öğ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
| Ad | Tür | Açıklama |
|---|---|---|
time | Date | Kalkış 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
| Ad | Tür | Açıklama |
|---|---|---|
latitude | Number | Bitiş konumunun enlemi. |
longitude | Number | Bitiş 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
| Ad | Tür | Açıklama |
|---|---|---|
address | String | Bitiş 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
| Ad | Tür | Açıklama |
|---|---|---|
language | String | BCP-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 modunu 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
| Ad | Tür | Açıklama |
|---|---|---|
mode | String | Mode öğ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
| Ad | Tür | Açıklama |
|---|---|---|
optimize | Boolean | true 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
| Ad | Tür | Açıklama |
|---|---|---|
latitude | Number | Başlangıç konumunun enlemi. |
longitude | Number | Baş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
| Ad | Tür | Açıklama |
|---|---|---|
address | String | Baş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
| Ad | Tür | Açıklama |
|---|---|---|
region | String | Kullanılacak bölge kodu. |
Return
DirectionFinder: Çağrıların zincirlenmesini kolaylaştıran DirectionFinder nesnesi.