Class StaticMap

Статическая карта

Позволяет создавать и оформлять статические изображения карт.

В приведенном ниже примере показано, как можно использовать этот класс для создания карты Театрального квартала Нью-Йорка, включая близлежащие железнодорожные станции, и отображения ее в простом веб-приложении.

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

См. также

Методы

Метод Тип возвращаемого значения Краткое описание
add Address(address) Static Map Добавляет новый адрес к текущему определению пути.
add Marker(latitude, longitude) Static Map Добавляет маркер на карту, используя точку (широта/долгота).
add Marker(address) Static Map Добавляет маркер на карту, используя указанный адрес.
add Path(points) Static Map Добавляет на карту путь, используя массив точек.
add Path(polyline) Static Map Добавляет на карту путь, используя закодированную полилинию.
add Point(latitude, longitude) Static Map Добавляет новую точку (широта/долгота) к текущему определению пути.
add Visible(latitude, longitude) Static Map Добавляет точку (широта/долгота), которая должна быть видна на карте.
add Visible(address) Static Map Добавляет адрес, который должен быть виден на карте.
begin Path() Static Map Начинает определение нового пути.
clear Markers() Static Map Очищает текущий набор маркеров.
clear Paths() Static Map Очистить текущий набор путей.
clear Visibles() Static Map Очищает текущий набор видимых локаций.
end Path() Static Map Завершает определение пути, начатое с помощью beginPath().
get As(contentType) Blob Возвращает данные, содержащиеся в этом объекте, в виде двоичных данных (blob), преобразованных в указанный тип содержимого.
get Blob() Blob Получает данные изображения в виде объекта Blob .
get Map Image() Byte[] Получает необработанные данные изображения в виде массива байтов.
get Map Url() String Получает URL-адрес изображения карты.
set Center(latitude, longitude) Static Map Задает центр карты, используя заданную точку (широта/долгота).
set Center(address) Static Map Устанавливает центр карты, используя указанный адрес.
set Custom Marker Style(imageUrl, useShadow) Static Map Задает пользовательское изображение для маркера, используемое при создании новых маркеров.
set Format(format) Static Map Задает формат изображения карты.
set Language(language) Static Map Задает язык, используемый для текста на карте (если доступен).
set Map Type(mapType) Static Map Задает тип отображаемой карты.
set Marker Style(size, color, label) Static Map Задает стиль маркера, используемый при создании новых маркеров.
set Mobile(useMobileTiles) Static Map Определяет, следует ли использовать специализированные наборы тайлов для мобильных устройств.
set Path Style(weight, color, fillColor) Static Map Задает стиль пути, используемый при создании новых путей.
set Size(width, height) Static Map Задает ширину и высоту изображения карты в пикселях.
set Zoom(zoom) Static Map Задает коэффициент масштабирования, или уровень увеличения, используемый для карты.

Подробная документация

add Address(address)

Добавляет новый адрес к текущему определению пути.

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

Параметры

Имя Тип Описание
address String Дополнительный адрес.

Возвращаться

Static Map — этот экземпляр карты используется для создания цепочек.

add Marker(latitude, longitude)

Добавляет маркер на карту, используя точку (широта/долгота).

// Creates a map and adds a marker at the specified coordinates.
const map = Maps.newStaticMap().addMarker(40.741799, -74.004207);

Параметры

Имя Тип Описание
latitude Number Широта нового маркера.
longitude Number Долгота нового маркера.

Возвращаться

Static Map — этот экземпляр карты используется для создания цепочек.

См. также

add Marker(address)

Добавляет маркер на карту, используя указанный адрес.

// Creates a map and adds a marker at the specified address.
const map = Maps.newStaticMap().addMarker('76 9th Ave, New York NY');

Параметры

Имя Тип Описание
address String Адрес, по которому следует установить новый указатель.

Возвращаться

Static Map — этот экземпляр карты используется для создания цепочек.

См. также

add Path(points)

Добавляет на карту путь, используя массив точек.

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

Параметры

Имя Тип Описание
points Number[] Набор пар координат широты и долготы, определяющих маршрут.

Возвращаться

Static Map — этот экземпляр карты используется для создания цепочек.

add Path(polyline)

Добавляет на карту путь, используя закодированную полилинию.

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

Параметры

