Эта страница переведена с помощью Cloud Translation API.

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`	Верните данные внутри этого объекта в виде большого двоичного объекта, преобразованного в указанный тип контента.
`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 — этот экземпляр карты для цепочки.

См. также

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

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

См. также

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

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

См. также

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

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

См. также

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

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

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

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

Параметры

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

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

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

См. также

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

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

См. также

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

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

См. также

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

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

См. также

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

`set Language(language)`

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

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

Параметры

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

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

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

См. также

Языковая поддержка в API Google Maps

`set Map Type(mapType)`

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

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

Параметры

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

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

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

См. также

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

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

См. также

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

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

См. также

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

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

См. также

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

`set Zoom(zoom)`

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

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

Параметры

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

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

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

См. также

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