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

См. также

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

Методы

Метод	Тип возвращаемого значения	Краткое описание
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	Задает коэффициент масштабирования, или уровень увеличения, используемый для карты.

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

addAddress(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	Дополнительный адрес.

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

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

---

addMarker(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	Долгота нового маркера.

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

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

См. также

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

---

addMarker(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	Адрес, по которому следует установить новый указатель.

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

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

См. также

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

---

addPath(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[]	Набор пар координат широты и долготы, определяющих маршрут.

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

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

---

addPath(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	Закодированная полилиния.

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

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

---

addPoint(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	Долгота точки.

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

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

---

addVisible(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	Долгота точки.

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

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

См. также

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

---

addVisible(address)

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

// Creates a map where New York and Boston are visible.
const 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.
const map = Maps.newStaticMap()
                .beginPath()
                .addAddress('New York, NY')
                .addAddress('Boston, MA')
                .endPath();

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

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

---

clearMarkers()

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

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

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

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

---

clearPaths()

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

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

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

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

---

clearVisibles()

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

const 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.
const map = Maps.newStaticMap()
                .beginPath()
                .addAddress('New York, NY')
                .addAddress('Boston, MA')
                .endPath();

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

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

---

getAs(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).

---

getBlob()

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

---

getMapImage()

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

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

// 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[] — Изображение карты в выбранном формате.

---

getMapUrl()

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

---

setCenter(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	Долгота центра.

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

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

См. также

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

---

setCenter(address)

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

// Creates a map centered on Times Square, using its address.
const 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".
const map = Maps.newStaticMap().setCustomMarkerStyle(
    'http://www.example.com/marker.png',
    false,
);

Параметры

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

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

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

См. также

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

---

setFormat(format)

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

// Creates a map with the image format set to PNG.
const 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.
const map = Maps.newStaticMap().setLanguage('fr');

Параметры

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

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

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

См. также

• Поддержка языков в API Google Maps

---

setMapType(mapType)

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

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

Параметры

Имя	Тип	Описание
map Type	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".
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.

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

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

См. также

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

---

setMobile(useMobileTiles)

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

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

Параметры

Имя	Тип	Описание
use Mobile Tiles	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.
const map = Maps.newStaticMap().setPathStyle(
    1,
    Maps.StaticMap.Color.BLACK,
    'red',
);

Параметры

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

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

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

См. также

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

---

setSize(width, height)

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

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

Параметры

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

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

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

См. также

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

---

setZoom(zoom)

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

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

Параметры

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

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

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

См. также

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