Начало работы

Введение

Maps Static API возвращает изображение (GIF, PNG или JPEG) в ответ на HTTP-запрос через URL-адрес. Для каждого запроса вы можете указать местоположение карты, размер изображения, уровень масштабирования, тип карты и размещение дополнительных маркеров в местах на карте. Вы можете дополнительно маркировать маркеры буквенно-цифровыми символами.

Изображение Maps Static API встроено в атрибут src тега <img> или его эквивалент в других языках программирования.

В этом документе описан требуемый формат URL-адресов Maps Static API и доступные параметры. В нем также приводятся некоторые советы и рекомендации по указанию URL-адресов.

Прежде чем вы начнете

Этот документ предназначен для разработчиков веб-сайтов и мобильных устройств, которые хотят включить изображения Maps Static API на веб-страницу или в мобильное приложение. В нем содержится введение в использование API и справочные материалы по доступным параметрам.

Прежде чем приступить к разработке с использованием Maps Static API, ознакомьтесь с требованиями аутентификации (вам понадобится ключ API), а также информацией об использовании API и платежной информации (необходимо включить выставление счетов в вашем проекте).

Параметры URL-адреса

URL-адрес Maps Static API должен иметь следующую форму:

https://maps.googleapis.com/maps/api/staticmap?parameters

Если доступ к вашему веб-сайту осуществляется через HTTPS, вам также необходимо загружать изображения Maps Static API через HTTPS, чтобы избежать предупреждений системы безопасности браузера. HTTPS также рекомендуется, если ваши запросы содержат конфиденциальную информацию пользователя, например местоположение пользователя:

https://maps.googleapis.com/maps/api/staticmap?parameters

Независимо от того, используете ли вы HTTP или HTTPS, определенные параметры URL-адреса являются обязательными, а некоторые являются необязательными. Как это принято в URL-адресах, все параметры разделяются символом амперсанда ( & ). Список параметров и их возможные значения перечислены в этом документе.

Maps Static API определяет изображения карт, используя следующие параметры URL:

Параметры местоположения

  • center ( обязательный , если маркеры отсутствуют) определяет центр карты, равноудаленный от всех краев карты. Этот параметр принимает местоположение в виде пары {широта,долгота}, разделенной запятыми (например, «40,714728,-73,998672»), или строкового адреса (например, «мэрия, Нью-Йорк, Нью-Йорк»), определяющего уникальное местоположение на поверхности Земля. Дополнительную информацию см. в разделе «Местоположения» .
  • zoom ( требуется , если маркеры отсутствуют) определяет уровень масштабирования карты, который определяет уровень увеличения карты. Этот параметр принимает числовое значение, соответствующее уровню масштабирования желаемой области. Дополнительную информацию см. в разделе Уровни масштабирования .

Параметры карты

  • size ( обязательный ) определяет прямоугольные размеры изображения карты. Этот параметр принимает строку вида {horizontal_value} x {vertical_value} . Например, 500x400 определяет карту шириной 500 пикселей и высотой 400 пикселей. На картах шириной менее 180 пикселей будет отображаться логотип Google уменьшенного размера. На этот параметр влияет параметр scale ; конечный выходной размер — это произведение значений размера и масштаба.
  • scale ( необязательно ) влияет на количество возвращаемых пикселей. scale=2 возвращает в два раза больше пикселей, чем scale=1 , сохраняя при этом ту же зону покрытия и уровень детализации (т. е. содержимое карты не меняется). Это полезно при разработке для дисплеев с высоким разрешением. Значение по умолчанию — 1 . Принимаемые значения — 1 и 2 . См. «Значения масштаба» для получения дополнительной информации.
  • format ( необязательный ) определяет формат результирующего изображения. По умолчанию Maps Static API создает изображения PNG. Существует несколько возможных форматов, включая типы GIF, JPEG и PNG. Какой формат вы используете, зависит от того, как вы собираетесь представить изображение. JPEG обычно обеспечивает большее сжатие, а GIF и PNG — большую детализацию. Дополнительные сведения см. в разделе Форматы изображений.
  • maptype ( необязательный ) определяет тип создаваемой карты. Существует несколько возможных значений типа карты, включая roadmap , satellite , hybrid и terrain . Дополнительную информацию см. в разделе Типы карт статического API Карт .
  • language ( необязательный ) определяет язык, который будет использоваться для отображения надписей на фрагментах карты. Обратите внимание, что этот параметр поддерживается только для некоторых плиток стран; если запрошенный язык не поддерживается для набора плиток, то для этого набора плиток будет использоваться язык по умолчанию.
  • region ( необязательно ) определяет соответствующие границы для отображения, исходя из геополитической чувствительности. Принимает код региона, указанный в виде двухсимвольного значения ccTLD («домен верхнего уровня»). См. сведения о покрытии платформы Google Maps для поддерживаемых регионов.

Параметры функции

  • map_id ( необязательно ) указывает идентификатор конкретной карты. Идентификатор карты связывает карту с определенным стилем или объектом и должен принадлежать тому же проекту, что и ключ API, используемый для инициализации карты. Дополнительную информацию см. в разделе Использование идентификаторов карт .
  • markers ( необязательно ) определяют один или несколько маркеров, которые нужно прикрепить к изображению в указанных местах. Этот параметр принимает одно определение маркера с параметрами, разделенными символом вертикальной черты ( | ). В одном параметре markers можно разместить несколько маркеров, если они имеют один и тот же стиль; вы можете добавить дополнительные маркеры разных стилей, добавив дополнительные параметры markers . Обратите внимание: если вы предоставляете маркеры для карты, вам не нужно указывать (обычно необходимые) параметры center и zoom . Дополнительную информацию см. в разделе Маркеры статического API Карт .
  • path ( необязательный ) определяет один путь из двух или более связанных точек для наложения на изображение в указанных местах. Этот параметр принимает строку определений точек, разделенных символом вертикальной черты ( | ), или закодированную ломаную линию с использованием префикса enc: в объявлении местоположения пути. Вы можете указать дополнительные пути, добавив дополнительные параметры path . Обратите внимание: если вы указываете путь для карты, вам не нужно указывать (обычно необходимые) параметры center и zoom . Дополнительную информацию см. в разделе Пути к статическим API Карт .
  • visible ( необязательный ) указывает одно или несколько мест , которые должны оставаться видимыми на карте, но маркеры или другие индикаторы отображаться не будут. Используйте этот параметр, чтобы гарантировать, что определенные объекты или местоположения на карте отображаются в Maps Static API.
  • style ( необязательный ) определяет пользовательский стиль для изменения представления определенного объекта (дорог, парков и других объектов) на карте. Этот параметр принимает аргументы feature и element , определяющие объекты для стилизации, а также набор операций стиля, которые нужно применить к выбранным объектам. Вы можете указать несколько стилей, добавив дополнительные параметры style . Дополнительную информацию см. в руководстве по стилизованным картам .

Параметры ключа и подписи

  • key ( обязательный ) позволяет вам отслеживать использование API вашим приложением в Google Cloud Console и гарантирует, что Google сможет связаться с вами по поводу вашего приложения, если это необходимо. Дополнительную информацию см. в разделе Использование ключей API с Maps Static API .
  • signature ( рекомендуется ) — это цифровая подпись, используемая для проверки того, что любой сайт, генерирующий запросы с использованием вашего ключа API, имеет на это право. Запросы без цифровой подписи могут завершиться неудачно. Дополнительные сведения см. в разделе Использование цифровой подписи .

Ограничение размера URL-адреса

Длина URL-адресов статического API Карт ограничена 16 384 символами. На практике вам, вероятно, не понадобятся более длинные URL-адреса, если только вы не создаете сложные карты с большим количеством маркеров и путей.

Использование параметра

Maps Static API относительно прост в использовании, поскольку он состоит исключительно из параметризованного URL-адреса. В этом разделе объясняется, как использовать эти параметры для создания URL-адресов.

Указание местоположений

Maps Static API должен иметь возможность точно определять местоположения на карте, чтобы сфокусировать карту на правильном месте (с помощью параметра center ) и/или разместить любые дополнительные метки (с использованием параметра markers ) в местах на карте. Maps Static API использует числа (значения широты и долготы) или строки (адреса) для указания этих местоположений. Эти значения определяют геокодированное местоположение.

Некоторые параметры (например, markers и параметры path ) занимают несколько мест. В этих случаях местоположения разделяются символом вертикальной черты ( | ).

Широта и долгота

Широта и долгота определяются с помощью цифр в текстовой строке, разделенной запятыми, с точностью до 6 знаков после запятой. Например, «40.714728,-73.998672» — допустимое значение геокода. Точность за пределами 6 десятичных знаков игнорируется.

Значения долготы основаны на расстоянии от Гринвича, Англия, где находится нулевой меридиан. Поскольку Гринвич расположен на широте 51,477222, мы можем ввести значение center 51.477222,0 , чтобы центрировать карту по Гринвичу:

Гринвич, Англия

Значения широты и долготы должны соответствовать допустимому местоположению на земном шаре. Широта может принимать любое значение от -90 до 90 , а значение долготы может принимать любое значение от -180 до 180 . Если вы укажете неверное значение широты или долготы, ваш запрос будет отклонен как неверный.

Адреса

Большинство людей не говорят о широте и долготе; они обозначают местоположения, используя адреса . Процесс преобразования адреса в географическую точку называется геокодированием , и служба Maps Static API может выполнить геокодирование за вас, если вы предоставите действительные адреса.

В любом параметре, где вы можете указать широту/долготу, вы можете вместо этого указать строку, указывающую адрес . Google геокодирует адрес и предоставит службе Maps Static API значение широты и долготы для использования при размещении маркеров или указании местоположений. Строка должна иметь URL-кодировку , поэтому такие адреса, как «Сити-Холл, Нью-Йорк, Нью-Йорк», следует преобразовать, например, в «Сити+Холл,Нью+Йорк,Нью-Йорк».

