Konumlar arasındaki yol tariflerinin alınmasını sağlar.
.
Aşağıdaki örnekte, Times Square'den şuraya yol tarifi almak için bu sınıfı nasıl kullanabileceğiniz gösterilmektedir:
İlk olarak Lincoln Center'da duran Central Park, konumları ve yolu harita üzerinde çiziyor,
bir e-posta alırsınız.
// 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 ara nokta ekler. |
clearWaypoints() | DirectionFinder | Geçerli ara nokta grubunu temizler. |
getDirections() | Object | Kalkış, hedef ve ayarlanan diğer seçenekleri kullanarak yol tarifini alır. |
setAlternatives(useAlternatives) | DirectionFinder | Yalnızca en yüksek sıralamaya sahip değil, alternatif rotaların döndürülüp döndürülmeyeceğini belirler rota (varsayılan olarak yanlış değerine ayarlanır). |
setArrive(time) | DirectionFinder | İstenen varış zamanını ayarlar (varsa). |
setAvoid(avoid) | DirectionFinder | Belirli kısıtlama türlerinden kaçınılıp kaçınılmayacağını belirler. |
setDepart(time) | DirectionFinder | İstenen kalkış saatini ayarlar (varsa). |
setDestination(latitude, longitude) | DirectionFinder | Bir nokta (enlem/boylam) kullanarak yol tarifinin hesaplanacağı bitiş konumunu ayarlar. |
setDestination(address) | DirectionFinder | Bir adres kullanılarak yol tarifinin hesaplanacağı bitiş konumunu ayarlar. |
setLanguage(language) | DirectionFinder | Yol tarifleri için kullanılacak dili ayarlar. |
setMode(mode) | DirectionFinder | Ulaşım şeklini ayarlar (varsayılan olarak araba yolculuğuna ayarlanır). |
setOptimizeWaypoints(optimizeOrder) | DirectionFinder | Ara noktaları daha yüksek bir verimli sıra (varsayılan olarak yanlış değerine ayarlanır). |
setOrigin(latitude, longitude) | DirectionFinder | Bir nokta (enlem/boylam) kullanarak yol tariflerinin hesaplanacağı başlangıç konumunu ayarlar. |
setOrigin(address) | DirectionFinder | Bir adres kullanarak yol tarifinin hesaplanacağı başlangıç konumunu ayarlar. |
setRegion(region) | DirectionFinder | Konum adları yorumlanırken kullanılacak bölgeyi belirler. |
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
— Çağrı zincirini kolaylaştıran DirectionFinder nesnesi.
addWaypoint(address)
Bir adres kullanarak rotanın geçmesi gereken bir ara nokta 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
— Çağrı zincirini kolaylaştıran DirectionFinder nesnesi.
clearWaypoints()
Geçerli ara nokta grubunu temizler.
var directionFinder = Maps.newDirectionFinder() // ... // Do something interesting here ... // ... // Remove all waypoints added with addWaypoint(). directionFinder.clearWaypoints();
Return
DirectionFinder
— Çağrı zincirini kolaylaştıran DirectionFinder nesnesi
getDirections()
Kalkış, hedef 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. 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 tariflerine ilişkin rota grubunu içeren bir JSON nesnesi
Aşağıdaki kaynakları da incelemenizi öneririz:
setAlternatives(useAlternatives)
Yalnızca en yüksek sıralamaya sahip değil, alternatif rotaların döndürülüp döndürülmeyeceğini belirler
rota (varsayılan olarak yanlış değerine ayarlanır). True (doğru) ise sonuçta elde edilen nesnenin routes
dizisi
birden fazla giriş içerir.
// 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, aksi takdirde false |
Return
DirectionFinder
— Çağrı zincirini kolaylaştıran DirectionFinder nesnesi
setArrive(time)
İstenen varış zamanını ayarlar (varsa).
// 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
— Çağrı zincirini 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 sabit bir değerdir |
Return
DirectionFinder
— Çağrı zincirini kolaylaştıran DirectionFinder nesnesi
Aşağıdaki kaynakları da incelemenizi öneririz:
setDepart(time)
İstenen kalkış saatini ayarlar (varsa).
// 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
— Çağrı zincirini 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. 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
— Çağrı zincirini kolaylaştıran DirectionFinder nesnesi
setDestination(address)
Bir adres kullanılarak yol tarifinin hesaplanacağı bitiş konumunu ayarlar.
// 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 | bitiş adresi |
Return
DirectionFinder
— Çağrı zincirini 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
— Çağrı zincirini kolaylaştıran DirectionFinder nesnesi
Aşağıdaki kaynakları da incelemenizi öneririz:
setMode(mode)
Ulaşım şeklini ayarlar (varsayılan olarak araba yolculuğuna ayarlanı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 sabit bir değerdir |
Return
DirectionFinder
— Çağrı zincirini kolaylaştıran DirectionFinder nesnesi
Aşağıdaki kaynakları da incelemenizi öneririz:
setOptimizeWaypoints(optimizeOrder)
Ara noktaları daha yüksek bir verimli sıra (varsayılan olarak yanlış değerine ayarlanı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, aksi takdirde false |
Return
DirectionFinder
— Çağrı zincirini 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. 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
— Çağrı zincirini kolaylaştıran DirectionFinder nesnesi
setOrigin(address)
Bir adres kullanarak yol tarifinin hesaplanacağı başlangıç konumunu ayarlar.
// 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
— Çağrı zinciri oluşturmayı kolaylaştıran DirectionFinder örneği
setRegion(region)
Konum adları yorumlanırken kullanılacak bölgeyi ayarlar. Desteklenen bölge kodları Google Haritalar tarafından desteklenen ccTLD'ler. Örneğin, bölge kodu "uk"dur. şununla karşılık gelir: "maps.google.com.tr"
// 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 kodu |
Return
DirectionFinder
— Çağrı zincirini kolaylaştıran DirectionFinder nesnesi