Обзор
Чтобы задать стиль заливки и обводки для граничного полигона, используйте FeatureStyleOptions
для определения атрибутов стиля и задайте для свойства style
на слое объектов значение google.maps.FeatureStyleFunction
, которое содержит логику стилей.
На следующем примере карты показано выделение граничного полигона для одного региона.
Примените стиль к объектам границ, установив свойство style
в функцию google.maps.FeatureStyleFunction
, которая может содержать логику стилизации. Функция стиля применяется к каждому объекту в соответствующем слое объектов и применяется в момент установки свойства стиля. Чтобы обновить его, необходимо повторно установить свойство стиля.
Чтобы единообразно оформить все объекты в слое объектов, установите свойство style
google.maps.FeatureStyleOptions
. В этом случае вам не нужно использовать функцию стиля объектов, поскольку логика не требуется.
Функция стилизации должна всегда возвращать согласованные результаты при применении к объектам. Например, если вы хотите случайным образом раскрасить набор объектов, случайная часть не должна присутствовать в функции стилизации объектов, так как это приведёт к непредвиденным результатам.
Поскольку эта функция обрабатывает каждый объект в слое, оптимизация важна. Чтобы избежать влияния на время рендеринга:
- Включите только те слои, которые вам нужны.
- Установите
style
наnull
, если слой больше не используется.
Чтобы стилизовать полигон в слое объектов местности, выполните следующие действия:
- Если вы ещё этого не сделали, следуйте инструкциям в разделе «Начало работы» , чтобы создать новый идентификатор и стиль карты. Не забудьте включить слой объектов «Населённый пункт» .
Получите ссылку на слой объектов местности при инициализации карты.
featureLayer = map.getFeatureLayer("LOCALITY");
Создайте определение стиля типа
google.maps.FeatureStyleFunction
.Установите свойство
style
слоя объектов наFeatureStyleFunction
. В следующем примере показано определение функции для применения стиля только кgoogle.maps.Feature
с соответствующим идентификатором места:Машинопись
// Define a style with purple fill and border. //@ts-ignore const featureStyleOptions: google.maps.FeatureStyleOptions = { strokeColor: '#810FCB', strokeOpacity: 1.0, strokeWeight: 3.0, fillColor: '#810FCB', fillOpacity: 0.5 }; // Apply the style to a single boundary. //@ts-ignore featureLayer.style = (options: { feature: { placeId: string; }; }) => { if (options.feature.placeId == 'ChIJ0zQtYiWsVHkRk8lRoB1RNPo') { // Hana, HI return featureStyleOptions; } };
JavaScript
// Define a style with purple fill and border. //@ts-ignore const featureStyleOptions = { strokeColor: "#810FCB", strokeOpacity: 1.0, strokeWeight: 3.0, fillColor: "#810FCB", fillOpacity: 0.5, }; // Apply the style to a single boundary. //@ts-ignore featureLayer.style = (options) => { if (options.feature.placeId == "ChIJ0zQtYiWsVHkRk8lRoB1RNPo") { // Hana, HI return featureStyleOptions; } };
Если указанный идентификатор места не найден или не соответствует выбранному типу объекта, стиль не применяется. Например, попытка применить стиль к слою POSTAL_CODE
, соответствующий идентификатору места «Нью-Йорк», приведет к тому, что стиль не будет применен.
Удалить стилизацию слоя
Чтобы удалить стиль из слоя, установите для style
значение null
:
featureLayer.style = null;
Найдите идентификаторы мест для определения целевых объектов
Чтобы получить идентификаторы мест для регионов:
- Используйте API Places и Geocoding для поиска регионов по названию и получения идентификаторов мест для регионов в указанных границах.
- Получайте данные о событиях щелчков . Возвращает объект, соответствующий выбранному региону, который предоставляет доступ к идентификатору места, отображаемому имени и категории типа объекта.
Зона покрытия зависит от региона. Подробнее см. в разделе «Границы покрытия Google» .
Географические названия доступны во многих источниках, таких как Совет по географическим названиям Геологической службы США (USGS Board on Geographic Names ) и Файлы географического справочника США (US Gazetteer Files ).
Полный пример кода
Машинопись
let map: google.maps.Map; //@ts-ignore let featureLayer; async function initMap() { // Request needed libraries. const { Map } = await google.maps.importLibrary("maps") as google.maps.MapsLibrary; map = new Map(document.getElementById('map') as HTMLElement, { center: { lat: 20.773, lng: -156.01 }, // Hana, HI zoom: 12, // In the cloud console, configure this Map ID with a style that enables the // "Locality" feature layer. mapId: 'a3efe1c035bad51b', // <YOUR_MAP_ID_HERE>, }); //@ts-ignore featureLayer = map.getFeatureLayer('LOCALITY'); // Define a style with purple fill and border. //@ts-ignore const featureStyleOptions: google.maps.FeatureStyleOptions = { strokeColor: '#810FCB', strokeOpacity: 1.0, strokeWeight: 3.0, fillColor: '#810FCB', fillOpacity: 0.5 }; // Apply the style to a single boundary. //@ts-ignore featureLayer.style = (options: { feature: { placeId: string; }; }) => { if (options.feature.placeId == 'ChIJ0zQtYiWsVHkRk8lRoB1RNPo') { // Hana, HI return featureStyleOptions; } }; } initMap();
JavaScript
let map; //@ts-ignore let featureLayer; async function initMap() { // Request needed libraries. const { Map } = await google.maps.importLibrary("maps"); map = new Map(document.getElementById("map"), { center: { lat: 20.773, lng: -156.01 }, // Hana, HI zoom: 12, // In the cloud console, configure this Map ID with a style that enables the // "Locality" feature layer. mapId: "a3efe1c035bad51b", // <YOUR_MAP_ID_HERE>, }); //@ts-ignore featureLayer = map.getFeatureLayer("LOCALITY"); // Define a style with purple fill and border. //@ts-ignore const featureStyleOptions = { strokeColor: "#810FCB", strokeOpacity: 1.0, strokeWeight: 3.0, fillColor: "#810FCB", fillOpacity: 0.5, }; // Apply the style to a single boundary. //@ts-ignore featureLayer.style = (options) => { if (options.feature.placeId == "ChIJ0zQtYiWsVHkRk8lRoB1RNPo") { // Hana, HI return featureStyleOptions; } }; } initMap();
CSS
/* * Always set the map height explicitly to define the size of the div element * that contains the map. */ #map { height: 100%; } /* * Optional: Makes the sample page fill the window. */ html, body { height: 100%; margin: 0; padding: 0; }
HTML
<html> <head> <title>Boundaries Simple</title> <link rel="stylesheet" type="text/css" href="./style.css" /> <script type="module" src="./index.js"></script> </head> <body> <div id="map"></div> <!-- prettier-ignore --> <script>(g=>{var h,a,k,p="The Google Maps JavaScript API",c="google",l="importLibrary",q="__ib__",m=document,b=window;b=b[c]||(b[c]={});var d=b.maps||(b.maps={}),r=new Set,e=new URLSearchParams,u=()=>h||(h=new Promise(async(f,n)=>{await (a=m.createElement("script"));e.set("libraries",[...r]+"");for(k in g)e.set(k.replace(/[A-Z]/g,t=>"_"+t[0].toLowerCase()),g[k]);e.set("callback",c+".maps."+q);a.src=`https://maps.${c}apis.com/maps/api/js?`+e;d[q]=f;a.onerror=()=>h=n(Error(p+" could not load."));a.nonce=m.querySelector("script[nonce]")?.nonce||"";m.head.append(a)}));d[l]?console.warn(p+" only loads once. Ignoring:",g):d[l]=(f,...n)=>r.add(f)&&u().then(()=>d[l](f,...n))}) ({key: "AIzaSyB41DRUbKWJHPxaFjMAwdrzWzbVKartNGg", v: "weekly"});</script> </body> </html>