Обратите внимание, что адреса могут отражать либо точные местоположения, например адреса улиц, ломаные линии, например именованные маршруты, либо полигональные области, например города, страны или национальные парки. Для полилинейных и полигональных результатов сервер Maps Static API будет использовать центральную точку линии/площади в качестве центра адреса. Если у вас есть сомнения относительно того, как адрес может быть геокодирован, вы можете проверить его с помощью этой утилиты геокодирования .

В следующем примере создается статическое изображение карты Беркли, Калифорния:

https://maps.googleapis.com/maps/api/staticmap?center=Berkeley,CA&zoom=14&size=400x400&key=YOUR_API_KEY&signature=YOUR_SIGNATURE

Беркли, Калифорния

Уровни масштабирования

Карты на Картах Google имеют целочисленный «уровень масштабирования», который определяет разрешение текущего вида. В режиме roadmap по умолчанию возможны уровни масштабирования от 0 (самый низкий уровень масштабирования, при котором весь мир можно увидеть на одной карте) до 21+ (вплоть до улиц и отдельных зданий). Контуры зданий, если они доступны, появляются на карте при уровне масштабирования 17 . Это значение отличается от региона к региону и может меняться со временем по мере развития данных.

Карты Google устанавливают уровень масштабирования 0 , чтобы охватить всю Землю. Каждый последующий уровень масштабирования удваивает точность как по горизонтали, так и по вертикали. Дополнительную информацию о том, как это делается, можно найти в документации Google Maps JavaScript API .

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

Если вы отправите запрос на уровень масштабирования, при котором нет фрагментов карты, Maps Static API вместо этого вернет пустое изображение.

В следующем списке показан приблизительный уровень детализации, который вы можете ожидать при каждом уровне масштабирования:

  • 1: Мир
  • 5: Суша/континент
  • 10: Город
  • 15: Улицы
  • 20: Здания

В этом примере запрашиваются две карты Манхэттена с одинаковым значением center , но с уровнями масштабирования 12 и 14 соответственно:

https://maps.googleapis.com/maps/api/staticmap?center=40.714728,-73.998672&zoom=12&size=400x400&key=YOUR_API_KEY&signature=YOUR_SIGNATURE
https://maps.googleapis.com/maps/api/staticmap?center=40.714728,-73.998672&zoom=14&size=400x400&key=YOUR_API_KEY&signature=YOUR_SIGNATURE

Манхэттен ДалекийМанхэттен вблизи

Размеры изображения

Параметр size в сочетании с center определяет зону покрытия карты. Он также определяет выходной размер карты в пикселях при умножении на значение scale (по умолчанию равное 1 ).

В этой таблице показаны максимально допустимые значения параметра size для каждого значения scale .

scale=1 scale=2
640x640 640x640 (возвращает 1280x1280 пикселей)

В этом примере запрашивается «срез» Земли на экваторе при уровне масштабирования 1:

https://maps.googleapis.com/maps/api/staticmap?center=0,0&zoom=1&size=400x50&key=YOUR_API_KEY&signature=YOUR_SIGNATURE

Экватор

В этом примере запрашивается небольшая карта размером 100 x 100 пикселей с центром в том же регионе. Обратите внимание на меньший логотип Google:

https://maps.googleapis.com/maps/api/staticmap?center=0,0&zoom=1&size=100x100&key=YOUR_API_KEY&signature=YOUR_SIGNATURE

Малая карта экватора

Масштабные значения

Параметр size Maps Static API определяет размер карты в пикселях, поэтому карта с size=200x200 будет возвращена как 200 пикселей на 200 пикселей. На ЖК-мониторе компьютера, который обычно отображает около 100 пикселей на дюйм (ppi), карта размером 200x200 будет иметь размер около 2 дюймов в каждом измерении.

Однако мобильные устройства все чаще включают в себя экраны высокого разрешения с плотностью пикселей более 300 пикселей на дюйм, которые либо:

  • Уменьшите размер изображения 200x200 пикселей всего до 0,7 дюйма, в результате чего метки и значки станут слишком маленькими для чтения; или
  • Масштабируйте (увеличьте) изображение, чтобы улучшить его разборчивость, в результате чего изображение становится нечетким или пиксельным.
Слишком маленький Слишком нечетко

При разработке для мобильных устройств вы можете использовать параметр scale API, чтобы возвращать изображения карт с более высоким разрешением, которые решают описанные выше проблемы. Значение scale умножается на size для определения фактического выходного размера изображения в пикселях без изменения зоны покрытия карты. Значение scale по умолчанию — 1; принятые значения — 1 и 2.

Например, значение масштаба 2 вернет ту же зону покрытия карты, что и запрос, без указания масштаба, но с вдвое большим количеством пикселей в каждом измерении. Сюда входят дороги и метки, чтобы они были читаемы на экранах небольшого размера с высоким разрешением, а также при масштабировании в браузере.

150х150 150x150&масштаб=2

Такое изображение также будет хорошо работать в настольных браузерах, если его вставить в тег img или div с высотой и шириной, заданными с помощью CSS. Браузер уменьшит изображение до нужного размера без потери качества.

В этой таблице показаны три разных запроса изображений.

  • Первый предназначен для изображения размером 100x100 без указания значения масштаба. Он правильно отображается на рабочем столе, но слишком мал для чтения на мобильном устройстве.
  • Второй удваивает размер карты. На рабочем столе CSS помещает его в указанный элемент img размером 100x100, но при уменьшении размера изображения дороги и метки становятся слишком маленькими. На мобильном устройстве изображение правильного размера, но дороги и надписи опять же неразборчивы.
  • Третий запрос — карта размером 100x100 с scale=2 . Изображение возвращается с детализацией 200 пикселей; настольный компьютер идеально масштабирует его, так что он неотличим от исходного запроса 100x100, а мобильный браузер получает выгоду от дополнительного разрешения, возвращаемого API.
Запросы изображений
Устройство 100x100 200x200 100x100&scale=2
Рабочий стол
height="100px" и
width="100px" на
тег img )
Высокое разрешение
(смоделировано)

Для получения дополнительной информации о разработке для мобильных устройств и дисплеев с высоким разрешением рекомендуется прочитать следующее:

Форматы изображений

Изображения могут быть возвращены в нескольких распространенных форматах веб-графики: GIF , JPEG и PNG . Параметр format принимает одно из следующих значений:

  • png8 или png (по умолчанию) задает 8-битный формат PNG .
  • png32 определяет 32-битный формат PNG .
  • gif указывает формат GIF .
  • jpg указывает формат сжатия JPEG .
  • jpg-baseline определяет непрогрессивный формат сжатия JPEG .

В этих примерах запрашиваются карты в форматах gif и png :

  https://maps.googleapis.com/maps/api/staticmap?center=40.714728,-73.998672&format=gif&zoom=14&size=400x400&key=YOUR_API_KEY&signature=YOUR_SIGNATURE
  https://maps.googleapis.com/maps/api/staticmap?center=40.714728,-73.998672&format=png&&zoom=14&size=400x400&key=YOUR_API_KEY&signature=YOUR_SIGNATURE

jpg и jpg-baseline обычно обеспечивают наименьший размер изображения, хотя они делают это за счет сжатия с потерями, которое может ухудшить изображение. gif , png8 и png32 обеспечивают сжатие без потерь.

Большинство изображений JPEG являются прогрессивными, что означает, что они загружают более грубое изображение раньше и улучшают разрешение изображения по мере поступления большего количества данных. Это позволяет быстро загружать изображения на веб-страницы и в настоящее время является наиболее распространенным вариантом использования JPEG. Однако некоторые варианты использования JPEG требуют непрогрессивных (базовых) изображений. В таких случаях вы можете использовать jpg-baseline , который не является прогрессивным.

Типы карт

Maps Static API создает карты в нескольких форматах, перечисленных ниже:

  • roadmap (по умолчанию) определяет стандартное изображение дорожной карты, которое обычно отображается на веб-сайте Google Maps. Если значение maptype не указано, Maps Static API по умолчанию отображает фрагменты roadmap .
  • satellite указывает спутниковое изображение.
  • terrain определяет изображение карты физического рельефа, показывающее местность и растительность.
  • hybrid определяет гибрид спутникового изображения и изображения дорожной карты, показывая прозрачный слой основных улиц и названий мест на спутниковом изображении.

В этом примере кода вы можете увидеть разницу между дорожной картой и типами ландшафта.

https://maps.googleapis.com/maps/api/staticmap?center=40.714728,-73.998672&zoom=12&size=400x400&maptype=roadmap&key=YOUR_API_KEY&signature=YOUR_SIGNATURE
https://maps.googleapis.com/maps/api/staticmap?center=40.714728,-73.998672&zoom=12&size=400x400&maptype=terrain&key=YOUR_API_KEY&signature=YOUR_SIGNATURE

Нормальная карта МанхэттенаКарта местности Манхэттена

Гибридные карты используют спутниковые изображения и важные элементы дорожной карты для создания комбинированной карты. В следующих примерах показаны типы спутниковых и гибридных карт:

https://maps.googleapis.com/maps/api/staticmap?center=40.714728,-73.998672&zoom=12&size=400x400&maptype=satellite&key=YOUR_API_KEY&signature=YOUR_SIGNATURE
https://maps.googleapis.com/maps/api/staticmap?center=40.714728,-73.998672&zoom=12&size=400x400&maptype=hybrid&key=YOUR_API_KEY&signature=YOUR_SIGNATURE

Спутниковая карта МанхэттенаКарта местности Манхэттена

Стилизованные карты

Настройте представление стандартной карты Google, применив собственные стили. См. руководство по стилизованным картам .

Маркеры

Параметр markers определяет набор из одного или нескольких маркеров (отметок на карте) в наборе мест. Каждый маркер, определенный в одном объявлении markers , должен иметь один и тот же визуальный стиль; Если вы хотите отображать маркеры с разными стилями, вам нужно будет предоставить нескольким параметрам markers отдельную информацию о стиле.

