Class DirectionFinder

DirectionFinder

Umożliwia pobieranie wskazówek dojazdu między lokalizacjami.
Poniższy przykład pokazuje, jak za pomocą tej klasy uzyskać wskazówki dojazdu z Times Square do Central Parku, zatrzymując się po drodze w Lincoln Center, wykreślić lokalizacje i trasę na mapie oraz wysłać mapę e-mailem.

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

Zobacz też

• Google Directions API

Metody

Metoda	Zwracany typ	Krótki opis
addWaypoint(latitude, longitude)	DirectionFinder	Dodaje punkt pośredni, przez który musi przebiegać trasa, używając punktu (szerokość/długość geograficzna).
addWaypoint(address)	DirectionFinder	Dodaje punkt pośredni, przez który musi przebiegać trasa, używając adresu.
clearWaypoints()	DirectionFinder	Usuwa bieżący zestaw punktów trasy.
getDirections()	Object	Pobiera wskazówki dojazdu na podstawie ustawionego miejsca początkowego, miejsca docelowego i innych opcji.
setAlternatives(useAlternatives)	DirectionFinder	Określa, czy zamiast tylko trasy o najwyższej pozycji mają być zwracane trasy alternatywne (domyślnie false).
setArrive(time)	DirectionFinder	Ustaw żądany czas przyjazdu (w stosownych przypadkach).
setAvoid(avoid)	DirectionFinder	Określa, czy unikać określonych typów ograniczeń.
setDepart(time)	DirectionFinder	Ustaw preferowaną godzinę odjazdu (w stosownych przypadkach).
setDestination(latitude, longitude)	DirectionFinder	Ustawia lokalizację końcową, do której mają być obliczane wskazówki dojazdu, za pomocą punktu (szerokość/długość geograficzna).
setDestination(address)	DirectionFinder	Ustawia lokalizację końcową, do której mają zostać obliczone wskazówki dojazdu, używając adresu.
setLanguage(language)	DirectionFinder	Ustawia język, który ma być używany w wskazówkach.
setMode(mode)	DirectionFinder	Ustawia tryb podróży (domyślnie jest to samochód).
setOptimizeWaypoints(optimizeOrder)	DirectionFinder	Określa, czy optymalizować podaną trasę przez zmianę kolejności punktów pośrednich na bardziej efektywną (domyślnie false).
setOrigin(latitude, longitude)	DirectionFinder	Ustawia lokalizację początkową, z której mają być obliczane wskazówki dojazdu, za pomocą punktu (szerokość/długość geograficzna).
setOrigin(address)	DirectionFinder	Ustawia lokalizację początkową, od której mają być obliczane wskazówki dojazdu, za pomocą adresu.
setRegion(region)	DirectionFinder	Ustawia region, który będzie używany podczas interpretowania nazw lokalizacji.

Szczegółowa dokumentacja

addWaypoint(latitude, longitude)

Dodaje punkt pośredni, przez który musi przebiegać trasa, używając punktu (szerokość/długość geograficzna).

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

Parametry

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

Powrót

DirectionFinder – obiekt DirectionFinder ułatwiający łączenie wywołań.

---

addWaypoint(address)

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

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

Parametry

Nazwa	Typ	Opis
address	String	adres,

Powrót

DirectionFinder – obiekt DirectionFinder ułatwiający łączenie wywołań.

---

clearWaypoints()

Usuwa bieżący zestaw punktów trasy.

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

Powrót

DirectionFinder – obiekt DirectionFinder ułatwiający łączenie wywołań.

---

getDirections()

Pobiera wskazówki dojazdu na podstawie ustawionego punktu początkowego, miejsca docelowego i innych opcji.

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

Powrót

Object – obiekt JSON zawierający zbiór tras dojazdu, zgodnie z opisem tutaj.

Zobacz też

• Google Directions API

---

setAlternatives(useAlternatives)

Określa, czy mają być zwracane trasy alternatywne, a nie tylko trasa o najwyższej pozycji (domyślnie false). Jeśli true, tablica routes w wynikowym obiekcie może zawierać wiele wpisów.

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

Parametry

