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 | Geçerli 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ı belirler. |
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 şeklini 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
add Waypoint(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
Direction — Çağrıların zincirlenmesini kolaylaştıran DirectionFinder nesnesi.
add Waypoint(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
Direction: Çağrıların zincirlenmesini kolaylaştıran DirectionFinder nesnesi.
clear Waypoints()
Geçerli yol noktaları grubunu temizler.
const directionFinder = Maps.newDirectionFinder(); // ... // Do something interesting here ... // ... // Remove all waypoints added with addWaypoint(). directionFinder.clearWaypoints();
Return
Direction: Çağrıların zincirlenmesini kolaylaştıran DirectionFinder nesnesi.
get Directions()
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:
set Alternatives(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
Direction: Çağrıların zincirlenmesini kolaylaştıran DirectionFinder nesnesi.
set Arrive(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
Direction: Çağrıların zincirlenmesini kolaylaştıran DirectionFinder nesnesi.
Aşağıdaki kaynakları da incelemenizi öneririz:
set Avoid(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
| Ad | Tür | Açıklama |
|---|---|---|
avoid | String | Avoid öğesinden alınan sabit bir değer. |
Return
Direction: Çağrıların zincirlenmesini kolaylaştıran DirectionFinder nesnesi.
Aşağıdaki kaynakları da incelemenizi öneririz:
set Depart(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
Direction: Çağrıların zincirlenmesini kolaylaştıran DirectionFinder nesnesi.
Aşağıdaki kaynakları da incelemenizi öneririz:
set Destination(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
Direction: Çağrıların zincirlenmesini kolaylaştıran DirectionFinder nesnesi.
set Destination(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
Direction: Çağrıların zincirlenmesini kolaylaştıran DirectionFinder nesnesi.
set Language(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
Direction: Çağrıların zincirlenmesini kolaylaştıran DirectionFinder nesnesi.
Aşağıdaki kaynakları da incelemenizi öneririz:
set Mode(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
| Ad | Tür | Açıklama |
|---|---|---|
mode | String | Mode öğesinden alınan sabit bir değer. |
Return
Direction: Çağrıların zincirlenmesini kolaylaştıran DirectionFinder nesnesi.
Aşağıdaki kaynakları da incelemenizi öneririz:
set Optimize Waypoints(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
Direction: Çağrıların zincirlenmesini kolaylaştıran DirectionFinder nesnesi.
Aşağıdaki kaynakları da incelemenizi öneririz:
set Origin(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
Direction: Çağrıların zincirlenmesini kolaylaştıran DirectionFinder nesnesi.
set Origin(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
Direction: Çağrıların zincirlenmesini kolaylaştıran DirectionFinder örneği.
set Region(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
Direction — Çağrıların zincirlenmesini kolaylaştıran DirectionFinder nesnesi.