Параметр markers принимает набор назначений значений ( дескрипторов маркеров ) следующего формата:

markers= markerStyles | markerLocation1 | markerLocation2 |... и т. д.

Набор маркерных стилей объявляется в начале объявления markers и состоит из нуля или более дескрипторов стилей, разделенных символом вертикальной черты ( | ), за которыми следует набор из одного или нескольких мест, также разделенных символом вертикальной черты ( | ).

Поскольку и информация о стиле, и информация о местоположении разделяются символом вертикальной черты, информация о стиле должна появляться первой в любом дескрипторе маркера. Как только сервер Maps Static API обнаруживает местоположение в дескрипторе маркера, все остальные параметры маркера также считаются местоположениями.

Стили маркеров

Набор дескрипторов стилей маркеров представляет собой серию присвоений значений, разделенных символом вертикальной черты ( | ). Этот дескриптор стиля определяет визуальные атрибуты, которые будут использоваться при отображении маркеров в этом дескрипторе маркера. Эти дескрипторы стиля содержат следующие назначения ключей и значений:

  • size: (необязательно) определяет размер маркера из набора {tiny, mid, small} . Если параметр size не задан, маркер будет отображаться в размере по умолчанию (нормальном).
  • color: (необязательно) определяет 24-битный цвет (пример: color=0xFFFFCC ) или предопределенный цвет из набора {black, brown, green, purple, yellow, blue, gray, orange, red, white} .

    Обратите внимание, что прозрачности (задаваемые с использованием 32-битных шестнадцатеричных значений цвета) не поддерживаются в маркерах, но поддерживаются для путей.

  • label : (необязательно) указывает один буквенно -цифровой символ в верхнем регистре из набора {AZ, 0–9}. (Требование к использованию символов верхнего регистра является новым для этой версии API.) Обратите внимание, что маркеры по умолчанию и mid размера — единственные маркеры, способные отображать alphanumeric-character параметры. tiny и small маркеры не способны отображать буквенно-цифровые символы.

Масштабирование маркера

Значение scale умножается на размер изображения маркера, чтобы получить фактический выходной размер маркера в пикселях. Значение шкалы по умолчанию — 1; принятые значения: 1, 2 и 4.

Ограничение размера изображений в пикселях применяется после применения масштабирования. Например, если для маркера установлено значение scale:2 , то размер маркера может превышать максимальный размер в 4096 пикселей, если после масштабирования он уменьшится до менее 4096 пикселей. Используйте масштабирование маркеров в сочетании с масштабированием карты при отображении карт с более высоким разрешением.

Расположение маркеров

Каждый дескриптор маркера должен содержать набор из одного или нескольких мест, определяющих, где разместить маркер на карте. Эти местоположения могут быть указаны либо как значения широты/долготы, либо как адреса . Эти местоположения разделяются вертикальной чертой ( | ).

Примечание . Если вы решите указать местоположения маркеров, используя метод, требующий геокодирования, например удобочитаемые адресные строки или полилинии, запрос будет ограничен максимум 15 маркерами. Это ограничение применяется только к местоположениям маркеров, требующим геокодирования. Это не применяется к местоположениям маркеров, указанным в координатах широты и долготы.

Параметры местоположения определяют местоположение маркера на карте. Если местоположение находится за пределами карты, этот маркер не появится на построенном изображении при условии, что указаны параметры center и zoom . Однако если эти параметры не указаны, сервер Maps Static API автоматически создаст изображение, содержащее предоставленные маркеры. (См. Неявное позиционирование .)

Здесь показан образец объявления маркера. Обратите внимание, что мы определяем один набор стилей и три местоположения:

https://maps.googleapis.com/maps/api/staticmap?center=Williamsburg,Brooklyn,NY&zoom=13&size=400x400&
markers=color:blue%7Clabel:S%7C11211%7C11206%7C11222&key=YOUR_API_KEY&signature=YOUR_SIGNATURE

Три почтовых индекса Бруклина

Чтобы определить маркеры с разными стилями, нам необходимо указать несколько параметров markers . Этот набор параметров markers определяет три маркера: один синий маркер с надписью «S» в точке 62.107733, -145.5419, один крошечный зеленый маркер в точке «Delta Junction, AK» и один желтый маркер среднего размера с надписью «C» в точке «Tok, AK». ". Эти маркеры показаны в этом примере:

https://maps.googleapis.com/maps/api/staticmap?center=63.259591,-144.667969&zoom=6&size=400x400
&markers=color:blue%7Clabel:S%7C62.107733,-145.541936&markers=size:tiny%7Ccolor:green%7CDelta+Junction,AK
&markers=size:mid%7Ccolor:0xFFFF00%7Clabel:C%7CTok,AK"&key=YOUR_API_KEY&signature=YOUR_SIGNATURE

Три города Аляски, разные маркеры

Пользовательские значки

Вместо использования значков маркеров Google вы можете использовать свои собственные значки. Пользовательские значки задаются с помощью дескриптора icon в параметре markers . Например:

markers=icon: URLofIcon | markerLocation

Укажите icon , используя URL-адрес (который должен быть закодирован в URL-адресе ). Вы можете использовать URL-адреса, созданные службами сокращения URL-адресов, например https://goo.gl . Большинство сервисов сокращения URL-адресов имеют преимущество автоматического кодирования URL-адресов.

Вы можете указать точку привязки для пользовательского значка. Точка привязки задает расположение значка относительно указанных местоположений markers . По умолчанию опорной точкой пользовательского значка является центральная нижняя часть изображения значка. Вы можете указать другую точку привязки, используя дескриптор anchor в сочетании со icon . Установите anchor в виде точки X,Y значка (например, 10,5 ) или в качестве предопределенного выравнивания, используя одно из следующих значений: top , bottom , left , right , center , topleft , topright , bottomleft или bottomright . Например:

markers=anchor:bottomright|icon: URLofIcon | markerLocation1 | markerLocation2

Вы можете использовать до пяти уникальных значков для каждого запроса. Это ограничение не означает, что вы ограничены только пятью отмеченными местами на карте. Каждый уникальный значок может использоваться с несколькими markers на вашей карте.

Формат значка:

  • Изображения значков могут быть в форматах PNG, JPEG или GIF, но рекомендуется PNG.
  • Максимальный размер значков может достигать 4096 пикселей (64x64 для квадратных изображений).
Примеры пользовательских значков

В примере 1 создаются пользовательские значки и позиционируются значки с помощью привязок.

https://maps.googleapis.com/maps/api/staticmap?&size=600x400&style=visibility:on
&style=feature:water%7Celement:geometry%7Cvisibility:on
&style=feature:landscape%7Celement:geometry%7Cvisibility:on
&markers=anchor:32,10%7Cicon:https://goo.gl/5y3S82%7CCanberra+ACT
&markers=anchor:topleft%7Cicon:http://tinyurl.com/jrhlvu6%7CMelbourne+VIC
&markers=anchor:topright%7Cicon:https://goo.gl/1oTJ9Y%7CSydney+NSW&key=YOUR_API_KEY
&signature=YOUR_SIGNATURE

Три австралийских города, разные нестандартные значки с якорями.

В примере 2 создаются те же пользовательские значки, что и в примере 1, но не задаются положения значков с помощью привязок, а используется привязка по умолчанию в центре нижней части.

https://maps.googleapis.com/maps/api/staticmap?&size=600x400&style=visibility:on
&style=feature:water%7Celement:geometry%7Cvisibility:on
&style=feature:landscape%7Celement:geometry%7Cvisibility:on
&markers=icon:https://goo.gl/5y3S82%7CCanberra+ACT
&markers=icon:http://tinyurl.com/jrhlvu6%7CMelbourne+VIC
&markers=icon:https://goo.gl/1oTJ9Y%7CSydney+NSW&key=YOUR_API_KEY&signature=YOUR_SIGNATURE

Три австралийских города, разные значки с расположением по умолчанию.

Пути статического API карт

Параметр path определяет набор из одного или нескольких местоположений, соединенных путем, для наложения на изображение карты. Параметр path принимает набор назначений значений ( дескрипторов пути ) следующего формата:

path= pathStyles | pathLocation1 | pathLocation2 |... и т. д.

Обратите внимание, что обе точки пути отделены друг от друга символом вертикальной черты ( | ). Поскольку и информация о стиле, и информация о точках разделяются символом вертикальной черты, информация о стиле должна появляться первой в любом дескрипторе пути. Как только сервер Maps Static API обнаруживает местоположение в дескрипторе пути, все остальные параметры пути также считаются местоположениями.

Стили пути

Набор дескрипторов стиля пути представляет собой серию присвоений значений, разделенных символом вертикальной черты ( | ). Этот дескриптор стиля определяет визуальные атрибуты, которые будут использоваться при отображении пути. Эти дескрипторы стиля содержат следующие назначения ключей и значений:

  • weight: (необязательно) определяет толщину пути в пикселях. Если параметр weight не установлен, путь будет иметь толщину по умолчанию (5 пикселей).
  • color: (необязательно) определяет цвет в виде 24-битного (пример: color=0xFFFFCC ) или 32-битного шестнадцатеричного значения (пример: color=0xFFFFCCFF ) или из набора {black, brown, green, purple, yellow, blue, gray, orange, red, white} .

    Если указано 32-битное шестнадцатеричное значение, последние два символа определяют 8-битное значение альфа-прозрачности. Это значение варьируется от 00 (полностью прозрачный) до FF (полностью непрозрачный). Обратите внимание, что прозрачность поддерживается в путях, но не поддерживается для маркеров.

  • fillcolor : (необязательно) указывает, что путь отмечает многоугольную область, и указывает цвет заливки, который будет использоваться в качестве наложения внутри этой области. Следующий набор локаций не обязательно должен быть «замкнутым» циклом; Сервер Maps Static API автоматически соединит первую и последнюю точки. Однако обратите внимание, что любой штрих на внешней стороне закрашенной области не будет закрыт, если вы специально не укажете одно и то же начальное и конечное местоположение.
  • geodesic : (необязательно) указывает, что запрошенный путь следует интерпретировать как геодезическую линию, повторяющую кривизну Земли. Если установлено значение false, путь отображается как прямая линия в пространстве экрана. По умолчанию ложь.

