Обзор
Чтобы задать стиль заливки и обводки граничного многоугольника, используйте FeatureStyleOptions
для определения атрибутов стиля и задайте для свойства style
векторного слоя значение google.maps.FeatureStyleFunction
, которое содержит логику стиля.
На следующем примере карты показано выделение граничного многоугольника для одного региона.
Примените стиль к граничным объектам, задав для свойства style
значение google.maps.FeatureStyleFunction
, которое может содержать логику стиля. Функция стиля запускается для каждого объекта в затронутом векторном слое и применяется в момент установки свойства стиля. Чтобы обновить его, необходимо снова установить свойство стиля.
Чтобы единообразно стилизовать все объекты векторного слоя, установите для свойства style
значение google.maps.FeatureStyleOptions
. В этом случае вам не нужно использовать функцию стиля объекта, поскольку логика не требуется.
Функция стиля всегда должна возвращать согласованные результаты, когда она применяется к объектам. Например, если вы хотите случайным образом раскрасить набор объектов, случайная часть не должна использоваться в функции стиля объекта, так как это может привести к непредвиденным результатам.
Поскольку эта функция работает над каждым объектом слоя, оптимизация важна. Чтобы избежать влияния на время рендеринга:
- Включите только те слои, которые вам нужны.
- Установите
style
значениеnull
если слой больше не используется.
Чтобы стилизовать полигон в слое объектов местности, выполните следующие шаги:
- Если вы еще этого не сделали, следуйте инструкциям в разделе «Начало работы», чтобы создать новый идентификатор карты и стиль карты. Обязательно включите векторный слой Locality .
Получите ссылку на векторный слой местности при инициализации карты.
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 и геокодирование для поиска регионов по названию и получения идентификаторов мест для регионов в указанных границах.
- Получайте данные о событиях кликов . Это возвращает объект, соответствующий выбранному региону, что обеспечивает доступ к его идентификатору места, отображаемому имени и категории типа объекта.
Охват варьируется в зависимости от региона. Подробности см. в разделе «Покрытие границ Google» .
Географические названия доступны из многих источников, таких как Совет Геологической службы США по географическим названиям и Файлы справочника США .
Полный пример кода
Машинопись
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>