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ż
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ż
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ż
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ż
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ż
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ż
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ż
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ż
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ń