Некоторые примеры определений путей:

  • Тонкая синяя линия, непрозрачность 50 %: path=color:0x0000ff80|weight:1
  • Сплошная красная линия: path=color:0xff0000ff|weight:5
  • Сплошная толстая белая линия: path=color:0xffffffff|weight:10

Эти стили пути являются необязательными. Если желательны атрибуты по умолчанию, вы можете пропустить определение атрибутов пути; в этом случае первый «аргумент» дескриптора пути будет состоять из первой объявленной точки (местоположения).

Точки пути

Чтобы нарисовать путь, параметру path также необходимо передать две или более точки. Затем Maps Static API соединит путь вдоль этих точек в указанном порядке. Каждый pathPoint обозначается в pathDescriptor , разделенном символом | (труба) характер.

В следующем примере определяется синий путь с непрозрачностью по умолчанию 50 % от Юнион-сквер, штат Нью-Йорк, до Таймс-сквер, штат Нью-Йорк.

Путь от Юнион-сквер до Таймс-сквер

Особенности параметра path :

path=color:0x0000ff|weight:5|40.737102,-73.990318|40.749825,-73.987963|40.752946,-73.987384|40.755823,-73.986397

В следующем примере определяется тот же путь, а не сплошная красная линия со 100% непрозрачностью:

Путь от Юнион-сквер до Таймс-сквер

Особенности этого параметра path :

path=color:0xff0000ff|weight:5|40.737102,-73.990318|40.749825,-73.987963|40.752946,-73.987384|40.755823,-73.986397

В следующем примере определяется многоугольная область на Манхэттене, через которую в качестве местоположений проходит ряд пересечений:

Путь от Юнион-сквер до Таймс-сквер

Особенности этого параметра path :

path=color:0x00000000|weight:5|fillcolor:0xFFFF0033|8th+Avenue+%26+34th+St,New+York,NY|\
8th+Avenue+%26+42nd+St,New+York,NY|Park+Ave+%26+42nd+St,New+York,NY,NY|\
Park+Ave+%26+34th+St,New+York,NY,NY

Обратите внимание, что мы сделали сам путь невидимым, а непрозрачность многоугольной области — 15%.

Закодированные полилинии

Вместо серии местоположений вы можете объявить путь как закодированную ломаную линию , используя префикс enc: в объявлении местоположения path .

В следующем примере показан маршрут шоссе Аляски от Доусон-Крик, Британская Колумбия, до Дельта-Джанкшен, штат АК, с помощью закодированной полилинии:

https://maps.googleapis.com/maps/api/staticmap
?size=400x400&center=59.900503,-135.478011&zoom=4
&path=weight:3%7Ccolor:orange%7Cenc:_fisIp~u%7CU}%7Ca@pytA_~b@hhCyhS~hResU%7C%7Cx@oig@rwg@amUfbjA}f[roaAynd@%7CvXxiAt{ZwdUfbjAewYrqGchH~vXkqnAria@c_o@inc@k{g@i`]o%7CF}vXaj\h`]ovs@?yi_@rcAgtO%7Cj_AyaJren@nzQrst@zuYh`]v%7CGbldEuzd@%7C%7Cx@spD%7CtrAzwP%7Cd_@yiB~vXmlWhdPez\_{Km_`@~re@ew^rcAeu_@zhyByjPrst@ttGren@aeNhoFemKrvdAuvVidPwbVr~j@or@f_z@ftHr{ZlwBrvdAmtHrmT{rOt{Zz}E%7Cc%7C@o%7CLpn~AgfRpxqBfoVz_iAocAhrVjr@rh~@jzKhjp@``NrfQpcHrb^k%7CDh_z@nwB%7Ckb@a{R%7Cyh@uyZ%7CllByuZpzw@wbd@rh~@%7C%7CFhqs@teTztrAupHhyY}t]huf@e%7CFria@o}GfezAkdW%7C}[ocMt_Neq@ren@e~Ika@pgE%7Ci%7CAfiQ%7C`l@uoJrvdAgq@fppAsjGhg`@%7ChQpg{Ai_V%7C%7Cx@mkHhyYsdP%7CxeA~gF%7C}[mv`@t_NitSfjp@c}Mhg`@sbChyYq}e@rwg@atFff}@ghN~zKybk@fl}A}cPftcAite@tmT__Lha@u~DrfQi}MhkSqyWivIumCria@ciO_tHifm@fl}A{rc@fbjAqvg@rrqAcjCf%7Ci@mqJtb^s%7C@fbjA{wDfs`BmvEfqs@umWt_Nwn^pen@qiBr`xAcvMr{Zidg@dtjDkbM%7Cd_@
&key=YOUR_API_KEY&signature=YOUR_SIGNATURE

Аляска шоссе

Как и в случае со стандартными путями, закодированные полилинейные пути также могут разграничивать полигональные области, если параметру path передается аргумент fillcolor .

В следующем примере показана полигональная область для Бруклина, штат Нью-Йорк:

https://maps.googleapis.com/maps/api/staticmap
?size=400x400&center=40.653279,-73.959816&zoom=11
&path=fillcolor:0xAA000033%7Ccolor:0xFFFFFF00%7Cenc:}zswFtikbMjJzZ%7CRdPfZ}DxWvBjWpF~IvJnEvBrMvIvUpGtQpFhOQdKpz@bIx{A%7CPfYlvApz@bl@tcAdTpGpVwQtX}i@%7CGen@lCeAda@bjA%60q@v}@rfAbjA%7CEwBpbAd_@he@hDbu@uIzWcWtZoTdImTdIwu@tDaOXw_@fc@st@~VgQ%7C[uPzNtA%60LlEvHiYyLs^nPhCpG}SzCNwHpz@cEvXg@bWdG%60]lL~MdTmEnCwJ[iJhOae@nCm[%60Aq]qE_pAaNiyBuDurAuB }}Ay%60@%7CEKv_@?%7C[qGji@lAhYyH%60@Xiw@tBerAs@q]jHohAYkSmW?aNoaAbR}LnPqNtMtIbRyRuDef@eT_z@mW_Nm%7CB~j@zC~hAyUyJ_U{Z??cPvg@}s@sHsc@_z@cj@kp@YePoNyYyb@_iAyb@gBw^bOokArcA}GwJuzBre@i\tf@sZnd@oElb@hStW{]vv@??kz@~vAcj@zKa%60Atf@uQj_Aee@pU_UrcA
&key=YOUR_API_KEY&signature=YOUR_SIGNATURE

Бруклинская кодированная полилиния с подписью

Обзорные экраны

Изображения могут указывать область просмотра , указав видимые местоположения с помощью visible . visible параметр указывает службе Maps Static API создать карту, на которой существующие местоположения остаются видимыми. (Этот параметр также можно комбинировать с существующими маркерами или путями для определения видимой области.) Определение области просмотра таким образом избавляет от необходимости указывать точный уровень масштабирования.

В следующем примере запрашивается карта с центром в Бостоне, Массачусетс, содержащая как Массачусетский технологический институт, так и Гарвардскую площадь в Кембридже, Массачусетс:

https://maps.googleapis.com/maps/api/staticmap?center=Boston,MA
&visible=77+Massachusetts+Ave,Cambridge,MA%7CHarvard+Square,Cambridge,MA&size=512x512&key=YOUR_API_KEY&signature=YOUR_SIGNATURE

Карта Кембриджа

Неявное позиционирование карты

Обычно вам необходимо указать параметры URL-адреса center и zoom , чтобы определить местоположение и уровень масштабирования созданной карты. Однако если вы указываете markers , path или visible параметры, вместо этого вы можете позволить Maps Static API неявно определять правильный центр и уровень масштабирования на основе оценки положения этих элементов.

При предоставлении двух или более элементов Maps Static API определит правильный центр и уровень масштабирования, предоставив большие поля для содержащихся элементов. В этом примере отображается карта, содержащая Сан-Франциско, Окленд и Сан-Хосе, Калифорния:

https://maps.googleapis.com/maps/api/staticmap?size=512x512&maptype=roadmap\
&markers=size:mid%7Ccolor:red%7CSan+Francisco,CA%7COakland,CA%7CSan+Jose,CA&key=YOUR_API_KEY&signature=YOUR_SIGNATURE

Дорожная карта

Большие размеры изображений

Если вам нужны изображения размером более 640 x 640 пикселей (или 1280 x 1280 пикселей со значением масштаба 2), обратитесь в службу поддержки и предоставьте следующую информацию:

  1. Ваш вариант использования и почему вам нужны изображения большого размера.
  2. Рассматривали ли вы возможность использования других API-интерфейсов платформы Google Maps (API JavaScript Maps, API Maps Embed, Maps SDK для Android или Maps SDK для iOS) и почему они не соответствуют вашим потребностям.
  3. Скриншоты, макеты или примеры того, как вы будете использовать изображения большого размера.
  4. Примерное ежемесячное использование изображений большого размера.

Мы рассмотрим ваш запрос на основе предоставленной вами информации и определим, соответствует ли ваш вариант использования Условиям использования платформы Google Карт .

Максимальный размер, который мы можем предоставить, составляет 2048 x 2048 пикселей.

Устранение неполадок и поддержка

Дополнительную информацию об использовании Maps Static API можно найти на странице поддержки .

