Class StaticMap

Статикмап

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

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

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

См. также

Методы

Метод Тип возврата Краткое описание
addAddress(address) StaticMap Добавляет новый адрес к текущему определению пути.
addMarker(latitude, longitude) StaticMap Добавляет маркер на карту, используя точку (широта/долгота).
addMarker(address) StaticMap Добавляет маркер на карту, используя адрес.
addPath(points) StaticMap Добавляет путь на карту, используя массив точек.
addPath(polyline) StaticMap Добавляет путь на карту, используя закодированную ломаную линию.
addPoint(latitude, longitude) StaticMap Добавляет новую точку (широту/долготу) к текущему определению пути.
addVisible(latitude, longitude) StaticMap Добавляет точку (широта/долгота), которая должна быть видна на карте.
addVisible(address) StaticMap Добавляет адрес, который должен быть виден на карте.
beginPath() StaticMap Запускает новое определение пути.
clearMarkers() StaticMap Очищает текущий набор маркеров.
clearPaths() StaticMap Очистить текущий набор путей.
clearVisibles() StaticMap Очищает текущий набор видимых местоположений.
endPath() StaticMap Завершает определение пути, начатое с помощью BeginPath().
getAs(contentType) Blob Верните данные внутри этого объекта в виде большого двоичного объекта, преобразованного в указанный тип контента.
getBlob() Blob Получает данные изображения в виде Blob .
getMapImage() Byte[] Получает необработанные данные изображения в виде массива байтов.
getMapUrl() String Получает URL-адрес изображения карты.
setCenter(latitude, longitude) StaticMap Устанавливает центр карты с помощью точки (широта/долгота).
setCenter(address) StaticMap Устанавливает центр карты, используя адрес.
setCustomMarkerStyle(imageUrl, useShadow) StaticMap Устанавливает изображение пользовательского маркера, которое будет использоваться при создании новых маркеров.
setFormat(format) StaticMap Устанавливает формат изображения карты.
setLanguage(language) StaticMap Устанавливает язык, который будет использоваться для текста на карте (если доступен).
setMapType(mapType) StaticMap Устанавливает тип отображаемой карты.
setMarkerStyle(size, color, label) StaticMap Устанавливает стиль маркера, который будет использоваться при создании новых маркеров.
setMobile(useMobileTiles) StaticMap Определяет, использовать ли специализированные наборы плиток для мобильных устройств.
setPathStyle(weight, color, fillColor) StaticMap Устанавливает стиль пути, который будет использоваться при создании новых путей.
setSize(width, height) StaticMap Устанавливает ширину и высоту изображения карты в пикселях.
setZoom(zoom) StaticMap Устанавливает коэффициент масштабирования или уровень увеличения, используемый для карты.

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

addAddress(address)

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

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

Параметры

Имя Тип Описание
address String Адрес для добавления.

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

StaticMap — этот экземпляр карты для цепочки.

addMarker(latitude, longitude)

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

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

Параметры

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

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

StaticMap — этот экземпляр карты для цепочки.

См. также

addMarker(address)

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

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

Параметры

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

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

StaticMap — этот экземпляр карты для цепочки.

См. также

addPath(points)

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

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

Параметры

Имя Тип Описание
points Number[] Массив пар широты и долготы, определяющий путь.

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

StaticMap — этот экземпляр карты для цепочки.

addPath(polyline)

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

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

Параметры

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

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

StaticMap — этот экземпляр карты для цепочки.

addPoint(latitude, longitude)

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

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

Параметры

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

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

StaticMap — этот экземпляр карты для цепочки.

addVisible(latitude, longitude)

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

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

Параметры

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

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

StaticMap — этот экземпляр карты для цепочки.

См. также

addVisible(address)

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

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

Параметры

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

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

StaticMap — этот экземпляр карты для цепочки.

См. также

beginPath()

Запускает новое определение пути. Вызовы addAddress() и addPoint() определяют каждую новую вершину пути. Путь завершается при вызове 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();

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

StaticMap — этот экземпляр карты для цепочки.

clearMarkers()

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

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

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

StaticMap — этот экземпляр карты для цепочки.

clearPaths()

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

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

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

StaticMap — этот экземпляр карты для цепочки.

clearVisibles()

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

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

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

StaticMap — этот экземпляр карты для цепочки.

endPath()

Завершает определение пути, начатое с помощью BeginPath(). 

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

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

StaticMap — этот экземпляр карты для цепочки.

getAs(contentType)

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

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

Параметры

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

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

Blob — данные в виде большого двоичного объекта.

getBlob()

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

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

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

getMapImage()

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

В общем, предпочтительнее использовать getBlob() , который позволяет упростить взаимодействие с другими сервисами. 

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

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

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

getMapUrl()

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

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

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

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

setCenter(latitude, longitude)

Устанавливает центр карты с помощью точки (широта/долгота). 

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

Параметры

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

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

StaticMap — этот экземпляр карты для цепочки.

См. также

setCenter(address)

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

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

Параметры

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

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

StaticMap — этот экземпляр карты для цепочки.

См. также

setCustomMarkerStyle(imageUrl, useShadow)

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

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

Параметры

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

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

StaticMap — этот экземпляр карты для цепочки.

См. также

setFormat(format)

Устанавливает формат изображения карты. 

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

Параметры

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

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

StaticMap — этот экземпляр карты для цепочки.

См. также

setLanguage(language)

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

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

Параметры

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

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

StaticMap — этот экземпляр карты для цепочки.

См. также

setMapType(mapType)

Устанавливает тип отображаемой карты. 

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

Параметры

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

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

StaticMap — этот экземпляр карты для цепочки.

См. также

setMarkerStyle(size, color, label)

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

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

Параметры

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

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

StaticMap — этот экземпляр карты для цепочки.

См. также

setMobile(useMobileTiles)

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

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

Параметры

Имя Тип Описание
useMobileTiles Boolean Использовать или нет мобильные плитки.

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

StaticMap — этот экземпляр карты для цепочки.

setPathStyle(weight, color, fillColor)

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

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

Параметры

Имя Тип Описание
weight Integer Ширина линий в пикселях.
color String Цвет линии в виде строки в формате «0xrrggbb» или постоянного значения из Color .
fillColor String Цвет заливки, строка в формате «0xrrggbb» или постоянное значение из Color .

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

StaticMap — этот экземпляр карты для цепочки.

См. также

setSize(width, height)

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

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

Параметры

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

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

StaticMap — этот экземпляр карты для цепочки.

См. также

setZoom(zoom)

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

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

Параметры

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

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

StaticMap — этот экземпляр карты для цепочки.

См. также