Umożliwia tworzenie i ozdabianie statycznych obrazów map.
Poniższy przykład pokazuje, jak za pomocą tej klasy utworzyć mapę New York City's Theatre District, w tym pobliskich stacji kolejowych, i wyświetlić ją w prostej aplikacji internetowej.
// Create a map centered on Times Square. var 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. var 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 (var i = 0; i < corners.length; i++) { map.addAddress(corners[i]); } // All static map URLs require an API key. var 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 przy użyciu punktu (szerokość/długość). |
addMarker(address) | StaticMap | Dodaje do mapy znacznik przy użyciu 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ść) do bieżącej definicji ścieżki. |
addVisible(latitude, longitude) | StaticMap | Dodaje lokalizację punktu (szerokość/długość), który musi być widoczny na mapie. |
addVisible(address) | StaticMap | Dodaje lokalizację adresu, która musi być widoczna na mapie. |
beginPath() | StaticMap | Uruchamia nową definicję ścieżki. |
clearMarkers() | StaticMap | Usuwa bieżący zestaw znaczników. |
clearPaths() | StaticMap | Wyczyść bieżący zestaw ścieżek. |
clearVisibles() | StaticMap | Usuwa bieżący zestaw widocznych lokalizacji. |
endPath() | StaticMap | Ukończenie definicji ścieżki rozpoczętej za pomocą funkcji startedPath(). |
getAs(contentType) | Blob | Zwraca dane wewnątrz tego obiektu jako obiekt blob przekonwertowany na określony typ treści. |
getBlob() | Blob | Pobiera dane obrazu jako Blob . |
getMapImage() | Byte[] | Pobiera nieprzetworzone dane obrazu w postaci tablicy bajtów. |
getMapUrl() | String | Pobiera adres URL obrazu mapy. |
setCenter(latitude, longitude) | StaticMap | Wyśrodkowuje mapę za pomocą punktu (szerokość/długość). |
setCenter(address) | StaticMap | Wyśrodkowuje mapę na podstawie adresu. |
setCustomMarkerStyle(imageUrl, useShadow) | StaticMap | Ustawia niestandardowy obraz znacznika, który ma być używany do tworzenia nowych znaczników. |
setFormat(format) | StaticMap | Ustawia format obrazu mapy. |
setLanguage(language) | StaticMap | Ustawia język tekstu na mapie (jeśli jest dostępny). |
setMapType(mapType) | StaticMap | Określa typ mapy do wyświetlenia. |
setMarkerStyle(size, color, label) | StaticMap | Ustawia styl znaczników, który ma być używany podczas tworzenia nowych znaczników. |
setMobile(useMobileTiles) | StaticMap | Określa, czy mają być używane specjalne zestawy kafelków na urządzeniach mobilnych. |
setPathStyle(weight, color, fillColor) | StaticMap | Ustawia styl ścieżki, którego chcesz używać podczas tworzenia nowych ścieżek. |
setSize(width, height) | StaticMap | Ustawia szerokość i wysokość obrazu mapy w pikselach. |
setZoom(zoom) | StaticMap | Umożliwia ustawienie współczynnika powiększenia (poziomu powiększenia) używanego do wyświetlania mapy. |
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. var map = Maps.newStaticMap() .beginPath() .addAddress('New York, NY') .addAddress('Boston, MA') .endPath();
Parametry
Nazwa | Typ | Opis |
---|---|---|
address | String | Adres do dodania. |
Powroty
StaticMap
– ta instancja mapy do tworzenia łańcuchów.
addMarker(latitude, longitude)
Dodaje znacznik do mapy przy użyciu punktu (szerokość/długość).
// Creates a map and adds a marker at the specified coordinates. var 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. |
Powroty
StaticMap
– ta instancja mapy do tworzenia łańcuchów.
Zobacz też
addMarker(address)
Dodaje do mapy znacznik przy użyciu adresu.
// Creates a map and adds a marker at the specified address. var map = Maps.newStaticMap().addMarker('76 9th Ave, New York NY');
Parametry
Nazwa | Typ | Opis |
---|---|---|
address | String | Adres, pod którym należy umieścić nowy znacznik. |
Powroty
StaticMap
– ta instancja mapy do tworzenia łańcuchów.
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. var 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ę. |
Powroty
StaticMap
– ta instancja mapy do tworzenia łańcuchów.
addPath(polyline)
Dodaje ścieżkę do mapy za pomocą zakodowanej linii łamanej.
// Creates a map and adds a path from New York to Boston. var polyline = Maps.encodePolyline([40.714353, -74.005973, 42.358431, -71.059773]); var map = Maps.newStaticMap().addPath(polyline);
Parametry
Nazwa | Typ | Opis |
---|---|---|
polyline | String | Zakodowana linia łamana. |
Powroty
StaticMap
– ta instancja mapy do tworzenia łańcuchów.
addPoint(latitude, longitude)
Dodaje nowy punkt (szerokość/długość) do bieżącej definicji ścieżki.
// Creates a map and adds a path from New York to Boston. var 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. |
Powroty
StaticMap
– ta instancja mapy do tworzenia łańcuchów.
addVisible(latitude, longitude)
Dodaje lokalizację punktu (szerokość/długość), który musi być widoczny na mapie.
// Creates a map where New York and Boston are visible. var 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. |
Powroty
StaticMap
– ta instancja mapy do tworzenia łańcuchów.
Zobacz też
addVisible(address)
Dodaje lokalizację adresu, która musi być widoczna na mapie.
// Creates a map where New York and Boston are visible. var map = Maps.newStaticMap() .addVisible('New York, NY') .addVisible('Boston, MA');
Parametry
Nazwa | Typ | Opis |
---|---|---|
address | String | Adres, który musi być widoczny na mapie. |
Powroty
StaticMap
– ta instancja mapy do tworzenia łańcuchów.
Zobacz też
beginPath()
Uruchamia nową definicję ścieżki. Wywołania addAddress()
i addPoint()
definiują każdy nowy wierzchołek na ścieżce. Ścieżka jest ukończona po wywołaniu funkcji endPath()
.
// Creates a map and adds a path from New York to Boston. var map = Maps.newStaticMap() .beginPath() .addAddress('New York, NY') .addAddress('Boston, MA') .endPath();
Powroty
StaticMap
– ta instancja mapy do tworzenia łańcuchów.
clearMarkers()
Usuwa bieżący zestaw znaczników.
var map = Maps.newStaticMap(); // ... // Do something interesting here ... // ... // Remove all markers on the map. map.clearMarkers();
Powroty
StaticMap
– ta instancja mapy do tworzenia łańcuchów.
clearPaths()
Wyczyść bieżący zestaw ścieżek.
var map = Maps.newStaticMap(); // ... // Do something interesting here ... // ... // Remove all paths on the map. map.clearPaths();
Powroty
StaticMap
– ta instancja mapy do tworzenia łańcuchów.
clearVisibles()
Usuwa bieżący zestaw widocznych lokalizacji.
var map = Maps.newStaticMap(); // ... // Do something interesting here ... // ... // Remove all visible locations created with addVisible(). map.clearVisibles();
Powroty
StaticMap
– ta instancja mapy do tworzenia łańcuchów.
endPath()
Ukończenie definicji ścieżki rozpoczętej za pomocą funkcji startedPath().
// Creates a map and adds a path from New York to Boston. var map = Maps.newStaticMap() .beginPath() .addAddress('New York, NY') .addAddress('Boston, MA') .endPath();
Powroty
StaticMap
– ta instancja mapy do tworzenia łańcuchów.
getAs(contentType)
Zwraca dane wewnątrz tego obiektu jako obiekt blob przekonwertowany na określony typ treści. Ta metoda dodaje do nazwy pliku odpowiednie rozszerzenie, na przykład „mójplik.pdf”. Zakładamy jednak, że część nazwy pliku, która występuje po ostatniej kropce (jeśli występuje), jest istniejącym rozszerzeniem, które należy zastąpić. W związku z tym „Lista zakupów.12.25.2014” zmieni się na „Lista zakupów.12.25.pdf”.
Aby sprawdzić dzienne limity konwersji, przeczytaj artykuł Limity w usługach Google. Nowo utworzone domeny Google Workspace mogą tymczasowo podlegać bardziej rygorystycznym limitom.
Parametry
Nazwa | Typ | Opis |
---|---|---|
contentType | String | Typ MIME, na który ma zostać przekonwertowany. W przypadku większości obiektów blob jedyną prawidłową opcją jest 'application/pdf' . W przypadku zdjęć w formacie BMP, GIF, JPEG lub PNG obowiązują dowolne z tych wartości: 'image/bmp' , 'image/gif' , 'image/jpeg' i 'image/png' . |
Powroty
Blob
– dane w postaci obiektu blob.
getBlob()
Pobiera dane obrazu jako Blob
.
// Creates a map centered on Times Square and saves it to Google Drive. var map = Maps.newStaticMap().setCenter('Times Square, New York, NY'); DocsList.createFile(map); // You can call map.getBlob() explicitly or use it // implicitly by passing the map where a blob is expected.
Powroty
Blob
– zdjęcie mapy w wybranym formacie graficznym.
getMapImage()
Pobiera nieprzetworzone dane obrazu w postaci tablicy bajtów.
Ogólnie zalecamy korzystanie z getBlob()
, który umożliwia prostsze interakcje z innymi usługami.
// Creates a map centered on Times Square and saves it to Google Drive. var map = Maps.newStaticMap().setCenter('Times Square, New York, NY'); DocsList.createFile(Utilities.newBlob(map.getMapImage(), 'image/png', 'map.png'));
Powroty
Byte[]
– zdjęcie mapy w wybranym formacie graficznym.
getMapUrl()
Pobiera adres URL obrazu mapy.
// Creates a map centered on Times Square and gets the URL. var 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");
Powroty
String
– adres URL obrazu mapy.
setCenter(latitude, longitude)
Wyśrodkowuje mapę za pomocą punktu (szerokość/długość).
// Creates a map centered on Times Square, using its coordinates. var map = Maps.newStaticMap().setCenter(40.759011, -73.984472);
Parametry
Nazwa | Typ | Opis |
---|---|---|
latitude | Number | Szerokość geograficzna środka. |
longitude | Number | Długość geograficzna środka. |
Powroty
StaticMap
– ta instancja mapy do tworzenia łańcuchów.
Zobacz też
setCenter(address)
Wyśrodkowuje mapę na podstawie adresu.
// Creates a map centered on Times Square, using its address. var map = Maps.newStaticMap().setCenter('Times Square, New York, NY');
Parametry
Nazwa | Typ | Opis |
---|---|---|
address | String | Adres centrum. |
Powroty
StaticMap
– ta instancja mapy do tworzenia łańcuchów.
Zobacz też
setCustomMarkerStyle(imageUrl, useShadow)
Ustawia niestandardowy obraz znacznika, który ma być używany do tworzenia nowych znaczników. Nie ma to wpływu na już dodane znaczniki.
// Creates a map with markers set to be medium sized, black, and labeled with the number "1". var 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 ten format. |
useShadow | Boolean | Wskazuje, że w przypadku znacznika powinien być wygenerowany cień zależny od obszaru widocznego obrazu oraz jego przezroczystości/przezroczystości. |
Powroty
StaticMap
– ta instancja mapy do tworzenia łańcuchów.
Zobacz też
setFormat(format)
setLanguage(language)
Ustawia język tekstu na mapie (jeśli jest dostępny).
// Creates a map with the language set to French. var map = Maps.newStaticMap().setLanguage('fr');
Parametry
Nazwa | Typ | Opis |
---|---|---|
language | String | Identyfikator języka BCP-47. |
Powroty
StaticMap
– ta instancja mapy do tworzenia łańcuchów.
Zobacz też
setMapType(mapType)
setMarkerStyle(size, color, label)
Ustawia styl znaczników, który ma być używany podczas tworzenia nowych znaczników. Nie ma to wpływu na już dodane znaczniki.
// Creates a map with markers set to be medium sized, black, and labeled with the number "1". var 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 w formacie „0xrrggbb” lub stała wartość z Color . |
label | String | Ciąg tekstowy zawierający pojedynczy znak A–Z lub 0–9. |
Powroty
StaticMap
– ta instancja mapy do tworzenia łańcuchów.
Zobacz też
setMobile(useMobileTiles)
Określa, czy mają być używane specjalne zestawy kafelków na urządzeniach mobilnych.
// Creates a map that uses mobile-friendly tiles. var map = Maps.newStaticMap().setMobile(true);
Parametry
Nazwa | Typ | Opis |
---|---|---|
useMobileTiles | Boolean | Określa, czy chcesz używać kart na urządzenia mobilne. |
Powroty
StaticMap
– ta instancja mapy do tworzenia łańcuchów.
setPathStyle(weight, color, fillColor)
Ustawia styl ścieżki, którego chcesz używać podczas tworzenia nowych ścieżek. Nie ma to wpływu na dodane już ścieżki.
// Creates a map with paths set to be 1 pixel wide with a black line and a white fill. var 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 . |
Powroty
StaticMap
– ta instancja mapy do tworzenia łańcuchów.
Zobacz też
setSize(width, height)
Ustawia szerokość i wysokość obrazu mapy w pikselach.
// Creates a map 400px wide by 300px high. var map = Maps.newStaticMap().setSize(400, 300);
Parametry
Nazwa | Typ | Opis |
---|---|---|
width | Integer | Szerokość obrazu w pikselach. |
height | Integer | Wysokość obrazu w pikselach. |
Powroty
StaticMap
– ta instancja mapy do tworzenia łańcuchów.
Zobacz też
setZoom(zoom)
Umożliwia ustawienie współczynnika powiększenia (poziomu powiększenia) używanego do wyświetlania mapy.
// Creates a map with a zoom factor of 10. var map = Maps.newStaticMap().setZoom(10);
Parametry
Nazwa | Typ | Opis |
---|---|---|
zoom | Integer | Wartość od 0 do 21 włącznie. |
Powroty
StaticMap
– ta instancja mapy do tworzenia łańcuchów.