Maps Static API может выдать ошибку или предупреждение, если что-то пойдет не так. Вам следует проверить наличие предупреждений, особенно если вы заметили, что на карте чего-то не хватает. Также рекомендуется проверять наличие предупреждений перед запуском нового приложения. Обратите внимание, что предупреждения могут быть не сразу заметны, поскольку они появляются в заголовке HTTP. Дополнительную информацию см. в руководстве по ошибкам и предупреждениям .

,

Введение

Maps Static API возвращает изображение (GIF, PNG или JPEG) в ответ на HTTP-запрос через URL-адрес. Для каждого запроса вы можете указать местоположение карты, размер изображения, уровень масштабирования, тип карты и размещение дополнительных маркеров в местах на карте. Вы можете дополнительно пометить свои маркеры, используя буквенно -цифровые символы.

Статическое изображение API MAPS встроено в атрибут src <img> TAG или его эквивалент в других языках программирования.

В этом документе описывается необходимый формат карт статических URL -адресов API и доступных параметров. Это также указывает на несколько советов и хитростей при указании ваших URL -адресов.

Прежде чем вы начнете

Этот документ предназначен для разработчиков веб -сайтов и мобильных устройств, которые хотят включить карты Static API -изображения в веб -страницу или мобильное приложение. Он обеспечивает введение в использование API и справочного материала в доступных параметрах.

Прежде чем начать разработку с помощью Static API MAPS, просмотрите требования к аутентификации (вам нужен ключ API), а также информацию об использовании API и выставление счетов (вам необходимо включить выставление счетов по вашему проекту).

Параметры URL

Статический URL карты должен быть следующей формы:

https://maps.googleapis.com/maps/api/staticmap?parameters

Если ваш веб -сайт доступен по HTTPS, вы должны загружать карты статических изображений API по HTTPS, чтобы избежать оповещений о безопасности браузеров. HTTPS также рекомендуется, если ваши запросы включают конфиденциальную информацию пользователя, такую ​​как местоположение пользователя:

https://maps.googleapis.com/maps/api/staticmap?parameters

Используя ли HTTP или HTTPS, требуются определенные параметры URL -адреса, а некоторые - необязательны. Как и стандарт в URL, все параметры разделены с использованием символа Ampersand ( & ). Список параметров и их возможных значений перечислены в этом документе.

Статический API MAPS определяет изображения MAP, используя следующие параметры URL:

Параметры местоположения

  • center ( требуется , если маркеры не присутствуют) определяет центр карты, равную от всех краев карты. Этот параметр занимает место в качестве пары, разделенной в запятой {широте, долготы} (например, «40,714728, -73,998672») или строкового адреса (например, мэрия, Нью-Йорк, Нью-Йорк »), определяющий уникальное место на лице Земля. Для получения дополнительной информации см. Локации .
  • zoom ( требуется , если маркеры не присутствуют) определяет уровень масштабирования карты, который определяет уровень увеличения карты. Этот параметр требует численного значения, соответствующего уровню увеличения желаемой области. Для получения дополнительной информации см. Уровни увеличения .

Параметры карты

  • size ( требуется ) определяет прямоугольные размеры изображения карты. Этот параметр принимает строку формы {horizontal_value} x {vertical_value} . Например, 500x400 определяет карту шириной 500 пикселей высотой 400 пикселей. Карты меньше 180 пикселей в ширине будут отображать логотип Google уменьшенного размера. Этот параметр влияет параметр scale ; Окончательный размер выхода - это продукт размера и значений масштаба.
  • scale ( необязательно ) влияет на количество возвращаемых пикселей. scale=2 возвращает вдвое больше пикселей, чем scale=1 , сохраняя одну и ту же область покрытия и уровень детализации (то есть содержимое карты не изменяется). Это полезно при разработке для дисплеев высокого разрешения. Значение по умолчанию составляет 1 . Принятые значения 1 и 2 . См. Значения масштаба для получения дополнительной информации.
  • format ( необязательно ) определяет формат полученного изображения. По умолчанию Static API MAPS создает изображения PNG. Есть несколько возможных форматов, включая типы GIF, JPEG и PNG. Какой формат вы используете, зависит от того, как вы собираетесь представить изображение. JPEG обычно обеспечивает большую сжатие, в то время как GIF и PNG предоставляют более подробную информацию. Для получения дополнительной информации см. Форматы изображений.
  • maptype ( необязательно ) определяет тип карты для построения. Есть несколько возможных значений маптипа, включая roadmap , satellite , hybrid и terrain . Для получения дополнительной информации см. Карты Static API Maptypes .
  • language ( необязательно ) определяет язык для отображения меток на карте плитки. Обратите внимание, что этот параметр поддерживается только для некоторых страновых плиток; Если запрашиваемый конкретный язык не поддерживается для набора плиток, то будет использоваться язык по умолчанию для этого плитки.
  • region ( необязательно ) определяет соответствующие границы для отображения, на основе геополитической чувствительности. Принимает код региона, указанный как двуххарактерное значение CCTLD («домен верхнего уровня»). См. Детали освещения платформы Google Maps для поддерживаемых регионов.

Параметры функции

  • map_id ( необязательно ) Указывает идентификатор для определенной карты. Идентификатор карты связывает карту с определенным стилем или функцией и должен принадлежать тому же проекту, что и ключ API, используемый для инициализации карты. Для получения дополнительной информации см. Использование идентификаторов карты .
  • markers ( необязательно ) Определите один или несколько маркеров для подключения к изображению в указанных местах. Этот параметр берет одно определение маркера с параметрами, разделенными символом трубы ( | ). Несколько маркеров могут быть размещены в одном параметре markers , если они демонстрируют тот же стиль; Вы можете добавить дополнительные маркеры различных стилей, добавив параметры дополнительных markers . Обратите внимание, что если вы поставляете маркеры для карты, вам не нужно указывать (обычно требуемый) center и параметры zoom . Для получения дополнительной информации см. Карты статических маркеров API .
  • path ( необязательно ) определяет один путь двух или более подключенных точек для наложения на изображение в указанных местах. Этот параметр принимает строку определений точек, разделенных символом трубы ( | ), или кодируемой полилинией, используя предварительную службу enc: PREFIX в рамках объявления местоположения пути. Вы можете предоставить дополнительные пути, добавив дополнительные параметры path . Обратите внимание, что если вы предоставляете путь для карты, вам не нужно указывать (обычно требуемый) center и параметры zoom . Для получения дополнительной информации см. Карты Static API -пути .
  • visible ( необязательно ) указывает одно или несколько мест , которые должны оставаться видимыми на карте, хотя маркеры или другие показатели не будут отображаться. Используйте этот параметр, чтобы убедиться, что определенные функции или местоположения карты показаны на статическом API карт.
  • style ( необязательно ) определяет пользовательский стиль, чтобы изменить представление конкретной функции (дороги, парки и другие функции) карты. Этот параметр принимает аргументы feature и element , идентифицирующие функции в стиле, и набор операций стиля для применения к выбранным функциям. Вы можете предоставить несколько стилей, добавив дополнительные параметры style . Для получения дополнительной информации см. Руководство по картам стиля .

Ключевые и подписи параметры

  • key ( требуется ) позволяет отслеживать использование API вашего приложения в облачной консоли Google и гарантирует, что Google сможет связаться с вами по поводу вашего приложения, если это необходимо. Для получения дополнительной информации см. Используйте клавиши API с картами Static API .
  • signature ( рекомендуется ) - это цифровая подпись, используемая для проверки того, что любые запросы, генерирующие сайт с использованием вашего ключа API, разрешено для этого. Запросы без цифровой подписи могут потерпеть неудачу. Для получения дополнительной информации см. Цифровую подпись .

Ограничение размера URL

Карты статических URL -адресов API ограничены размером 16384. На практике у вас, вероятно, не будет необходимости в URL -адресах дольше, чем это, если вы не произведете сложные карты с большим количеством маркеров и путей.

Использование параметров

Статический API карт относительно прост в использовании, поскольку он состоит исключительно из параметризованного URL. В этом разделе объясняется, как использовать эти параметры для построения ваших URL -адресов.

Определение местоположений

Статический API MAPS должен быть в состоянии точно идентифицировать местоположения на карте, чтобы сосредоточить карту в правильном месте (с использованием center параметра) и/или размещать любые дополнительные размещения (используя параметр markers ) в местах на карте. Статический API MAPS использует числа (значения широты и долготы) или строки (адреса) для указания этих местоположений. Эти значения идентифицируют геокодированное местоположение.

Несколько параметров (такие как markers и параметры path ) занимают несколько мест. В этих случаях местоположения разделены характером трубы ( | ).

Широты и долготы

Широты и долготы определяются с использованием цифр в текстовой строке, разделенной запятыми, которые имеют точность до 6 десятичных знаков. Например, «40,714728, -73,998672» является действительным значением геокода. Точность за пределами 6 десятичных мест игнорируется.

Стоимость долготы основана на их расстоянии от Гринвича, Англия, дома Prime Meridian. Поскольку Гринвич расположен в 51,477222 широте, мы можем ввести center значение 51.477222,0 , чтобы сосредоточиться на карте на Гринвиче:

Гринвич, Англия

Значения широты и долготы должны соответствовать действительному месту на поверхности Земли. Шатцы могут принимать любое значение от -90 до 90 , в то время как значения долготы могут принимать любое значение от -180 до 180 . Если вы указали неверную широту или значение долготы, ваш запрос будет отклонен как плохой запрос.

Адреса

Большинство людей не говорят в широтах и ​​доне; Они обозначают местоположения с использованием адресов . Процесс превращения адреса в географическую точку известен как геокодирование , и Служба статического API MAPS может выполнять для вас геокодирование, если вы предоставите действительные адреса.

В любом параметре, где вы можете предоставить широту/долготу, вы можете вместо этого указать строку, указывающую адрес . Google будет геокодировать адрес и предоставит Service Static API Static Maps со значением широты/долготы для использования при размещении маркеров или определении местоположений. Строка должна быть кодирована URL , поэтому такие адреса, как «мэрия, Нью-Йорк, Нью-Йорк», например, в «City+Hall, New+York, NY», например.

