Ta strona została przetłumaczona przez Cloud Translation API.

Class DirectionFinder

Umożliwia pobieranie wskazówek dojazdu między lokalizacjami.
Poniższy przykład pokazuje, jak za pomocą tych zajęć uzyskać trasę z Times Square do Central Parku, zatrzymać się najpierw w Lincoln Center, zaznaczyć lokalizacje i trasę na mapie oraz wysłać ją w e-mailu.

// 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')
    }
  }
);

Zobacz też

Interfejs Google Directions API

Metody

Metoda	Zwracany typ	Krótki opis
`addWaypoint(latitude, longitude)`	`DirectionFinder`	Dodaje punkt pośredni, przez który musi przejść trasa, przy użyciu punktu (długości i szerokości geograficznej).
`addWaypoint(address)`	`DirectionFinder`	Dodaje punkt pośredni, przez który musi przejść trasa, używając adresu.
`clearWaypoints()`	`DirectionFinder`	Usuwa bieżący zestaw punktów na trasie.
`getDirections()`	`Object`	Pobiera wskazówki dojazdu, korzystając z miejsca wylotu, celu podróży i innych ustawionych opcji.
`setAlternatives(useAlternatives)`	`DirectionFinder`	Określa, czy mają być zwracane trasy alternatywne, a nie tylko trasa o najwyższej pozycji (wartość domyślna to fałsz).
`setArrive(time)`	`DirectionFinder`	Ustawienie żądanej godziny przyjazdu (w stosownych przypadkach).
`setAvoid(avoid)`	`DirectionFinder`	Określa, czy należy unikać określonych typów ograniczeń.
`setDepart(time)`	`DirectionFinder`	Ustawia godzinę odjazdu (w stosownych przypadkach).
`setDestination(latitude, longitude)`	`DirectionFinder`	Umożliwia ustawienie końcowej lokalizacji, do której należy wyznaczać trasę, za pomocą punktu (szerokość/długość).
`setDestination(address)`	`DirectionFinder`	Umożliwia ustawienie na podstawie adresu lokalizacji końcowej, do której należy wyznaczać trasę dojazdu.
`setLanguage(language)`	`DirectionFinder`	Ustawia język, który będzie używany we wskazówkach.
`setMode(mode)`	`DirectionFinder`	Ustawienie środka transportu (domyślnie jest to samochód).
`setOptimizeWaypoints(optimizeOrder)`	`DirectionFinder`	Określa, czy należy optymalizować wskazaną trasę przez zmianę kolejności punktów na trasie w efektywniejszy sposób (wartość domyślna to fałsz).
`setOrigin(latitude, longitude)`	`DirectionFinder`	Określa lokalizację początkową, z której należy wyznaczać trasę na podstawie punktu (szerokość/długość).
`setOrigin(address)`	`DirectionFinder`	Określa lokalizację początkową na podstawie adresu, z której chcesz wytyczyć trasę.
`setRegion(region)`	`DirectionFinder`	Określa region, który ma być używany podczas interpretowania nazw lokalizacji.

Szczegółowa dokumentacja

`addWaypoint(latitude, longitude)`

Dodaje punkt pośredni, przez który musi przejść trasa, przy użyciu punktu (długości i szerokości geograficznej).

// Creates a DirectionFinder with a wapoint at Lincoln Center.
var directionFinder = Maps.newDirectionFinder().addWaypoint(40.772628, -73.984243);

Parametry

Nazwa	Typ	Opis
`latitude`	`Number`	Szerokość geograficzna punktu na trasie.
`longitude`	`Number`	Długość geograficzna punktu pośredniego.

Powroty

DirectionFinder – obiekt DirectionFinder, który ułatwia łańcuch wywołań.

`addWaypoint(address)`

Dodaje punkt pośredni, przez który musi przejść trasa, używając adresu.

// Creates a DirectionFinder with a wapoint at Lincoln Center.
var directionFinder = Maps.newDirectionFinder().addWaypoint('Lincoln Center, New York, NY');

Parametry

Nazwa	Typ	Opis
`address`	`String`	Adres.

Powroty

DirectionFinder – obiekt DirectionFinder, który ułatwia łańcuch wywołań.

`clearWaypoints()`

Usuwa bieżący zestaw punktów na trasie.

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

Powroty

DirectionFinder – obiekt DirectionFinder, który ułatwia łańcuch wywołań

`getDirections()`

Pobiera wskazówki dojazdu, korzystając z miejsca wylotu, celu podróży i innych ustawionych opcji.

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

Powroty

Object – obiekt JSON zawierający zbiór tras wskazówek dojazdu, zgodnie z tym opisem

Zobacz też

Interfejs Google Directions API

`setAlternatives(useAlternatives)`

Określa, czy mają być zwracane trasy alternatywne, a nie tylko trasa o najwyższej pozycji (wartość domyślna to fałsz). Jeśli ma wartość prawda, tablica routes obiektu wynikowego może zawierać wiele wpisów.

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

Parametry

Nazwa	Typ	Opis
`useAlternatives`	`Boolean`	„true” (prawda), aby zwrócić alternatywne trasy; w przeciwnym razie „false” (fałsz)

Powroty

DirectionFinder – obiekt DirectionFinder, który ułatwia łańcuch wywołań

`setArrive(time)`

