ב-FeatureStyleFunction מגדירים את הלוגיקה לעיצוב סלקטיבי של תכונות בקבוצת נתונים. היא מחזירה את הערך FeatureStyleOptions על סמך הלוגיקה הזו. אם לא נדרש לוגיקת עיצוב, אפשר להשתמש ב-FeatureStyleOptions כדי להגדיר סגנונות ישירות. בדף הזה מוסבר איך להוסיף קבוצת נתונים למפה ולהחיל סגנון.
דרישות מוקדמות
לפני שממשיכים, צריך לוודא שיש לכם מזהה מפה, סגנון מפה ומזהה מערך נתונים.
שיוך מזהה של מערך נתונים לסגנון מפה
כדי לשייך את מערך הנתונים לסגנון המפה שבו אתם משתמשים:
- במסוף Google Cloud, נכנסים לדף Datasets.
- לוחצים על השם של קבוצת הנתונים. מופיע הדף Dataset details.
- לוחצים על הכרטיסייה תצוגה מקדימה.
- גוללים אל הוספת סגנון מפה ולוחצים.
- מסמנים את התיבות של סגנונות המפה שרוצים לשייך ולוחצים על SAVE.
שימוש בכללי סגנון פשוטים
הדרך הכי פשוטה לעצב תכונות היא להעביר FeatureStyleOptions כדי להגדיר מאפייני סגנון כמו צבע, שקיפות ועובי קו. אפשר להחיל אפשרויות של סגנון תכונה ישירות על שכבת תכונות של מערך נתונים, או להשתמש בהן בשילוב עם FeatureStyleFunction.
TypeScript
const styleOptions = { strokeColor: 'green', strokeWeight: 2, strokeOpacity: 1, fillColor: 'green', fillOpacity: 0.3, };
JavaScript
const styleOptions = { strokeColor: 'green', strokeWeight: 2, strokeOpacity: 1, fillColor: 'green', fillOpacity: 0.3, };
שימוש בכללי סגנון הצהרתיים
אפשר להשתמש ב-FeatureStyleFunction כדי להגדיר כללי סגנון באופן הצהרתי ולהחיל אותם על כל קבוצת הנתונים. מחילים את FeatureStyleOptions על מאפיין על סמך ערכי המאפיינים של קבוצת הנתונים. אפשר גם להחזיר את הערך null מהפונקציה של סגנון הישות, למשל אם רוצים שקבוצת משנה של ישויות תישאר בלתי נראית. בדוגמה הבאה מוצגת פונקציית סגנון שצובעת קבוצת נקודות על סמך מאפייני נתונים:
TypeScript
function setStyle(params: { feature: google.maps.Feature }) { // Get the dataset feature, so we can work with all of its attributes. const datasetFeature = params.feature as google.maps.DatasetFeature; // Get all of the needed dataset attributes. const furColors = datasetFeature.datasetAttributes.CombinationofPrimaryandHighlightColor; // Apply styles. Fill is primary fur color, stroke is secondary fur color. switch (furColors) { case 'Black+': return { fillColor: 'black', pointRadius: 8, }; break; case 'Cinnamon+': return { fillColor: '#8b0000', pointRadius: 8, }; break; case 'Cinnamon+Gray': return { fillColor: '#8b0000', strokeColor: 'gray', pointRadius: 6, }; break; case 'Cinnamon+White': return { fillColor: '#8b0000', strokeColor: 'white', pointRadius: 6, }; break; case 'Gray+': return { fillColor: 'gray', pointRadius: 8, }; break; case 'Gray+Cinnamon': return { fillColor: 'gray', strokeColor: '#8b0000', pointRadius: 6, }; break; case 'Gray+Cinnamon, White': return { fillColor: 'silver', strokeColor: '#8b0000', pointRadius: 6, }; break; case 'Gray+White': return { fillColor: 'gray', strokeColor: 'white', pointRadius: 6, }; break; default: // Color not defined. return { fillColor: 'yellow', pointRadius: 8, }; break; } }
JavaScript
function setStyle(params) { // Get the dataset feature, so we can work with all of its attributes. const datasetFeature = params.feature; // Get all of the needed dataset attributes. const furColors = datasetFeature.datasetAttributes.CombinationofPrimaryandHighlightColor; // Apply styles. Fill is primary fur color, stroke is secondary fur color. switch (furColors) { case 'Black+': return { fillColor: 'black', pointRadius: 8, }; break; case 'Cinnamon+': return { fillColor: '#8b0000', pointRadius: 8, }; break; case 'Cinnamon+Gray': return { fillColor: '#8b0000', strokeColor: 'gray', pointRadius: 6, }; break; case 'Cinnamon+White': return { fillColor: '#8b0000', strokeColor: 'white', pointRadius: 6, }; break; case 'Gray+': return { fillColor: 'gray', pointRadius: 8, }; break; case 'Gray+Cinnamon': return { fillColor: 'gray', strokeColor: '#8b0000', pointRadius: 6, }; break; case 'Gray+Cinnamon, White': return { fillColor: 'silver', strokeColor: '#8b0000', pointRadius: 6, }; break; case 'Gray+White': return { fillColor: 'gray', strokeColor: 'white', pointRadius: 6, }; break; default: // Color not defined. return { fillColor: 'yellow', pointRadius: 8, }; break; } }
החלת סגנון על שכבת המפה של קבוצת הנתונים
כדי להחיל את הסגנונות בפונקציה של סגנון התכונה:
- מפעילים את
map.getDatasetFeatureLayer()ומעבירים את מזהה מערך הנתונים כדי לקבל את שכבת התכונות של מערך הנתונים. - מחילים את הסגנון על ידי הגדרת אפשרויות הסגנון של התכונה (למשל
styleOptions) או הפונקציה (למשלsetStyle) בשכבת קבוצת הנתונים.
TypeScript
// Dataset ID for NYC park data. const datasetId = 'a75dd002-ad20-4fe6-af60-27cd2ed636b4'; const datasetLayer = innerMap.getDatasetFeatureLayer(datasetId); datasetLayer.style = styleOptions;
JavaScript
// Dataset ID for NYC park data. const datasetId = 'a75dd002-ad20-4fe6-af60-27cd2ed636b4'; const datasetLayer = innerMap.getDatasetFeatureLayer(datasetId); datasetLayer.style = styleOptions;
הסרת סגנון משכבה
כדי להסיר את הסגנון משכבה, מגדירים את style ל-null:
featureLayer.style = null;
אפשר גם להחזיר את הערך null מהפונקציה של סגנון הישות, למשל אם רוצים שקבוצת משנה של ישויות תישאר בלתי נראית.
הוספת טקסט לציון קרדיט
אם אתם מציגים במפות Google קבוצות נתונים שהעליתם, המפה חייבת להציג את כל השיוכים הנדרשים. הטקסט לציון קרדיט לא יכול להסתיר את הלוגו של Google או להפריע לו.
אחת הדרכים להוסיף טקסט לציון קרדיט היא להשתמש בפקדים מותאמים אישית כדי להציב HTML שרירותי במיקומים סטנדרטיים במפה. בקטעי הקוד הבאים מוצגים ה-HTML וה-CSS שמשמשים להצגת השיוך בדוגמה הזו:
<gmp-map
center="40.757815, -73.933123"
zoom="11"
map-id="5cd2c9ca1cf05670"
map-type-control="false">
<div id="attribution" slot="control-block-end-inline-start">
Data source: NYC Open Data
</div>
</gmp-map>
#attribution { background-color: rgba(255, 255, 255, 0.7); font-family: 'Roboto', 'Arial', sans-serif; font-size: 10px; padding: 2px; margin: 2px; }