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

Смотрите также

• API статических карт Google

Методы

Метод	Тип возврата	Краткое описание
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 — этот экземпляр карты для цепочки.

Смотрите также

• API статических карт Google

---

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 — этот экземпляр карты для цепочки.

Смотрите также

• API статических карт Google

---

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 — этот экземпляр карты для цепочки.

Смотрите также

• API статических карт Google

---

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 — этот экземпляр карты для цепочки.

Смотрите также

• API статических карт Google

---

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». Однако предполагается, что часть имени файла, которая следует за последней точкой (если она есть), является существующим расширением, которое следует заменить. Следовательно, «Список покупок.12.25.2014» становится «Список покупок.12.25.pdf».

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

Параметры

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

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

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 — этот экземпляр карты для цепочки.

Смотрите также

• API статических карт Google

---

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 — этот экземпляр карты для цепочки.

Смотрите также

• API статических карт Google

---

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 — этот экземпляр карты для цепочки.

Смотрите также

• API статических карт Google

---

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 — этот экземпляр карты для цепочки.

Смотрите также

• API статических карт Google

---

setLanguage(language)

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

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

Параметры

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

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

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

Смотрите также

• Языковая поддержка в API Карт Google

---

setMapType(mapType)

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

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

Параметры

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

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

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

Смотрите также

• API статических карт Google

---

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 — этот экземпляр карты для цепочки.

Смотрите также

• API статических карт Google

---

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 — этот экземпляр карты для цепочки.

Смотрите также

• API статических карт Google

---

setSize(width, height)

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

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

Параметры

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

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

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

Смотрите также

• API статических карт Google

---

setZoom(zoom)

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

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

Параметры

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

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

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

Смотрите также

• API статических карт Google