Обратите внимание, что адреса могут отражать либо точные места, такие как уличные адреса, полилины, такие как названные маршруты, или полигональные области, такие как города, страны или национальные парки. Для полилинерных и полигональных результатов сервер Static API MAPS будет использовать центральную точку линии/области в качестве адресного центра. Если у вас есть сомнения в том, как адрес может геодод, вы можете проверить адрес, используя эту утилиту геокодирования .

Следующий пример создает статическое изображение карты для Беркли, Калифорния:

https://maps.googleapis.com/maps/api/staticmap?center=Berkeley,CA&zoom=14&size=400x400&key=YOUR_API_KEY&signature=YOUR_SIGNATURE

Беркли, Калифорния

Уровень увеличения

Карты на картах Google имеют целое число «уровня масштабирования», которое определяет разрешение текущего представления. Уровень увеличения между 0 (самый низкий уровень масштабирования, при котором весь мир можно увидеть на одной карте) и 21+ (вниз по улицам и отдельным зданиям) возможны в виде roadmap по умолчанию. Строительные очертания, где доступно, появляются на карте вокруг уровня Zoom 17 . Это значение отличается от области к области и может меняться со временем по мере развития данных.

Google Maps устанавливает уровень увеличения 0 , чтобы охватить всю Землю. Каждый последующий уровень масштабирования удваивает точность как в горизонтальных, так и в вертикальных измерениях. Более подробная информация о том, как это сделано, доступна в документации Google Maps JavaScript API .

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

Если вы отправите запрос на уровень масштабирования, в котором нет плиток карты, Static API Maps вместо этого вернет пустое изображение.

В следующем списке показан приблизительный уровень детализации, который вы можете увидеть на каждом уровне масштабирования:

  • 1: мир
  • 5: сухопутный/континент
  • 10: город
  • 15: Улицы
  • 20: здания

Этот пример запрашивает две карты Манхэттена на том же center , но на уровнях 12 и 14, соответственно:

https://maps.googleapis.com/maps/api/staticmap?center=40.714728,-73.998672&zoom=12&size=400x400&key=YOUR_API_KEY&signature=YOUR_SIGNATURE
https://maps.googleapis.com/maps/api/staticmap?center=40.714728,-73.998672&zoom=14&size=400x400&key=YOUR_API_KEY&signature=YOUR_SIGNATURE

Манхэттен ФаувейМанхэттен вблизи

Размеры изображения

Параметр size в сочетании с center определяет область покрытия карты. Он также определяет выходной размер карты в пикселях при умножении со значением scale (что по умолчанию 1 ).

В этой таблице показаны максимально допустимые значения для параметра size при каждом значении scale .

scale=1 scale=2
640x640 640x640 (возврат 1280x1280 пикселей)

Этот пример запрашивает «ломтик» Земли на экваторе на уровне масштабирования 1:

https://maps.googleapis.com/maps/api/staticmap?center=0,0&zoom=1&size=400x50&key=YOUR_API_KEY&signature=YOUR_SIGNATURE

Экватор

Этот пример запрашивает небольшую карту размером 100 x 100 пикселей, центрированных в той же области. Обратите внимание на меньший логотип Google:

https://maps.googleapis.com/maps/api/staticmap?center=0,0&zoom=1&size=100x100&key=YOUR_API_KEY&signature=YOUR_SIGNATURE

Маленькая карта экватора

Значения масштаба

Параметр size статического API карт определяет размер карты в пикселях, так что карта с size=200x200 будет возвращена как 200 пикселей на 200 пикселей. На ЖК -мониторе компьютера, который обычно отображает около 100 пикселей на дюйм (PPI), карта 200x200 будет около 2 дюймов в каждом измерении.

Тем не менее, мобильные устройства все чаще включают экраны высокого разрешения с плотностью пикселей более 300ppi, которые либо:

  • Уменьшите размер изображения 200x200 пикселей только до 0,7 дюйма, рендеринга и значков слишком малы, чтобы прочитать; или
  • Масштабировать (Zoom) изображение для улучшения разборчивости, что приводит к нечеткому или пикселированному изображению.
Слишком маленький Слишком нечеткий

При разработке для мобильных устройств вы можете использовать параметр scale API для возврата изображений карт более высокого разрешения, которые решают вышеупомянутые проблемы. Значение scale умножается с size , чтобы определить фактический выходной размер изображения в пикселях, без изменения площади покрытия карты. Значение scale по умолчанию составляет 1; Принятые значения 1 и 2.

Например, значение шкалы 2 вернет ту же область покрытия карты, что и запрос без указанного масштаба, но в два раза больше пикселей в каждом измерении. Это включает в себя дороги и этикетки, так что они разборчивы на экранах с высоким разрешением, небольшими размерами, а также при масштабировании браузером.

150x150 150x150 & Scale = 2

Такое изображение также будет хорошо работать в браузерах для настольных компьютеров, при вставке в img или div тег с высотой и шириной с использованием CSS. Браузер уменьшит изображение до правильного размера, без потери качества.

В этой таблице показаны три разных запроса изображения.

  • Первый для изображения 100x100, без указанного значения масштаба. Он отображается правильно на рабочем столе, но слишком мал, чтобы читать на мобильном устройстве.
  • Второй удваивает размер карты. На рабочем столе CSS вписывается в указанный элемент img 100x100, но в сокращении изображения, дороги и этикетки становятся слишком маленькими. На мобильном устройстве изображение имеет правильный размер, но опять же, дороги и этикетки неразборчивы.
  • Третий запрос предназначен для карты 100x100 со scale=2 . Изображение возвращается с 200px детализации; Настольный компьютер идеально подходит, так что он неотличим от исходного запроса 100x100, в то время как мобильный браузер получает выгоду от дополнительного разрешения, возвращаемого API.
Запросы изображения
Устройство 100x100 200x200 100x100&scale=2
Рабочий стол
height="100px" и
width="100px" на
img TAG)
Высокое разрешение
(смоделирован)

Для получения дополнительной информации о разработке для дисплеев с мобильным и высоким разрешением рекомендуется следующее чтение:

Форматы изображений

Изображения могут возвращаться в нескольких общих форматах веб -графики: GIF , JPEG и PNG . Параметр format принимает одно из следующих значений:

  • png8 или png (по умолчанию) указывает 8-битный формат PNG .
  • png32 указывает 32-битный формат PNG .
  • gif указывает формат GIF .
  • jpg указывает формат сжатия JPEG .
  • jpg-baseline указывает не прогрессивный формат сжатия JPEG .

Эти примеры запрашивают карты в форматах gif и png :

  https://maps.googleapis.com/maps/api/staticmap?center=40.714728,-73.998672&format=gif&zoom=14&size=400x400&key=YOUR_API_KEY&signature=YOUR_SIGNATURE
  https://maps.googleapis.com/maps/api/staticmap?center=40.714728,-73.998672&format=png&&zoom=14&size=400x400&key=YOUR_API_KEY&signature=YOUR_SIGNATURE

jpg и jpg-baseline обычно обеспечивают наименьший размер изображения, хотя они делают это через сжатие «потеря», которое может ухудшить изображение. gif , png8 и png32 обеспечивают сжатие без потерь.

Большинство изображений JPEG прогрессивны, что означает, что они загружают более грубое изображение ранее и совершенствуют разрешение изображения по мере появления большего количества данных. Это позволяет быстро загружать изображения на веб -страницах и является наиболее распространенным использованием JPEG в настоящее время. Тем не менее, некоторые применения JPEG требуют непрогрессивных (базовых) изображений. В таких случаях вы можете использовать формат jpg-baseline , который является не прогрессивным.

Типы карт

Статический API карты создает карты в нескольких форматах, перечисленных ниже:

  • roadmap (по умолчанию) определяет стандартное изображение дорожной карты, как обычно показано на веб -сайте Google Maps. Если значение maptype не указано, Static API карт обслуживает плитки roadmap по умолчанию.
  • satellite определяет спутниковое изображение.
  • terrain указывает изображение карты физического облегчения, показывающее местность и растительность.
  • hybrid указывает гибрид спутникового и дорожного изображения, показывая прозрачный слой крупных улиц и помещает названия на спутниковом изображении.

В этом примере кода вы можете увидеть разницу между типами дорожной карты и местности.

https://maps.googleapis.com/maps/api/staticmap?center=40.714728,-73.998672&zoom=12&size=400x400&maptype=roadmap&key=YOUR_API_KEY&signature=YOUR_SIGNATURE
https://maps.googleapis.com/maps/api/staticmap?center=40.714728,-73.998672&zoom=12&size=400x400&maptype=terrain&key=YOUR_API_KEY&signature=YOUR_SIGNATURE

Манхэттенская нормальная картаМанхэттенская местность карта

Гибридные карты используют спутниковые изображения и выдающиеся функции дорожной карты для создания комбинированной карты. Следующие примеры показывают типы спутниковых и гибридных карт:

https://maps.googleapis.com/maps/api/staticmap?center=40.714728,-73.998672&zoom=12&size=400x400&maptype=satellite&key=YOUR_API_KEY&signature=YOUR_SIGNATURE
https://maps.googleapis.com/maps/api/staticmap?center=40.714728,-73.998672&zoom=12&size=400x400&maptype=hybrid&key=YOUR_API_KEY&signature=YOUR_SIGNATURE

Манхэттенская спутниковая картаМанхэттенская местность карта

Стилизованные карты

Настройте представление стандартной карты Google, применяя свои собственные стили. Смотрите руководство по картам стиля .

Маркеры

Параметр markers определяет набор из одного или нескольких маркеров (PINS MAP) в наборе местоположений. Каждый маркер, определенный в одном объявлении markers , должен демонстрировать тот же визуальный стиль; Если вы хотите отобразить маркеры с разными стилями, вам нужно будет предоставить несколько параметров markers с отдельной информацией о стиле.