Ustawienie żądanej godziny przyjazdu (w stosownych przypadkach).

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

Parametry

Nazwa	Typ	Opis
`time`	`Date`	godzina przybycia

Powroty

DirectionFinder – obiekt DirectionFinder, który ułatwia łańcuch wywołań

Zobacz też

Interfejs Google Directions API

`setAvoid(avoid)`

Określa, czy należy unikać określonych typów ograniczeń.

// Creates a DirectionFinder that avoid highways.
var directionFinder = Maps.newDirectionFinder().setAvoid(Maps.DirectionFinder.Avoid.HIGHWAYS);

Parametry

Nazwa	Typ	Opis
`avoid`	`String`	stała wartość z `Avoid`

Powroty

DirectionFinder – obiekt DirectionFinder, który ułatwia łańcuch wywołań

Zobacz też

Interfejs Google Directions API

`setDepart(time)`

Ustawia godzinę odjazdu (w stosownych przypadkach).

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

Parametry

Nazwa	Typ	Opis
`time`	`Date`	godzina wyjazdu

Powroty

DirectionFinder – obiekt DirectionFinder, który ułatwia łańcuch wywołań.

Zobacz też

Interfejs Google Directions API

`setDestination(latitude, longitude)`

Umożliwia ustawienie końcowej lokalizacji, do której należy wyznaczać trasę, za pomocą punktu (szerokość/długość).

// Creates a DirectionFinder with the destination set to Central Park.
var directionFinder = Maps.newDirectionFinder().setDestination(40.777052, -73.975464);

Parametry

Nazwa	Typ	Opis
`latitude`	`Number`	szerokość geograficzna lokalizacji końcowej
`longitude`	`Number`	długość geograficzna lokalizacji końcowej

Powroty

DirectionFinder – obiekt DirectionFinder, który ułatwia łańcuch wywołań

`setDestination(address)`

Umożliwia ustawienie na podstawie adresu lokalizacji końcowej, do której należy wyznaczać trasę dojazdu.

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

Parametry

Nazwa	Typ	Opis
`address`	`String`	adres końcowy

Powroty

DirectionFinder – obiekt DirectionFinder, który ułatwia łańcuch wywołań

`setLanguage(language)`

Ustawia język, który będzie używany we wskazówkach.

// Creates a DirectionFinder with the language set to French.
var directionFinder = Maps.newDirectionFinder().setLanguage('fr');

Parametry

Nazwa	Typ	Opis
`language`	`String`	identyfikator języka BCP-47

Powroty

DirectionFinder – obiekt DirectionFinder, który ułatwia łańcuch wywołań

Zobacz też

Obsługa języków w interfejsach API Map Google

`setMode(mode)`

Ustawienie środka transportu (domyślnie jest to samochód).

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

Parametry

Nazwa	Typ	Opis
`mode`	`String`	stała wartość z `Mode`

Powroty

DirectionFinder – obiekt DirectionFinder, który ułatwia łańcuch wywołań

Zobacz też

Interfejs Google Directions API

`setOptimizeWaypoints(optimizeOrder)`

Określa, czy należy optymalizować wskazaną trasę przez zmianę kolejności punktów na trasie w efektywniejszy sposób (wartość domyślna to fałsz).

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

Parametry

Nazwa	Typ	Opis
`optimizeOrder`	`Boolean`	„true”, aby zoptymalizować kolejność, lub „false” (fałsz) w przeciwnym razie

Powroty

DirectionFinder – obiekt DirectionFinder, który ułatwia łańcuch wywołań

Zobacz też

Interfejs Google Directions API

`setOrigin(latitude, longitude)`

Określa lokalizację początkową, z której należy wyznaczać trasę na podstawie punktu (szerokość/długość).

// Creates a DirectionFinder with the origin set to Times Square.
var directionFinder = Maps.newDirectionFinder().setOrigin(40.759011, -73.984472);

Parametry

Nazwa	Typ	Opis
`latitude`	`Number`	szerokość geograficzna lokalizacji początkowej
`longitude`	`Number`	długość geograficzna lokalizacji początkowej

Powroty

DirectionFinder – obiekt DirectionFinder, który ułatwia łańcuch wywołań

`setOrigin(address)`

Określa lokalizację początkową na podstawie adresu, z której chcesz wytyczyć trasę.

// Creates a DirectionFinder with the origin set to Times Square.
var directionFinder = Maps.newDirectionFinder().setOrigin('Times Square, New York, NY');

Parametry

Nazwa	Typ	Opis
`address`	`String`	adres początkowy

Powroty

DirectionFinder – instancja DirectionFinder ułatwiająca łańcuch połączeń.

`setRegion(region)`

Określa region, który ma być używany podczas interpretowania nazw lokalizacji. Obsługiwane kody regionów odpowiadają krajom ccTLD obsługiwanych przez Mapy Google. Na przykład kod regionu „pl” odpowiada adresowi „maps.google.pl”.

// Creates a DirectionFinder with the region set to France.
var directionFinder = Maps.newDirectionFinder().setRegion('fr');

Parametry

Nazwa	Typ	Opis
`region`	`String`	kod regionu, którego chcesz użyć

Powroty

DirectionFinder – obiekt DirectionFinder, który ułatwia łańcuch wywołań

Zobacz też

Interfejs Google Directions API