Umożliwia tworzenie i zdobienie statycznych obrazów mapy.
Przykład poniżej pokazuje, jak za pomocą tej klasy utworzyć mapę Teatralnego Dzielnicy w Nowym Jorku, w tym pobliskich stacji kolejowych, i wyświetlić ją w prostej aplikacji internetowej.
// Create a map centered on Times Square. const map = Maps.newStaticMap().setSize(600, 600).setCenter( 'Times Square, New York, NY'); // Add markers for the nearbye train stations. map.setMarkerStyle( Maps.StaticMap.MarkerSize.MID, Maps.StaticMap.Color.RED, 'T', ); map.addMarker('Grand Central Station, New York, NY'); map.addMarker('Penn Station, New York, NY'); // Show the boundaries of the Theatre District. const corners = [ '8th Ave & 53rd St, New York, NY', '6th Ave & 53rd St, New York, NY', '6th Ave & 40th St, New York, NY', '8th Ave & 40th St, New York, NY', ]; map.setPathStyle(4, Maps.StaticMap.Color.BLACK, Maps.StaticMap.Color.BLUE); map.beginPath(); for (let i = 0; i < corners.length; i++) { map.addAddress(corners[i]); } // All static map URLs require an API key. const url = `${map.getMapUrl()}&key=YOUR_API_KEY`;
Zobacz też
Metody
Metoda | Zwracany typ | Krótki opis |
---|---|---|
addAddress(address) | StaticMap | Dodaje nowy adres do bieżącej definicji ścieżki. |
addMarker(latitude, longitude) | StaticMap | Dodaje znacznik do mapy za pomocą punktu (lat/lng). |
addMarker(address) | StaticMap | Dodaje znacznik do mapy za pomocą adresu. |
addPath(points) | StaticMap | Dodaje ścieżkę do mapy za pomocą tablicy punktów. |
addPath(polyline) | StaticMap | Dodaje ścieżkę do mapy za pomocą zakodowanej linii łamanej. |
addPoint(latitude, longitude) | StaticMap | Dodaje nowy punkt (szerokość/długość geograficzna) do bieżącej definicji ścieżki. |
addVisible(latitude, longitude) | StaticMap | Dodaje punkt (szerokość/długość geograficzna) lokalizacji, który musi być widoczny na mapie. |
addVisible(address) | StaticMap | Dodaje lokalizację adresu, która musi być widoczna na mapie. |
beginPath() | StaticMap | Rozpoczyna nową definicję ścieżki. |
clearMarkers() | StaticMap | Czyści bieżący zestaw pisaków. |
clearPaths() | StaticMap | Wyczyść bieżący zestaw ścieżek. |
clearVisibles() | StaticMap | Czyści bieżący zestaw widocznych lokalizacji. |
endPath() | StaticMap | Dopełnia definicję ścieżki rozpoczętej za pomocą beginPath(). |
getAs(contentType) | Blob | Zwraca dane z tego obiektu jako blob przekonwertowany na określony typ treści. |
getBlob() | Blob | Pobiera dane obrazu jako Blob . |
getMapImage() | Byte[] | Pobiera dane nieprzetworzonego obrazu jako tablicę bajtów. |
getMapUrl() | String | Pobiera adres URL obrazu mapy. |
setCenter(latitude, longitude) | StaticMap | Ustawia środek mapy za pomocą punktu (szerokość/długość geograficzna). |
setCenter(address) | StaticMap | Ustawia środek mapy za pomocą adresu. |
setCustomMarkerStyle(imageUrl, useShadow) | StaticMap | Ustawia obraz niestandardowego znacznika, który ma być używany podczas tworzenia nowych znaczników. |
setFormat(format) | StaticMap | Ustawia format obrazu mapy. |
setLanguage(language) | StaticMap | Ustawia język, który ma być używany do tekstu na mapie (gdzie jest dostępny). |
setMapType(mapType) | StaticMap | Określa typ mapy, która ma być wyświetlana. |
setMarkerStyle(size, color, label) | StaticMap | Ustawia styl znacznika do użycia podczas tworzenia nowych znaczników. |
setMobile(useMobileTiles) | StaticMap | Określa, czy na urządzeniach mobilnych mają być używane specjalne zestawy płytek. |
setPathStyle(weight, color, fillColor) | StaticMap | Określa styl ścieżki, który ma być używany podczas tworzenia nowych ścieżek. |
setSize(width, height) | StaticMap | Ustawia szerokość i wysokość obrazu mapy w pikselach. |
setZoom(zoom) | StaticMap | Ustawia współczynnik powiększenia, czyli poziom powiększenia, używany na mapie. |
Szczegółowa dokumentacja
addAddress(address)
Dodaje nowy adres do bieżącej definicji ścieżki.
// Creates a map and adds a path from New York to Boston. const map = Maps.newStaticMap() .beginPath() .addAddress('New York, NY') .addAddress('Boston, MA') .endPath();
Parametry
Nazwa | Typ | Opis |
---|---|---|
address | String | Adres do dodania. |
Powrót
StaticMap
– ta instancja mapy, do łańcuchowania.
addMarker(latitude, longitude)
Dodaje znacznik do mapy za pomocą punktu (lat/lng).
// Creates a map and adds a marker at the specified coordinates. const map = Maps.newStaticMap().addMarker(40.741799, -74.004207);
Parametry
Nazwa | Typ | Opis |
---|---|---|
latitude | Number | Szerokość geograficzna nowego znacznika. |
longitude | Number | Długość geograficzna nowego znacznika. |
Powrót
StaticMap
– ta instancja mapy, do łańcuchowania.
Zobacz też
addMarker(address)
Dodaje znacznik do mapy za pomocą adresu.
// Creates a map and adds a marker at the specified address. const map = Maps.newStaticMap().addMarker('76 9th Ave, New York NY');
Parametry
Nazwa | Typ | Opis |
---|---|---|
address | String | Adres, pod którym ma zostać umieszczony nowy znacznik. |
Powrót
StaticMap
– ta instancja mapy, do łańcuchowania.
Zobacz też
addPath(points)
Dodaje ścieżkę do mapy za pomocą tablicy punktów.
// Creates a map and adds a path from New York to Boston. const map = Maps.newStaticMap().addPath([ 40.714353, -74.005973, 42.358431, -71.059773, ]);
Parametry
Nazwa | Typ | Opis |
---|---|---|
points | Number[] | Tablica par szerokości i długości geograficznej definiujących ścieżkę. |
Powrót
StaticMap
– ta instancja mapy, do łańcuchowania.
addPath(polyline)
Dodaje ścieżkę do mapy za pomocą zakodowanej linii łamanej.
// Creates a map and adds a path from New York to Boston. const polyline = Maps.encodePolyline([ 40.714353, -74.005973, 42.358431, -71.059773, ]); const map = Maps.newStaticMap().addPath(polyline);
Parametry
Nazwa | Typ | Opis |
---|---|---|
polyline | String | zakodowana linia łamana; |
Powrót
StaticMap
– ta instancja mapy, do łańcuchowania.
addPoint(latitude, longitude)
Dodaje nowy punkt (szerokość/długość geograficzna) do bieżącej definicji ścieżki.
// Creates a map and adds a path from New York to Boston. const map = Maps.newStaticMap() .beginPath() .addPoint(40.714353, -74.005973) .addPoint(42.358431, -71.059773) .endPath();
Parametry
Nazwa | Typ | Opis |
---|---|---|
latitude | Number | Szerokość geograficzna punktu. |
longitude | Number | Długość geograficzna punktu. |
Powrót
StaticMap
– ta instancja mapy, do łańcuchowania.
addVisible(latitude, longitude)
Dodaje punkt (szerokość/długość geograficzna) lokalizacji, który musi być widoczny na mapie.
// Creates a map where New York and Boston are visible. const map = Maps.newStaticMap() .addVisible(40.714353, -74.005973) .addVisible(42.358431, -71.059773);
Parametry
Nazwa | Typ | Opis |
---|---|---|
latitude | Number | Szerokość geograficzna punktu. |
longitude | Number | Długość geograficzna punktu. |
Powrót
StaticMap
– ta instancja mapy, do łańcuchowania.
Zobacz też
addVisible(address)
Dodaje lokalizację adresu, która musi być widoczna na mapie.
// Creates a map where New York and Boston are visible. const map = Maps.newStaticMap().addVisible('New York, NY').addVisible('Boston, MA');
Parametry
Nazwa | Typ | Opis |
---|---|---|
address | String | Adres, który musi być widoczny na mapie. |
Powrót
StaticMap
– ta instancja mapy, do łańcuchowania.
Zobacz też
beginPath()
Rozpoczyna nową definicję ścieżki. Wywołania funkcji addAddress()
i addPoint()
definiują każdy nowy wierzchołek na ścieżce. Ścieżka jest zakończona, gdy wywołana zostanie metoda endPath()
.
// Creates a map and adds a path from New York to Boston. const map = Maps.newStaticMap() .beginPath() .addAddress('New York, NY') .addAddress('Boston, MA') .endPath();
Powrót
StaticMap
– ta instancja mapy, do łańcuchowania.
clearMarkers()
Czyści bieżący zestaw pisaków.
const map = Maps.newStaticMap(); // ... // Do something interesting here ... // ... // Remove all markers on the map. map.clearMarkers();
Powrót
StaticMap
– ta instancja mapy, do łańcuchowania.
clearPaths()
Wyczyść bieżący zestaw ścieżek.
const map = Maps.newStaticMap(); // ... // Do something interesting here ... // ... // Remove all paths on the map. map.clearPaths();
Powrót
StaticMap
– ta instancja mapy, do łańcuchowania.
clearVisibles()
Czyści bieżący zestaw widocznych lokalizacji.
const map = Maps.newStaticMap(); // ... // Do something interesting here ... // ... // Remove all visible locations created with addVisible(). map.clearVisibles();
Powrót
StaticMap
– ta instancja mapy, do łańcuchowania.
endPath()
Dopełnia definicję ścieżki rozpoczętej za pomocą beginPath().
// Creates a map and adds a path from New York to Boston. const map = Maps.newStaticMap() .beginPath() .addAddress('New York, NY') .addAddress('Boston, MA') .endPath();
Powrót
StaticMap
– ta instancja mapy, do łańcuchowania.
getAs(contentType)
Zwraca dane z tego obiektu jako blob przekonwertowany na określony typ treści. Ta metoda dodaje odpowiednie rozszerzenie do nazwy pliku, np. „mójplik.pdf”. Zakłada ona jednak, że część nazwy pliku, która następuje po ostatnim okresie (jeśli w ogóle występuje), to istniejące rozszerzenie, które należy zastąpić. W rezultacie plik „ShoppingList.12.25.2014” zmieni nazwę na „ShoppingList.12.25.pdf”.
Informacje o limitach dziennych konwersji znajdziesz w artykule Limity dotyczące usług Google. Nowo utworzone domeny Google Workspace mogą być tymczasowo objęte bardziej rygorystycznymi limitami.
Parametry
Nazwa | Typ | Opis |
---|---|---|
contentType | String | Typ MIME, na który ma nastąpić konwersja. W przypadku większości blobów opcja 'application/pdf' jest jedyną prawidłową opcją. W przypadku obrazów w formacie BMP, GIF, JPEG lub PNG prawidłowe są również wartości 'image/bmp' , 'image/gif' , 'image/jpeg' lub 'image/png' . W przypadku dokumentu w Dokumentach Google możesz też użyć 'text/markdown' . |
Powrót
Blob
– dane w postaci bloba.
getBlob()
Pobiera dane obrazu jako Blob
.
// Creates a map centered on Times Square and saves it to Google Drive. const map = Maps.newStaticMap().setCenter('Times Square, New York, NY'); DriveApp.createFile(map); // You can call map.getBlob() explicitly or use it // implicitly by passing the map where a blob is expected.
Powrót
Blob
– obraz mapy w wybranym formacie.
getMapImage()
Pobiera dane nieprzetworzonego obrazu jako tablicę bajtów.
Zazwyczaj zalecamy używanie getBlob()
, co pozwala na prostszą interakcję z innymi usługami.
// Creates a map centered on Times Square and saves it to Google Drive. const map = Maps.newStaticMap().setCenter('Times Square, New York, NY'); DriveApp.createFile( Utilities.newBlob(map.getMapImage(), 'image/png', 'map.png'), );
Powrót
Byte[]
– obraz mapy w wybranym formacie.
getMapUrl()
Pobiera adres URL obrazu mapy.
// Creates a map centered on Times Square and gets the URL. const map = Maps.newStaticMap().setCenter('Times Square, New York, NY'); // All static map URLs require an API key. Logger.log(`${map.getMapUrl()}&key=YOUR_API_KEY`);
Powrót
String
– URL adres URL obrazu mapy.
setCenter(latitude, longitude)
Ustawia środek mapy za pomocą punktu (szerokość/długość geograficzna).
// Creates a map centered on Times Square, using its coordinates. const map = Maps.newStaticMap().setCenter(40.759011, -73.984472);
Parametry
Nazwa | Typ | Opis |
---|---|---|
latitude | Number | Szerokość geograficzna centrum. |
longitude | Number | Długość geograficzna centrum. |
Powrót
StaticMap
– ta instancja mapy, do łańcuchowania.
Zobacz też
setCenter(address)
Ustawia środek mapy za pomocą adresu.
// Creates a map centered on Times Square, using its address. const map = Maps.newStaticMap().setCenter('Times Square, New York, NY');
Parametry
Nazwa | Typ | Opis |
---|---|---|
address | String | Adres centrum. |
Powrót
StaticMap
– ta instancja mapy, do łańcuchowania.
Zobacz też
setCustomMarkerStyle(imageUrl, useShadow)
Ustawia obraz niestandardowego znacznika, który ma być używany podczas tworzenia nowych znaczników. Nie ma to wpływu na znaczniki, które zostały już dodane.
// Creates a map with markers set to be medium sized, black, and labeled with // the number "1". const map = Maps.newStaticMap().setCustomMarkerStyle( 'http://www.example.com/marker.png', false, );
Parametry
Nazwa | Typ | Opis |
---|---|---|
imageUrl | String | Określa adres URL, który ma być używany jako niestandardowa ikona znacznika. Obrazy mogą być w formacie PNG, JPEG lub GIF, ale zalecamy format PNG. |
useShadow | Boolean | Wskazuje, że znacznik powinien mieć generowany cień na podstawie widocznego regionu obrazu i jego krycia/przezroczystości. |
Powrót
StaticMap
– ta instancja mapy, do łańcuchowania.
Zobacz też
setFormat(format)
setLanguage(language)
Ustawia język, który ma być używany do tekstu na mapie (gdzie jest dostępny).
// Creates a map with the language set to French. const map = Maps.newStaticMap().setLanguage('fr');
Parametry
Nazwa | Typ | Opis |
---|---|---|
language | String | Identyfikator języka zgodny ze standardem BCP-47. |
Powrót
StaticMap
– ta instancja mapy, do łańcuchowania.
Zobacz też
setMapType(mapType)
setMarkerStyle(size, color, label)
Ustawia styl znacznika do użycia podczas tworzenia nowych znaczników. Nie dotyczy to już dodanych znaczników.
// Creates a map with markers set to be medium sized, black, and labeled with // the number "1". const map = Maps.newStaticMap().setMarkerStyle( Maps.StaticMap.MarkerSize.MID, Maps.StaticMap.Color.BLACK, '1', );
Parametry
Nazwa | Typ | Opis |
---|---|---|
size | String | Wartość stała z MarkerSize . |
color | String | Ciąg znaków w formacie „0xrrggbb” lub stała wartość z Color . |
label | String | Ciąg tekstowy zawierający 1 znak z zakresu A–Z lub 0–9. |
Powrót
StaticMap
– ta instancja mapy, do łańcuchowania.
Zobacz też
setMobile(useMobileTiles)
Określa, czy na urządzeniach mobilnych mają być używane specjalne zestawy płytek.
// Creates a map that uses mobile-friendly tiles. const map = Maps.newStaticMap().setMobile(true);
Parametry
Nazwa | Typ | Opis |
---|---|---|
useMobileTiles | Boolean | Użycie kart na urządzeniach mobilnych. |
Powrót
StaticMap
– ta instancja mapy, do łańcuchowania.
setPathStyle(weight, color, fillColor)
Określa styl ścieżki, który ma być używany podczas tworzenia nowych ścieżek. Ścieżki, które zostały już dodane, nie są na to w żaden sposób wpływane.
// Creates a map with paths set to be 1 pixel wide with a black line and a white // fill. const map = Maps.newStaticMap().setPathStyle( 1, Maps.StaticMap.Color.BLACK, 'red', );
Parametry
Nazwa | Typ | Opis |
---|---|---|
weight | Integer | Szerokość linii w pikselach. |
color | String | Kolor linii jako ciąg znaków w formacie „0xrrggbb” lub stała wartość z Color . |
fillColor | String | Kolor wypełnienia, ciąg znaków w formacie „0xrrggbb” lub stała wartość z Color . |
Powrót
StaticMap
– ta instancja mapy, do łańcuchowania.
Zobacz też
setSize(width, height)
Ustawia szerokość i wysokość obrazu mapy w pikselach.
// Creates a map 400px wide by 300px high. const map = Maps.newStaticMap().setSize(400, 300);
Parametry
Nazwa | Typ | Opis |
---|---|---|
width | Integer | Szerokość obrazu w pikselach. |
height | Integer | Wysokość obrazu w pikselach. |
Powrót
StaticMap
– ta instancja mapy, do łańcuchowania.
Zobacz też
setZoom(zoom)
Ustawia współczynnik powiększenia, czyli poziom powiększenia, używany na mapie.
// Creates a map with a zoom factor of 10. const map = Maps.newStaticMap().setZoom(10);
Parametry
Nazwa | Typ | Opis |
---|---|---|
zoom | Integer | Wartość od 0 do 21 włącznie. |
Powrót
StaticMap
– ta instancja mapy, do łańcuchowania.