Параметр markers принимает набор назначений значений ( дескрипторы маркеров ) следующего формата:

markers= markerStyles | markerLocation1 | markerLocation2 |... и т. Д.

Набор MarkersTiles объявлен в начале объявления markers и состоит из нулевых или более дескрипторов стиля, разделенных символом трубы ( | ), за которым следует набор из одного или нескольких мест, также разделенных символом трубы ( | ).

Поскольку как информация о стиле, так и информация о местоположении разграничивается с помощью персонажа трубы, информация о стиле должна появиться в первую очередь в любом дескрипторе маркера. Как только статический сервер API карт встречает местоположение в дескрипторе маркера, предполагается, что все остальные параметры маркера также являются местоположениями.

Маркерные стили

Набор дескрипторов стиля маркера представляет собой серию заданий стоимости, разделенные символом трубы ( | ). Этот дескриптор стиля определяет визуальные атрибуты для использования при отображении маркеров в этом дескрипторе маркера. Эти дескрипторы стиля содержат следующие назначения ключа/значения:

  • size: (необязательно) Указывает размер маркера из набора {tiny, mid, small} . Если параметр size не установлен, маркер появится в своем размере по умолчанию (нормальный).
  • color: (необязательно) Указывает 24-битный цвет (пример: color=0xFFFFCC ) или предопределенный цвет из набора {black, brown, green, purple, yellow, blue, gray, orange, red, white} .

    Обратите внимание, что прозрачные (указанные с использованием 32-битных значений цвета шестигранного цвета) не поддерживаются в маркерах, хотя они поддерживаются для путей.

  • label : (Необязательно) Указывает один буквенно -цифровой символ в верхнем плане из Set {AZ, 0-9}. (Требование для перспективных символов является новым для этой версии API.) Обратите внимание, что маркеры по умолчанию и mid размеру являются единственными маркерами, способными отображать параметр alphanumeric-character . tiny и small маркеры не способны отображать буквенно-цифровой характер.

Масштабирование маркера

Значение scale умножается с размером маркера изображения, чтобы получить фактический выходной размер маркера в пикселях. Значение шкалы по умолчанию составляет 1; Принятые значения - 1, 2 и 4.

Предел размера пикселя на изображениях применяется после применения масштабирования. Например, если маркер установлен на scale:2 , то маркер может быть больше, чем максимальный размер 4096 пикселей, если он уменьшается до менее чем 4096 пикселей после масштабирования. Используйте масштабирование маркера в сочетании с масштабированием карт при отображении карт более высокого разрешения.

Маркерные локации

Каждый дескриптор маркера должен содержать набор из одного или нескольких мест, определяющих, где разместить маркер на карте. Эти местоположения могут быть указаны как значения широты/долготы, либо как адреса . Эти местоположения разделены с использованием символа трубы ( | ).

ПРИМЕЧАНИЕ . Если вы решите указать местоположения маркеров, используя метод, который требует геокодирования, такого как читаемые на человеке строки или полилинии, запрос ограничен максимум 15 маркеров. Этот предел относится только к маркерам, которые требуют геокодирования. Это не относится к местоположениям маркеров, указанных с координатами широты/долготы.

Параметры местоположения определяют местоположение маркера на карте. Если местоположение снятся с карты, этот маркер не будет отображаться в построенном изображении, при условии, что поставляются параметры center и zoom . Однако, если эти параметры не поставляются, сервер API MAPS автоматически создаст изображение, которое содержит поставляемые маркеры. (См. Неявное позиционирование .)

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

https://maps.googleapis.com/maps/api/staticmap?center=Williamsburg,Brooklyn,NY&zoom=13&size=400x400&
markers=color:blue%7Clabel:S%7C11211%7C11206%7C11222&key=YOUR_API_KEY&signature=YOUR_SIGNATURE

Три Бруклинских Zipcodes

Чтобы определить маркеры с разными стилями, нам нужно предоставить несколько параметров markers . Этот набор параметров markers определяет три маркера: один синий маркер с надписью «S» на 62.107733, -145.5419, один крошечный зеленый маркер в «Delta Junction, AK» и один желтый маркер среднего размера с надписью «C» в «Tok, Ak» ". Эти маркеры показаны в этом примере:

https://maps.googleapis.com/maps/api/staticmap?center=63.259591,-144.667969&zoom=6&size=400x400
&markers=color:blue%7Clabel:S%7C62.107733,-145.541936&markers=size:tiny%7Ccolor:green%7CDelta+Junction,AK
&markers=size:mid%7Ccolor:0xFFFF00%7Clabel:C%7CTok,AK"&key=YOUR_API_KEY&signature=YOUR_SIGNATURE

Три города Аляски, разные маркеры

Пользовательские значки

Вместо того, чтобы использовать значки маркера Google, вместо этого вы можете использовать свои собственные значки. Пользовательские значки указываются с использованием дескриптора icon в параметре markers . Например:

markers=icon: URLofIcon | markerLocation

Укажите icon , используя URL (который должен быть кодирован URL ). Вы можете использовать URL-адреса, созданные услугами по сокращению URL, такими как https://goo.gl . Большинство услуг по сокращению URL имеют преимущество автоматического кодирования URL-адресов.

Вы можете указать точку привязки для пользовательской иконки. Точка привязки устанавливает то, как значок расположен в отношении указанных мест markers . По умолчанию точка привязки пользовательского значка является нижним центром изображения значка. Вы можете указать другую точку привязки, используя дескриптор anchor в сочетании с вашим icon . Установите anchor в качестве x topleft y right значка ( topright , 10,5 ), или в center bottomright выравнивания left использованием одного bottom следующих bottomleft : top . Например:

markers=anchor:bottomright|icon: URLofIcon | markerLocation1 | markerLocation2

Вы можете использовать до пяти уникальных пользовательских значков для запроса. Это ограничение не означает, что вы ограничены только 5 отмеченными местами на своей карте. Каждый уникальный значок может использоваться с более чем одним расположением markers на вашей карте.

Формат значков:

  • Изображения значков могут быть в форматах PNG, JPEG или GIF, хотя рекомендуется PNG.
  • Значки могут составлять до 4096 пикселей максимальный размер (64x64 для квадратных изображений).
Примеры пользовательских значков

Пример 1 создает пользовательские значки и позиционирует значки, используя якоря.

https://maps.googleapis.com/maps/api/staticmap?&size=600x400&style=visibility:on
&style=feature:water%7Celement:geometry%7Cvisibility:on
&style=feature:landscape%7Celement:geometry%7Cvisibility:on
&markers=anchor:32,10%7Cicon:https://goo.gl/5y3S82%7CCanberra+ACT
&markers=anchor:topleft%7Cicon:http://tinyurl.com/jrhlvu6%7CMelbourne+VIC
&markers=anchor:topright%7Cicon:https://goo.gl/1oTJ9Y%7CSydney+NSW&key=YOUR_API_KEY
&signature=YOUR_SIGNATURE

Три австралийских города, разные пользовательские значки, расположенные с якорями.

Пример 2 создает те же пользовательские значки, что и пример 1, но не устанавливает позиции значка, используя якоря, полагаясь на якорь нижнего центра по умолчанию.

https://maps.googleapis.com/maps/api/staticmap?&size=600x400&style=visibility:on
&style=feature:water%7Celement:geometry%7Cvisibility:on
&style=feature:landscape%7Celement:geometry%7Cvisibility:on
&markers=icon:https://goo.gl/5y3S82%7CCanberra+ACT
&markers=icon:http://tinyurl.com/jrhlvu6%7CMelbourne+VIC
&markers=icon:https://goo.gl/1oTJ9Y%7CSydney+NSW&key=YOUR_API_KEY&signature=YOUR_SIGNATURE

Три австралийских города, разные пользовательские значки с позиционированием по умолчанию.

Карты статических путей API

Параметр path определяет набор из одного или нескольких местоположений, связанных путем к наложению на изображении карты. Параметр path принимает набор назначений значений ( дескрипторы пути ) следующего формата:

path= pathStyles | pathLocation1 | pathLocation2 |... и т. д.

Обратите внимание, что обе точки пути отделены друг от друга, используя символ трубы ( | ). Поскольку как информация о стиле, так и информация о точках разграничивается через символ трубы, информация о стиле должна появиться в первую очередь в любом дескрипторе пути. Как только статический сервер API карт встречает местоположение в дескрипторе пути, предполагается, что все другие параметры пути также являются местоположениями.

Путь стили

Набор дескрипторов стиля пути представляет собой серию назначений значений, разделенных символом трубы ( | ). Этот дескриптор стиля определяет визуальные атрибуты для использования при отображении пути. Эти дескрипторы стиля содержат следующие назначения ключа/значения:

  • weight: (необязательно) Указывает толщину пути в пикселях. Если параметр weight не установлен, путь появится в толщине его по умолчанию (5 пикселей).
  • color: (необязательно) Определяет цвет либо 24-битного (пример: color=0xFFFFCC ) или 32-разрядное шестнадцатеричное значение (пример: color=0xFFFFCCFF ) или из набора {black, brown, green, purple, yellow, blue, gray, orange, red, white} .

    Когда указано 32-разрядное значение шестигранника, последние два символа указывают 8-битное значение прозрачности альфа. Это значение варьируется от 00 (полностью прозрачно) и FF (совершенно непрозрачный). Обратите внимание, что прозрачность поддерживается на пути, хотя они не поддерживаются для маркеров.

  • fillcolor : (необязательно) Указывает обоих, что путь отмечает полигональную область и определяет цвет заполнения для использования в качестве наложения в этой области. Набор следующих мест не должен быть «закрытым» петлей; Статический API -сервер Maps автоматически присоединятся к первым и последним пунктам. Обратите внимание, однако, что любой удар на внешней стороне заполненной области не будет закрыт, если вы специально не предоставите то же самое начальное и конечное место.
  • geodesic : (необязательно) указывает на то, что запрашиваемый путь должен интерпретироваться как геодезическая линия, которая следует за кривизны земли. Когда ложно, путь отображается как прямая линия в пространстве экрана. По умолчанию ложно.

