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

Class StaticMap

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ż

Interfejs Google Static Maps API

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ż

Interfejs Google Static Maps API

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

Interfejs Google Static Maps API

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

Interfejs Google Static Maps API

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

Interfejs Google Static Maps API

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

Interfejs Google Static Maps API

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

Interfejs Google Static Maps API

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

Interfejs Google Static Maps API

`setFormat(format)`

Ustawia format obrazu mapy.

// Creates a map with the image format set to PNG.
const map = Maps.newStaticMap().setFormat(Maps.StaticMap.Format.PNG);

Parametry

Nazwa	Typ	Opis
`format`	`String`	Wartość stała z `Format`.

Powrót

StaticMap – ta instancja mapy, do łańcuchowania.

Zobacz też

Interfejs Google Static Maps API

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

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

`setMapType(mapType)`

Określa typ mapy, która ma być wyświetlana.

// Creates a satellite map.
const map = Maps.newStaticMap().setMapType(Maps.StaticMap.Type.SATELLITE);

Parametry

Nazwa	Typ	Opis
`mapType`	`String`	Wartość stała z `Type`.

Powrót

StaticMap – ta instancja mapy, do łańcuchowania.

Zobacz też

Interfejs Google Static Maps API

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

Interfejs Google Static Maps API

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

Interfejs Google Static Maps API

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

Interfejs Google Static Maps API

`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.

Zobacz też

Interfejs Google Static Maps API