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