Nazwa	Typ	Opis
useAlternatives	Boolean	true – aby zwrócić trasy alternatywne, false – w przeciwnym razie.

Powrót

DirectionFinder – obiekt DirectionFinder ułatwiający łączenie wywołań.

---

setArrive(time)

Ustaw żądany czas przyjazdu (w stosownych przypadkach).

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

Parametry

Nazwa	Typ	Opis
time	Date	godzina przyjazdu;

Powrót

DirectionFinder – obiekt DirectionFinder ułatwiający łączenie wywołań.

Zobacz też

• Google Directions API

---

setAvoid(avoid)

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

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

Parametry

Nazwa	Typ	Opis
avoid	String	Stała wartość z Avoid.

Powrót

DirectionFinder – obiekt DirectionFinder ułatwiający łączenie wywołań.

Zobacz też

• Google Directions API

---

setDepart(time)

Ustaw preferowaną godzinę odjazdu (w stosownych przypadkach).

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

Parametry

Nazwa	Typ	Opis
time	Date	Godzina odjazdu.

Powrót

DirectionFinder – obiekt DirectionFinder ułatwiający łączenie wywołań.

Zobacz też

• Google Directions API

---

setDestination(latitude, longitude)

Ustawia lokalizację końcową, do której mają być obliczane wskazówki dojazdu, za pomocą punktu (szerokość/długość geograficzna).

// Creates a DirectionFinder with the destination set to Central Park.
const 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.

Powrót

DirectionFinder – obiekt DirectionFinder ułatwiający łączenie wywołań.

---

setDestination(address)

Ustawia lokalizację końcową, do której mają zostać obliczone wskazówki dojazdu, używając adresu.

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

Parametry

Nazwa	Typ	Opis
address	String	Adres docelowy.

Powrót

DirectionFinder – obiekt DirectionFinder ułatwiający łączenie wywołań.

---

setLanguage(language)

Ustawia język, który ma być używany w wskazówkach.

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

Parametry

Nazwa	Typ	Opis
language	String	Identyfikator języka BCP-47.

Powrót

DirectionFinder – obiekt DirectionFinder ułatwiający łączenie wywołań.

Zobacz też

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

---

setMode(mode)

Ustawia tryb podróży (domyślnie jest to samochód).

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

Parametry

Nazwa	Typ	Opis
mode	String	Stała wartość z Mode.

Powrót

DirectionFinder – obiekt DirectionFinder ułatwiający łączenie wywołań.

Zobacz też

• Google Directions API

---

setOptimizeWaypoints(optimizeOrder)

Określa, czy optymalizować podaną trasę przez zmianę kolejności punktów pośrednich na bardziej efektywną (domyślnie false).

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

Parametry

Nazwa	Typ	Opis
optimizeOrder	Boolean	true zoptymalizować zamówienie lub false w inny sposób.

Powrót

DirectionFinder – obiekt DirectionFinder ułatwiający łączenie wywołań.

Zobacz też

• Google Directions API

---

setOrigin(latitude, longitude)

Ustawia lokalizację początkową, z której mają być obliczane wskazówki dojazdu, za pomocą punktu (szerokość/długość geograficzna).

// Creates a DirectionFinder with the origin set to Times Square.
const 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.

Powrót

DirectionFinder – obiekt DirectionFinder ułatwiający łączenie wywołań.

---

setOrigin(address)

Ustawia lokalizację początkową, od której mają być obliczane wskazówki dojazdu, za pomocą adresu.

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

Parametry

Nazwa	Typ	Opis
address	String	Adres początkowy.

Powrót

DirectionFinder – instancja DirectionFinder, która ułatwia łączenie wywołań.

---

setRegion(region)

Ustawia region, który będzie używany podczas interpretowania nazw lokalizacji. Obsługiwane kody regionów odpowiadają krajowym domenom najwyższego poziomu obsługiwanym przez Mapy Google. Na przykład kod regionu „uk” odpowiada domenie „maps.google.co.uk”.

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

Parametry

Nazwa	Typ	Opis
region	String	Kod regionu do użycia.

Powrót

DirectionFinder – obiekt DirectionFinder ułatwiający łączenie wywołań.

Zobacz też

• Google Directions API