סכימת ה-JSON לעיצוב מפות מבוסס-ענן מאפשרת לכם להשתמש ב-JSON כדי להתאים אישית מפות, בדיוק כמו שאתם עושים בממשק של עורך הסגנונות. במאמר הזה מתוארת סכימת ה-JSON ומוסבר איך ליצור הצהרות סגנון ב-JSON.
במאמר שימוש ב-JSON עם עיצוב מפות מבוסס-ענן מוסבר איך לערוך סגנון מפה באמצעות JSON בעורך הסגנונות, או איך לייבא ולייצא סגנון מפה.
הצגת הצהרת סגנון לדוגמה ב-JSON
הצהרת הסגנון הבאה ב-JSON מגדירה צבע רקע, ואז מגדירה סגנונות לנקודות עניין, פארקים, מקווי מים ומסתירה תוויות של מיקומים של אוכל ושתייה.
{
"variant": "light",
"styles": [
{
"id": "natural.land",
"geometry": {
"fillColor": "#f7e3f7"
}
},
{
"id": "natural.water",
"geometry": {
"fillColor": "#d4b2ff"
},
"label": {
"textFillColor": "#3d2163",
"textStrokeColor": "#f0e1ff"
}
},
{
"id": "pointOfInterest",
"label": {
"pinFillColor": "#e0349a",
"textFillColor": "#a11e6e",
"textStrokeColor": "#ffd9f0"
}
},
{
"id": "pointOfInterest.emergency.hospital",
"geometry": {
"fillColor": "#ffe3e3"
}
},
{
"id": "pointOfInterest.foodAndDrink",
"label": {
"visible": false
}
},
{
"id": "pointOfInterest.recreation.park",
"geometry": {
"fillColor": "#f9b9d2"
}
}
]
}
אובייקט ה-JSON
הצהרה על סגנון JSON מורכבת מאובייקט ברמה העליונה וממערך של כללי סגנון.
- מאפיינים ברמה העליונה (אופציונלי) – הגדרות סגנון גלובליות כמו
backgroundColorו-variant. -
styles– מערך של אובייקטים של כללי סגנון, שיכולים לכלול את האפשרויות הבאות:-
id– מאפיין המפה שבוחרים לשינוי הסגנון (למשל,pointOfInterest.recreation.park). -
geometry(אופציונלי) – הרכיבים הגיאומטריים של מאפיין המפה וכללי הסגנון שרוצים להחיל (למשל,fillColor). -
label(אופציונלי) – הטקסט או תווית הסיכה של מאפיין המפה וכללי הסגנון שרוצים להחיל (למשל,textStrokeColor).
-
נכסים ברמה העליונה
המאפיינים בטבלה הבאה חלים על כל סגנון המפה.
| נכס | סוג | תיאור | דוגמה |
|---|---|---|---|
|
מחרוזת | התאמה אישית של צבע הרקע של אפליקציית המפות באמצעות מחרוזת הקסדצימלית #RRGGBB. אי אפשר לשנות את האטימות בהגדרה הזו. | "#002211" |
|
"light"|"dark" | מציינים מצב בהיר או מצב כהה. אם לא מציינים ערך, ברירת המחדל היא "light". | "light" |
|
בוליאני | כדי להפעיל את האפשרות "מונוכרום", משתמשים ב-true כדי לקבל גרסה אפורה של המפה. |
|
|
אובייקט | נתונים שרירותיים של מפתח/ערך שנכללים בהגדרת הסגנון. אפשר להשתמש בשדה הזה כדי לכלול תוכן שלא קשור לעיצוב של הסגנון. הנתונים האלה לא נשלחים ללקוחות של המפה, כמו Maps JavaScript SDK. |
|
אובייקטים של כללי סגנון
בקטע הזה מתוארים המאפיינים שמגדירים את אובייקטי כללי הסגנון במערך styles, כדי להתאים אישית את מאפייני המפה. כל אובייקט של כלל סגנון חייב לכלול את הפרטים הבאים:
- נכס אחד (
id). - רכיב
geometryאוlabelעם מאפייני העיצוב המשויכים שהוגדרו.
id (רכיב במפה)
המאפיין id מציין את רכיב המפה שרוצים לעצב. שמות המאפיינים הם גרסאות camelcase של שמות התכונות במפה בכלי לעריכת סגנונות.
התכונות במפה יוצרות עץ קטגוריות. אם מציינים סוג של מאפיין הורה, כמו pointOfInterest, הסגנונות שמציינים להורה חלים על כל הצאצאים שלו, כמו pointOfInterest.retail ו-pointOfInterest.lodging.
פרטים נוספים זמינים במאמר בנושא היררכיית הרכיבים במפה.
רשימת הנכסים הזמינים ב-id
אלה המאפיינים הזמינים של id:
pointOfInterestpointOfInterest.emergencypointOfInterest.emergency.firepointOfInterest.emergency.hospitalpointOfInterest.emergency.pharmacypointOfInterest.emergency.policepointOfInterest.entertainmentpointOfInterest.entertainment.artspointOfInterest.entertainment.casinopointOfInterest.entertainment.cinemapointOfInterest.entertainment.historicpointOfInterest.entertainment.museumpointOfInterest.entertainment.themeParkpointOfInterest.entertainment.touristAttractionpointOfInterest.foodAndDrinkpointOfInterest.foodAndDrink.barpointOfInterest.foodAndDrink.cafepointOfInterest.foodAndDrink.restaurantpointOfInterest.foodAndDrink.winerypointOfInterest.landmarkpointOfInterest.lodgingpointOfInterest.recreationpointOfInterest.recreation.beachpointOfInterest.recreation.boatingpointOfInterest.recreation.fishingpointOfInterest.recreation.golfCoursepointOfInterest.recreation.hotSpringpointOfInterest.recreation.natureReservepointOfInterest.recreation.parkpointOfInterest.recreation.peakpointOfInterest.recreation.sportsComplexpointOfInterest.recreation.sportsFieldpointOfInterest.recreation.trailheadpointOfInterest.recreation.zoopointOfInterest.retailpointOfInterest.retail.grocerypointOfInterest.retail.shoppingpointOfInterest.servicepointOfInterest.service.atmpointOfInterest.service.bankpointOfInterest.service.carRentalpointOfInterest.service.evChargingpointOfInterest.service.gasStationpointOfInterest.service.parkingLotpointOfInterest.service.postOfficepointOfInterest.service.restStoppointOfInterest.service.restroompointOfInterest.transitpointOfInterest.transit.airportpointOfInterest.otherpointOfInterest.other.bridgepointOfInterest.other.cemeterypointOfInterest.other.governmentpointOfInterest.other.librarypointOfInterest.other.militarypointOfInterest.other.placeOfWorshippointOfInterest.other.schoolpointOfInterest.other.townSquarepoliticalpolitical.countryOrRegionpolitical.borderpolitical.reservationpolitical.stateOrProvincepolitical.citypolitical.sublocalitypolitical.neighborhoodpolitical.landParcelinfrastructureinfrastructure.buildinginfrastructure.building.commercialinfrastructure.businessCorridorinfrastructure.roadNetworkinfrastructure.roadNetwork.noTrafficinfrastructure.roadNetwork.noTraffic.pedestrianMallinfrastructure.roadNetwork.noTraffic.trailinfrastructure.roadNetwork.noTraffic.trail.pavedinfrastructure.roadNetwork.noTraffic.trail.unpavedinfrastructure.roadNetwork.parkingAisleinfrastructure.roadNetwork.rampinfrastructure.roadNetwork.roadinfrastructure.roadNetwork.road.arterialinfrastructure.roadNetwork.road.highwayinfrastructure.roadNetwork.road.localinfrastructure.roadNetwork.road.noOutletinfrastructure.roadNetwork.roadShieldinfrastructure.roadNetwork.roadSigninfrastructure.roadNetwork.roadDetailinfrastructure.roadNetwork.roadDetail.surfaceinfrastructure.roadNetwork.roadDetail.crosswalkinfrastructure.roadNetwork.roadDetail.sidewalkinfrastructure.roadNetwork.roadDetail.intersectioninfrastructure.railwayTrackinfrastructure.railwayTrack.commercialinfrastructure.railwayTrack.commuterinfrastructure.transitStationinfrastructure.transitStation.bicycleShareinfrastructure.transitStation.busStationinfrastructure.transitStation.ferryTerminalinfrastructure.transitStation.funicularStationinfrastructure.transitStation.gondolaStationinfrastructure.transitStation.monorailinfrastructure.transitStation.railStationinfrastructure.transitStation.railStation.subwayStationinfrastructure.transitStation.railStation.tramStationinfrastructure.urbanAreanaturalnatural.continentnatural.archipelagonatural.islandnatural.landnatural.land.landCovernatural.land.landCover.cropsnatural.land.landCover.dryCropsnatural.land.landCover.forestnatural.land.landCover.icenatural.land.landCover.sandnatural.land.landCover.shrubnatural.land.landCover.tundranatural.waternatural.water.oceannatural.water.lakenatural.water.rivernatural.water.othernatural.base
רכיבים
רכיבים הם חלקי משנה של תכונה במפה. לדוגמה, כביש מורכב מהקו הגרפי (geometry) במפה, וגם מהטקסט שמציין את השם שלו (label).
הרכיבים הבאים זמינים, אבל שימו לב שיכול להיות שמאפיין מפה מסוים לא תומך באף אחד מהרכיבים, בחלק מהם או בכולם:
-
geometry: בחירת כל הרכיבים הגיאומטריים (למשל, פוליגון, קו פוליגוני) של מאפיין המפה שצוין. -
label: בחירה של כל רכיבי התווית (למשל, טקסט, סיכה) של מאפיין המפה שצוין.
מכשירים לאידוי בגדים
מעצבי סגנון הם הדרך להגדיר את כללי הסגנון לכל רכיב של מאפיין במפה.
לדוגמה, בשביל שטח בנוי, אפשר לעצב כל רכיב באופן הבא:
דוגמה לעיצוב geometry של בניין |
דוגמה לעיצוב label של בניין |
|---|---|
| אם להסתיר או להציג במפה את הפוליגון של שטח המבנה. | אם להסתיר או להציג את תווית הבניין. |
| צבע המילוי והאטימות של הפוליגון. | צבע ושקיפות המילוי של הטקסט. |
| צבע, שקיפות ורוחב הגבול. | צבע ושקיפות קו הטקסט. |
בקטע הזה מתוארות אפשרויות הסגנון השונות שזמינות לרכיבים geometry ו-label.
geometry מעצבי שיער
בטבלה הבאה מפורטים כל הכלים הזמינים לעיצוב גיאומטרי.
| Styler | סוג | תיאור |
|---|---|---|
|
בוליאני | כדי להסתיר את הפוליגון או הקו הפוליגוני של מאפיין במפה, מגדירים את הערך false. |
|
מחרוזת | התאמה אישית של צבע הפוליגון או הקו הפוליגוני באמצעות מחרוזת הקסדצימלית של RGB. |
|
מספר ממשי (float) | אפשר להתאים אישית את האטימות של הפוליגון או הקו הפוליגוני, כאשר 0 הוא שקוף ו-1 הוא אטום. |
|
מחרוזת | אפשר להתאים אישית את צבע קו המתאר באמצעות מחרוזת הקסדצימלית של RGB. |
|
מספר ממשי (float) | אפשר להתאים אישית את האטימות של קווי המתאר, כאשר 0 הוא שקוף ו-1 הוא אטום. |
|
מספר ממשי (float) | אפשר להתאים אישית את עובי קו המתאר בטווח שבין 0 ל-8. |
מידע נוסף זמין במאמר פוליגונים וקווים פוליגוניים.
label מעצבי שיער
בטבלה הבאה מפורטים כל מעצבי התוויות הזמינים.
| Styler | סוג | תיאור |
|---|---|---|
|
בוליאני | כדי להסתיר את התווית של מאפיין במפה, מגדירים את הערך false. |
|
מחרוזת | אפשר להתאים אישית את הצבע של תווית הטקסט באמצעות מחרוזת הקסדצימלית של RGB. |
|
מספר ממשי (float) | אפשר להתאים אישית את השקיפות של תווית הטקסט, כאשר 0 הוא שקוף ו-1 הוא אטום. |
|
מחרוזת | אפשר להתאים אישית את צבע קו המתאר באמצעות מחרוזת הקסדצימלית של RGB. |
|
מספר ממשי (float) | אפשר להתאים אישית את האטימות של קווי המתאר, כאשר 0 הוא שקוף ו-1 הוא אטום. |
|
מספר ממשי (float) | אפשר להתאים אישית את עובי קו המתאר בטווח שבין 0 ל-8. |
|
מחרוזת | התאמה אישית של צבע הסיכה באמצעות מחרוזת הקסדצימלית של RGB. |
|
מחרוזת | אפשר להתאים אישית את הצבע של הגליף (הסמל) בתוך סיכה באמצעות מחרוזת הקסדצימלית של RGB. |
|
מחרוזת | אפשר להתאים אישית את הצבע של קו המתאר של הסיכה באמצעות מחרוזת הקסדצימלית של RGB. |
למידע נוסף, ראו סמלים ותוויות טקסט.
רמות זום קובעות
אפשר להגדיר סגנון אחד למאפיין בכל רמות הזום הקובעות, או לציין סגנונות שונים לרמות זום קובעות שונות. אם תגדירו רק סגנון אחד, הוא ישמש בכל רמות הזום הקובעות החל מ-z0. אם אתם מגדירים סגנונות לרמות זום קובעות שונות, הסגנון יחול מרמת הזום הזו ועד לרמה הבאה שהגדרתם.
כדי להגדיר רמת זום קובעת לסגנון, במאפיין styler, מגדירים את רמת הזום הקובעת מ-z0 עד z22 ואז את ההתאמה האישית של ה-styler.
בדוגמה הבאה, צבע המים הוא שחור ברמות הזום הקובעות 0-5, אפור כהה ברמות הזום הקובעות 6-11 ואפור בהיר החל מרמת הזום הקובעת 12.
{
"id": "natural.water",
"geometry": {
"fillColor": {
"z0": "#000000",
"z6": "#666666",
"z12": "#cccccc"
}
}
}
מידע נוסף זמין במאמר רמות זום של סגנון.
מגבלות
אתם יכולים להשתמש ב-JSON כדי לעצב כמעט כל דבר במסוף Google Cloud, חוץ מהאפשרויות הבאות בתפריט Map Settings:
- שליטה בצפיפות של נקודות העניין.
- לשנות את התצוגה של מבנים (מבט-על לעומת תלת-ממד).
- לשנות את התצוגה של ציוני הדרך (מאוירת לעומת רגילה).
כדי שהאפשרויות האלה ברמת המפה יוצגו בצורה נכונה, צריך לאחזר מחדש את נתוני המשבצות. יכול להיות שזה לא יתאים לתרחישי שימוש מסוימים.
כדי להשתמש באפשרויות האלה, צריך לבחור את ההעדפה בתפריט הגדרות המפה.
האפשרויות האלה לא נכללות בסגנונות שמייצאים, ולכן צריך לבחור אותן מחדש במסוף Google Cloud כשמייבאים סגנון.