Имя Тип Описание
polyline String Закодированная полилиния.

Возвращаться

Static Map — этот экземпляр карты используется для создания цепочек.

add Point(latitude, longitude)

Добавляет новую точку (широта/долгота) к текущему определению пути.

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

Параметры

Имя Тип Описание
latitude Number Широта точки.
longitude Number Долгота точки.

Возвращаться

Static Map — этот экземпляр карты используется для создания цепочек.

add Visible(latitude, longitude)

Добавляет точку (широта/долгота), которая должна быть видна на карте.

// Creates a map where New York and Boston are visible.
const map = Maps.newStaticMap()
                .addVisible(40.714353, -74.005973)
                .addVisible(42.358431, -71.059773);

Параметры

Имя Тип Описание
latitude Number Широта точки.
longitude Number Долгота точки.

Возвращаться

Static Map — этот экземпляр карты используется для создания цепочек.

См. также

add Visible(address)

Добавляет адрес, который должен быть виден на карте.

// Creates a map where New York and Boston are visible.
const map =
    Maps.newStaticMap().addVisible('New York, NY').addVisible('Boston, MA');

Параметры

Имя Тип Описание
address String Адрес, который должен быть виден на карте.

Возвращаться

Static Map — этот экземпляр карты используется для создания цепочек.

См. также

begin Path()

Начинается определение нового пути. Вызовы методов add Address() и add Point() определяют каждую новую вершину в пути. Путь завершается при вызове end Path() . 

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

Возвращаться

Static Map — этот экземпляр карты используется для создания цепочек.

clear Markers()

Очищает текущий набор маркеров. 

const map = Maps.newStaticMap();
// ...
// Do something interesting here ...
// ...
// Remove all markers on the map.
map.clearMarkers();

Возвращаться

Static Map — этот экземпляр карты используется для создания цепочек.

clear Paths()

Очистить текущий набор путей. 

const map = Maps.newStaticMap();
// ...
// Do something interesting here ...
// ...
// Remove all paths on the map.
map.clearPaths();

Возвращаться

Static Map — этот экземпляр карты используется для создания цепочек.

clear Visibles()

Очищает текущий набор видимых локаций. 

const map = Maps.newStaticMap();
// ...
// Do something interesting here ...
// ...
// Remove all visible locations created with addVisible().
map.clearVisibles();

Возвращаться

Static Map — этот экземпляр карты используется для создания цепочек.

end Path()

Завершает определение пути, начатое с помощью 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();

Возвращаться

Static Map — этот экземпляр карты используется для создания цепочек.

get As(contentType)

Возвращает данные из этого объекта в виде двоичных данных (blob), преобразованных в указанный тип содержимого. Этот метод добавляет соответствующее расширение к имени файла — например, "myfile.pdf". Однако он предполагает, что часть имени файла, следующая за последней точкой (если таковая имеется), является существующим расширением, которое следует заменить. Следовательно, "ShoppingList.12.25.2014" становится "ShoppingList.12.25.pdf".

Чтобы просмотреть ежедневные квоты на конверсии, см. раздел «Квоты для сервисов Google» . На вновь созданные домены Google Workspace могут временно распространяться более строгие квоты.

Параметры

Имя Тип Описание
content Type String MIME-тип для преобразования. Для большинства файлов .blob единственным допустимым вариантом является 'application/pdf' . Для изображений в форматах BMP, GIF, JPEG или PNG также допустимы любые из 'image/bmp' , 'image/gif' , 'image/jpeg' или 'image/png' . Для документа Google Docs также допустим 'text/markdown' .

Возвращаться

Blob — Данные в виде двоичных данных (blob).

get Blob()

Получает данные изображения в виде объекта 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.

Возвращаться

Blob — Изображение карты в выбранном формате.

get Map Image()

Получает необработанные данные изображения в виде массива байтов.

В целом, предпочтительнее использовать get 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(
    Utilities.newBlob(map.getMapImage(), 'image/png', 'map.png'),
);

Возвращаться

Byte[] — Изображение карты в выбранном формате.

get Map Url()

Получает URL-адрес изображения карты. 

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

Возвращаться

String — URL. URL изображения карты.

set Center(latitude, longitude)

Задает центр карты, используя заданную точку (широта/долгота). 