Некоторый пример определения пути:

  • Тонкая синяя линия, 50% непрозрачность: path=color:0x0000ff80|weight:1
  • Сплошная красная линия: path=color:0xff0000ff|weight:5
  • Сплошная толстая белая линия: path=color:0xffffffff|weight:10

Эти стили пути являются необязательными. Если нужны атрибуты по умолчанию, вы можете пропустить определение атрибутов пути; В этом случае первый «аргумент» дескриптора пути будет состоять вместо первой объявленной точки (местоположение).

Точки пути

Чтобы нарисовать путь, параметр path также должен быть передан по двум или более точкам. Статический API Maps затем подключит путь вдоль этих точек в указанном порядке. Каждая точка пути обозначена в Pathdescriptor , разделенном | (труба) символ.

В следующем примере определяется синий путь с непрозрачностью 50% от Union Square, штат Нью -Йорк, до Таймс -сквер, штат Нью -Йорк.

Путь от Union Sq до Times Sq

Специфика параметра path :

path=color:0x0000ff|weight:5|40.737102,-73.990318|40.749825,-73.987963|40.752946,-73.987384|40.755823,-73.986397

В следующем примере определяется тот же путь вместо этого, чтобы определить твердую красную линию со 100% непрозрачностью:

Путь от Union Sq до Times Sq

Специфика этого параметра path :

path=color:0xff0000ff|weight:5|40.737102,-73.990318|40.749825,-73.987963|40.752946,-73.987384|40.755823,-73.986397

Следующий пример определяет полигональную область в Манхэттене, передавая серию пересечений в качестве местоположения:

Путь от Union Sq до Times Sq

Специфика этого параметра path :

path=color:0x00000000|weight:5|fillcolor:0xFFFF0033|8th+Avenue+%26+34th+St,New+York,NY|\
8th+Avenue+%26+42nd+St,New+York,NY|Park+Ave+%26+42nd+St,New+York,NY,NY|\
Park+Ave+%26+34th+St,New+York,NY,NY

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

Кодированные полилинии

Вместо ряда локаций вы можете вместо этого объявить путь как кодируемую полилинию , используя enc: Prefix в рамках объявления path .

В следующем примере описывается ход шоссе Аляски от Доусон -Крик, до н.э. до дельта -соединения, АК с кодированной полилинией:

https://maps.googleapis.com/maps/api/staticmap
?size=400x400&center=59.900503,-135.478011&zoom=4
&path=weight:3%7Ccolor:orange%7Cenc:_fisIp~u%7CU}%7Ca@pytA_~b@hhCyhS~hResU%7C%7Cx@oig@rwg@amUfbjA}f[roaAynd@%7CvXxiAt{ZwdUfbjAewYrqGchH~vXkqnAria@c_o@inc@k{g@i`]o%7CF}vXaj\h`]ovs@?yi_@rcAgtO%7Cj_AyaJren@nzQrst@zuYh`]v%7CGbldEuzd@%7C%7Cx@spD%7CtrAzwP%7Cd_@yiB~vXmlWhdPez\_{Km_`@~re@ew^rcAeu_@zhyByjPrst@ttGren@aeNhoFemKrvdAuvVidPwbVr~j@or@f_z@ftHr{ZlwBrvdAmtHrmT{rOt{Zz}E%7Cc%7C@o%7CLpn~AgfRpxqBfoVz_iAocAhrVjr@rh~@jzKhjp@``NrfQpcHrb^k%7CDh_z@nwB%7Ckb@a{R%7Cyh@uyZ%7CllByuZpzw@wbd@rh~@%7C%7CFhqs@teTztrAupHhyY}t]huf@e%7CFria@o}GfezAkdW%7C}[ocMt_Neq@ren@e~Ika@pgE%7Ci%7CAfiQ%7C`l@uoJrvdAgq@fppAsjGhg`@%7ChQpg{Ai_V%7C%7Cx@mkHhyYsdP%7CxeA~gF%7C}[mv`@t_NitSfjp@c}Mhg`@sbChyYq}e@rwg@atFff}@ghN~zKybk@fl}A}cPftcAite@tmT__Lha@u~DrfQi}MhkSqyWivIumCria@ciO_tHifm@fl}A{rc@fbjAqvg@rrqAcjCf%7Ci@mqJtb^s%7C@fbjA{wDfs`BmvEfqs@umWt_Nwn^pen@qiBr`xAcvMr{Zidg@dtjDkbM%7Cd_@
&key=YOUR_API_KEY&signature=YOUR_SIGNATURE

Аляска шоссе

Как и в случае стандартных путей, закодированные полиночные пути могут также разграничить полигональные области, если аргумент fillcolor передается параметру path .

В следующем примере изложена полигональная область для Бруклина, Нью -Йорк:

https://maps.googleapis.com/maps/api/staticmap
?size=400x400&center=40.653279,-73.959816&zoom=11
&path=fillcolor:0xAA000033%7Ccolor:0xFFFFFF00%7Cenc:}zswFtikbMjJzZ%7CRdPfZ}DxWvBjWpF~IvJnEvBrMvIvUpGtQpFhOQdKpz@bIx{A%7CPfYlvApz@bl@tcAdTpGpVwQtX}i@%7CGen@lCeAda@bjA%60q@v}@rfAbjA%7CEwBpbAd_@he@hDbu@uIzWcWtZoTdImTdIwu@tDaOXw_@fc@st@~VgQ%7C[uPzNtA%60LlEvHiYyLs^nPhCpG}SzCNwHpz@cEvXg@bWdG%60]lL~MdTmEnCwJ[iJhOae@nCm[%60Aq]qE_pAaNiyBuDurAuB }}Ay%60@%7CEKv_@?%7C[qGji@lAhYyH%60@Xiw@tBerAs@q]jHohAYkSmW?aNoaAbR}LnPqNtMtIbRyRuDef@eT_z@mW_Nm%7CB~j@zC~hAyUyJ_U{Z??cPvg@}s@sHsc@_z@cj@kp@YePoNyYyb@_iAyb@gBw^bOokArcA}GwJuzBre@i\tf@sZnd@oElb@hStW{]vv@??kz@~vAcj@zKa%60Atf@uQj_Aee@pU_UrcA
&key=YOUR_API_KEY&signature=YOUR_SIGNATURE

Бруклинская кодировала полилинина с подписью

ViewPorts

Изображения могут указать Viewport , указав видимые местоположения, используя visible параметр. visible параметр инструктирует Службу статического API карт для построения карты так, чтобы существующие места оставались видимыми. (Этот параметр может быть объединен с существующими маркерами или путями, чтобы определить видимую область.) Определение просмотра таким образом устраняет необходимость определения точного уровня масштабирования.

Следующий пример запрашивает карту, сосредоточенную на Бостоне, Массачусетс, содержащая как MIT, так и Гарвардскую площадь в Кембридже, Массачусетс:

https://maps.googleapis.com/maps/api/staticmap?center=Boston,MA
&visible=77+Massachusetts+Ave,Cambridge,MA%7CHarvard+Square,Cambridge,MA&size=512x512&key=YOUR_API_KEY&signature=YOUR_SIGNATURE

Кембриджская карта

Неявное позиционирование карты

Обычно вам необходимо указать параметры center и zoom URL, чтобы определить местоположение и уровень масштабирования вашей сгенерированной карты. Однако, если вы поставляете markers , path или visible параметры, вы можете вместо этого позволить Static API определять правильный центр и уровень масштабирования, на основе оценки положения этих элементов.

При поставке двух или более элементов, Static API Maps определит надлежащий центр и уровень масштабирования, обеспечивая щедрые маржи для содержащихся элементов. В этом примере отображается карта, содержащая Сан -Франциско, Окленд и Сан -Хосе, Калифорния:

https://maps.googleapis.com/maps/api/staticmap?size=512x512&maptype=roadmap\
&markers=size:mid%7Ccolor:red%7CSan+Francisco,CA%7COakland,CA%7CSan+Jose,CA&key=YOUR_API_KEY&signature=YOUR_SIGNATURE

Дорожная карта

Большие размеры изображения

Если вам нужны изображения с размерами, превышающими 640 x 640 пикселей (или 1280 x 1280 пикселей со значением масштаба 2), свяжитесь с командой поддержки и предоставьте следующую информацию:

  1. Ваш вариант использования и почему вам нужны изображения больших размеров.
  2. Независимо от того, рассматриваете ли вы использовать другие API платформы Google Maps (Maps JavaScript API, MAPS Embed API, MAPS SDK для Android или MAPS SDK для iOS) и почему они не удовлетворяют ваши потребности.
  3. Скриншоты, издевательства или образцы того, как вы будете использовать изображения больших размеров.
  4. Ваше предполагаемое ежемесячное использование для изображений большого размера.

Мы рассмотрим ваш запрос на основе предоставленной вами информации и определим, соответствует ли ваш вариант использования условиями платформы Google Maps .

Максимальный размер, который мы можем предоставить, составляет 2048 x 2048 пикселей.

Устранение неполадок и поддержка

Для получения дополнительной информации об использовании Static API Maps, взгляните на страницу поддержки .

Статический API карты может издать ошибку или предупреждение, когда что -то пойдет не так. В частности, вы должны проверить наличие предупреждений, если вы заметили, что что -то не хватает на карте. Это также хорошая идея, чтобы проверить наличие предупреждений, прежде чем запустить новое приложение. Обратите внимание, что предупреждения не могут быть сразу очевидны, потому что они появляются в заголовке HTTP. Для получения дополнительной информации см. Руководство по ошибкам и предупреждениям .