// Creates a map centered on Times Square, using its coordinates.
const map = Maps.newStaticMap().setCenter(40.759011, -73.984472);

Параметры

Имя Тип Описание
latitude Number Широта центра.
longitude Number Долгота центра.

Возвращаться

Static Map — этот экземпляр карты используется для создания цепочек.

См. также

set Center(address)

Устанавливает центр карты, используя указанный адрес. 

// Creates a map centered on Times Square, using its address.
const map = Maps.newStaticMap().setCenter('Times Square, New York, NY');

Параметры

Имя Тип Описание
address String Адрес центра.

Возвращаться

Static Map — этот экземпляр карты используется для создания цепочек.

См. также

set Custom Marker Style(imageUrl, useShadow)

Задает пользовательское изображение для маркера, используемое при создании новых маркеров. Это не влияет на уже добавленные маркеры. 

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

Параметры

Имя Тип Описание
image Url String Указывает URL-адрес, который будет использоваться в качестве пользовательской иконки маркера. Изображения могут быть в форматах PNG, JPEG или GIF, хотя рекомендуется использовать формат PNG.
use Shadow Boolean Указывает, что для маркера должна быть создана тень, исходя из видимой области изображения и его непрозрачности/прозрачности.

Возвращаться

Static Map — этот экземпляр карты используется для создания цепочек.

См. также

set Format(format)

Задает формат изображения карты. 

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

Параметры

Имя Тип Описание
format String Постоянное значение из Format .

Возвращаться

Static Map — этот экземпляр карты используется для создания цепочек.

См. также

set Language(language)

Задает язык, используемый для текста на карте (если доступен). 

// Creates a map with the language set to French.
const map = Maps.newStaticMap().setLanguage('fr');

Параметры

Имя Тип Описание
language String Идентификатор языка BCP-47.

Возвращаться

Static Map — этот экземпляр карты используется для создания цепочек.

См. также

set Map Type(mapType)

Задает тип отображаемой карты. 

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

Параметры

Имя Тип Описание
map Type String Постоянная величина из Type .

Возвращаться

Static Map — этот экземпляр карты используется для создания цепочек.

См. также

set Marker Style(size, color, label)

Задает стиль маркера, используемый при создании новых маркеров. Уже добавленные маркеры не затрагиваются. 

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

Параметры

Имя Тип Описание
size String Постоянная величина из Marker Size .
color String Строка в формате "0xrrggbb" или постоянное значение из Color .
label String Строка, содержащая один символ AZ или цифры от 0 до 9.

Возвращаться

Static Map — этот экземпляр карты используется для создания цепочек.

См. также

set Mobile(useMobileTiles)

Определяет, следует ли использовать специализированные наборы тайлов для мобильных устройств. 

// Creates a map that uses mobile-friendly tiles.
const map = Maps.newStaticMap().setMobile(true);

Параметры

Имя Тип Описание
use Mobile Tiles Boolean Использовать ли мобильные плитки?

Возвращаться

Static Map — этот экземпляр карты используется для создания цепочек.

set Path Style(weight, color, fillColor)

Задает стиль пути, используемый при создании новых путей. Уже добавленные пути остаются без изменений. 

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

Параметры

Имя Тип Описание
weight Integer Ширина линий в пикселях.
color String Цвет линии может быть задан в виде строки в формате "0xrrggbb" или константы из Color .
fill Color String Цвет заливки, строка в формате "0xrrggbb" или постоянное значение из Color .

Возвращаться

Static Map — этот экземпляр карты используется для создания цепочек.

См. также

set Size(width, height)

Задает ширину и высоту изображения карты в пикселях. 

// Creates a map 400px wide by 300px high.
const map = Maps.newStaticMap().setSize(400, 300);

Параметры

Имя Тип Описание
width Integer Ширина изображения в пикселях.
height Integer Высота изображения в пикселях.

Возвращаться

Static Map — этот экземпляр карты используется для создания цепочек.

См. также

set Zoom(zoom)

Задает коэффициент масштабирования, или уровень увеличения, используемый для карты. 

// Creates a map with a zoom factor of 10.
const map = Maps.newStaticMap().setZoom(10);

Параметры

Имя Тип Описание
zoom Integer Значение от нуля до 21 включительно.

Возвращаться

Static Map — этот экземпляр карты используется для создания цепочек.

См. также