Package org.openstreetmap.josm.data.sources

Class SourceInfo<T extends ISourceCategory<?>,​U extends ISourceType<?>,​V extends SourceBounds,​W extends SourcePreferenceEntry<?>>

  • Type Parameters:
    T - The SourceCategory The categories enum for the source
    U - The SourceType The type enum of the source
    V - The SourceBounds The bound type for the entry
    W - The storage for the entry
    All Implemented Interfaces:
    java.lang.Comparable<SourceInfo<T,​U,​V,​W>>, org.openstreetmap.gui.jmapviewer.interfaces.Attributed
    Direct Known Subclasses:
    ImageryInfo
    public class SourceInfo<T extends ISourceCategory<?>,​U extends ISourceType<?>,​V extends SourceBounds,​W extends SourcePreferenceEntry<?>>
extends org.openstreetmap.gui.jmapviewer.tilesources.TileSourceInfo
implements java.lang.Comparable<SourceInfo<T,​U,​V,​W>>, org.openstreetmap.gui.jmapviewer.interfaces.Attributed
    This class is an abstraction for source information to be used in a panel like ImageryProvidersPanel.
    Since:
    16545

    • Field Summary

      Fields 
      Modifier and Type Field Description
      protected java.lang.String attributionImage
      Image of a graphical attribution displayed when using the imagery
      protected java.lang.String attributionImageURL
      Link behind the graphical attribution displayed when using the imagery
      protected java.lang.String attributionLinkURL
      Link behind the text attribution displayed when using the imagery
      protected java.lang.String attributionText
      Text of a text attribution displayed when using the imagery
      protected V bounds
      display bounds of imagery, displayed in prefs and used for automatic imagery selection
      protected T category
      category of the imagery
      protected java.lang.String categoryOriginalString
      category of the imagery (input string, not saved, copied or used otherwise except for error checks)
      protected java.lang.String countryCode
      country code of the imagery (for country specific imagery)
      protected java.util.Map<java.lang.String,​java.lang.String> customHttpHeaders
      HTTP headers
      protected java.lang.String date
      creation date of the source (in the form YYYY-MM-DD;YYYY-MM-DD, where DD and MM as well as a second date are optional).
      protected boolean defaultEntry
      whether this is a entry activated by default or not
      protected java.util.List<DefaultLayer> defaultLayers
      which layers should be activated by default on layer addition.
      protected java.lang.String description
      description of the imagery entry, should contain notes what type of data it is
      protected java.lang.String eulaAcceptanceRequired
      Whether this service requires a explicit EULA acceptance before it can be activated
      protected java.lang.String icon
      icon used in menu
      protected java.lang.String langDescription
      language of the description entry
      protected java.lang.String langName
      (original) language of the translated name entry
      private static java.util.Map<java.lang.String,​java.lang.String> localizedCountriesCache  
      protected java.util.Collection<java.lang.String> oldIds
      list of old IDs, only for loading, not handled anywhere else
      protected java.lang.String origName
      original name of the source entry in case of translation call, for multiple languages English when possible
      protected java.lang.String permissionReferenceURL
      Link to a reference stating the permission for OSM usage
      protected java.lang.String privacyPolicyURL
      Link to the privacy policy of the operator
      protected U sourceType
      type of the services - WMS, TMS, ...
      protected java.lang.String termsOfUseText
      Text with usage terms displayed when using the imagery
      protected java.lang.String termsOfUseURL
      Link behind the text with usage terms displayed when using the imagery

      • Fields inherited from class org.openstreetmap.gui.jmapviewer.tilesources.TileSourceInfo

        cookies, id, maxZoom, metadataHeaders, minZoom, modTileFeatures, name, noTileChecksums, noTileHeaders, tileSize, url

    • Constructor Summary

      Constructors 
      Constructor Description
      SourceInfo()
      Creates empty SourceInfo class
      SourceInfo​(java.lang.String name)
      Create a SourceInfo class
      SourceInfo​(java.lang.String name, java.lang.String url, java.lang.String id)
      Create a SourceInfo class

    • Method Summary

      All Methods Static Methods Instance Methods Concrete Methods 
      Modifier and Type Method Description
      void addOldId​(java.lang.String id)
      Adds an old Id.
      void clearId()
      Store the id of this info to the preferences and clear it afterwards.
      int compareTo​(SourceInfo<T,​U,​V,​W> in)  
      void copyAttribution​(SourceInfo<T,​U,​V,​W> i)
      Copies attribution from another SourceInfo.
      boolean equals​(java.lang.Object o)  
      boolean equalsBaseValues​(SourceInfo<T,​U,​V,​W> in)
      Determines if URL is equal to given source info.
      boolean equalsPref​(SourceInfo<T,​U,​V,​W> other)
      Check if this object equals another SourceInfo with respect to the properties that get written to the preference file.
      static <W extends SourceInfo<?,​?,​?,​?>>
      java.util.Collection<java.lang.String>      		 getActiveIds​(java.lang.Class<W> clazz)
      Return the sorted list of activated source IDs.
      java.awt.Image getAttributionImage()  
      java.lang.String getAttributionImageRaw()
      Return the raw attribution logo information (an URL to the image).
      java.lang.String getAttributionImageURL()  
      java.lang.String getAttributionLinkURL()  
      java.lang.String getAttributionText​(int zoom, org.openstreetmap.gui.jmapviewer.interfaces.ICoordinate topLeft, org.openstreetmap.gui.jmapviewer.interfaces.ICoordinate botRight)  
      V getBounds()
      Returns the source polygonal bounds.
      java.lang.String getCountryCode()
      Returns the ISO 3166-1-alpha-2 country code.
      java.util.Map<java.lang.String,​java.lang.String> getCustomHttpHeaders()
      Returns custom HTTP headers that should be sent with request towards imagery provider
      java.lang.String getDate()
      Returns the date information.
      java.util.List<DefaultLayer> getDefaultLayers()
      Returns default layers that should be shown for this Imagery (if at all supported by imagery provider) If no layer is set to default and there is more than one imagery available, then user will be asked to choose the layer to work on
      java.lang.String getDescription()
      Returns the description text when existing.
      java.lang.String getEulaAcceptanceRequired()
      Returns the EULA acceptance URL, if any.
      java.lang.String getIcon()
      Returns the entry icon.
      static java.lang.String getLocalizedCountry​(java.lang.String countryCode)
      Returns a localized name for the given country code, or "Worldwide" if empty.
      java.util.Map<java.lang.String,​java.util.Set<java.lang.String>> getNoTileChecksums()  
      java.util.Map<java.lang.String,​java.util.Set<java.lang.String>> getNoTileHeaders()  
      java.util.Collection<java.lang.String> getOldIds()
      Get old Ids.
      java.lang.String getOriginalName()
      Returns the entry name.
      java.lang.String getPermissionReferenceURL()
      Return the permission reference URL.
      java.lang.String getPrivacyPolicyURL()
      Return the privacy policy URL.
      T getSourceCategory()
      Returns the source category.
      java.lang.String getSourceCategoryOriginalString()
      Returns the source category original string (don't use except for error checks).
      U getSourceType()
      Returns the source type.
      java.lang.String getTermsOfUseText()  
      java.lang.String getTermsOfUseURL()  
      java.lang.String getToolTipText()
      Returns a tool tip text for display.
      boolean hasAttribution()
      Determines if this entry requires attribution.
      int hashCode()  
      boolean isBlacklisted()
      Returns true if this layer's URL is matched by one of the regular expressions kept by the current OsmApi instance.
      boolean isDefaultEntry()
      Determines if this entry is enabled by default.
      boolean requiresAttribution()  
      void setAttribution​(org.openstreetmap.gui.jmapviewer.tilesources.AbstractTileSource s)
      Applies the attribution from this object to a tile source.
      void setAttributionImage​(java.lang.String res)
      Set the image for the attribution
      void setAttributionImageURL​(java.lang.String url)
      Set the attribution image
      void setAttributionLinkURL​(java.lang.String url)
      Sets the URL the attribution should link to.
      void setAttributionText​(java.lang.String text)
      Set the attribution text
      void setBounds​(V b)
      Sets the source polygonal bounds.
      void setCountryCode​(java.lang.String countryCode)
      Sets the ISO 3166-1-alpha-2 country code.
      void setCustomHttpHeaders​(java.util.Map<java.lang.String,​java.lang.String> customHttpHeaders)
      Sets custom HTTP headers that should be sent with request towards imagery provider
      void setDate​(java.lang.String date)
      Sets the date information.
      void setDefaultEntry​(boolean defaultEntry)
      Sets the default state of this entry.
      void setDefaultLayers​(java.util.List<DefaultLayer> layers)
      Sets the default layers that user will work with
      void setDescription​(java.lang.String language, java.lang.String description)
      Sets the description text when existing.
      void setEulaAcceptanceRequired​(java.lang.String eulaAcceptanceRequired)
      Sets the EULA acceptance URL.
      void setIcon​(java.lang.String icon)
      Sets the entry icon.
      void setMetadataHeaders​(java.util.Map<java.lang.String,​java.lang.String> metadataHeaders)
      Returns the map of <header name, metadata key> indicating, which HTTP headers should be moved to metadata
      void setName​(java.lang.String language, java.lang.String name)
      Sets the entry name and handle translation.
      void setNoTileChecksums​(MultiMap<java.lang.String,​java.lang.String> noTileChecksums)
      Sets the map of <checksum type, checksum value> that if any tile with that checksum will be returned, then this tile will be treated as "no tile at this zoom level"
      void setNoTileHeaders​(MultiMap<java.lang.String,​java.lang.String> noTileHeaders)
      Sets the map of <header name, header value> that if any of this header will be returned, then this tile will be treated as "no tile at this zoom level"
      void setPermissionReferenceURL​(java.lang.String url)
      Sets the permission reference URL.
      void setPrivacyPolicyURL​(java.lang.String url)
      Sets the privacy policy URL.
      void setSourceCategory​(T category)
      Sets the source category.
      void setSourceCategoryOriginalString​(java.lang.String categoryOriginalString)
      Sets the source category original string (don't use except for error checks).
      void setSourceType​(U imageryType)
      Sets the source type.
      void setTermsOfUseText​(java.lang.String text)
      Sets the text to display to the user as terms of use.
      void setTermsOfUseURL​(java.lang.String text)
      Sets a url that links to the terms of use text.
      java.lang.String toString()  

      • Methods inherited from class org.openstreetmap.gui.jmapviewer.tilesources.TileSourceInfo

        getCookies, getId, getMaxZoom, getMetadataHeaders, getMinZoom, getName, getTileSize, getUrl, isModTileFeatures, setCookies, setId, setModTileFeatures, setName, setTileSize, setUrl

      • Methods inherited from class java.lang.Object

        clone, finalize, getClass, notify, notifyAll, wait, wait, wait

    • Field Detail

      • origName

        protected java.lang.String origName
        original name of the source entry in case of translation call, for multiple languages English when possible

      • langName

        protected java.lang.String langName
        (original) language of the translated name entry

      • defaultEntry

        protected boolean defaultEntry
        whether this is a entry activated by default or not

      • eulaAcceptanceRequired

        protected java.lang.String eulaAcceptanceRequired
        Whether this service requires a explicit EULA acceptance before it can be activated

      • bounds

        protected V extends SourceBounds bounds
        display bounds of imagery, displayed in prefs and used for automatic imagery selection

      • description

        protected java.lang.String description
        description of the imagery entry, should contain notes what type of data it is

      • langDescription

        protected java.lang.String langDescription
        language of the description entry

      • attributionText

        protected java.lang.String attributionText
        Text of a text attribution displayed when using the imagery

      • privacyPolicyURL

        protected java.lang.String privacyPolicyURL
        Link to the privacy policy of the operator

      • permissionReferenceURL

        protected java.lang.String permissionReferenceURL
        Link to a reference stating the permission for OSM usage

      • attributionLinkURL

        protected java.lang.String attributionLinkURL
        Link behind the text attribution displayed when using the imagery

      • attributionImage

        protected java.lang.String attributionImage
        Image of a graphical attribution displayed when using the imagery

      • attributionImageURL

        protected java.lang.String attributionImageURL
        Link behind the graphical attribution displayed when using the imagery

      • termsOfUseText

        protected java.lang.String termsOfUseText
        Text with usage terms displayed when using the imagery

      • termsOfUseURL

        protected java.lang.String termsOfUseURL
        Link behind the text with usage terms displayed when using the imagery

      • countryCode

        protected java.lang.String countryCode
        country code of the imagery (for country specific imagery)

      • date

        protected java.lang.String date
        creation date of the source (in the form YYYY-MM-DD;YYYY-MM-DD, where DD and MM as well as a second date are optional).

        Also used as time filter for WMS time={time} parameter (such as Sentinel-2)

        Since:
        11570

      • oldIds

        protected java.util.Collection<java.lang.String> oldIds
        list of old IDs, only for loading, not handled anywhere else
        Since:
        13536

      • icon

        protected java.lang.String icon
        icon used in menu

      • defaultLayers

        protected java.util.List<DefaultLayer> defaultLayers
        which layers should be activated by default on layer addition.

      • customHttpHeaders

        protected java.util.Map<java.lang.String,​java.lang.String> customHttpHeaders
        HTTP headers

      • categoryOriginalString

        protected java.lang.String categoryOriginalString
        category of the imagery (input string, not saved, copied or used otherwise except for error checks)

      • localizedCountriesCache

        private static final java.util.Map<java.lang.String,​java.lang.String> localizedCountriesCache

    • Constructor Detail

      • SourceInfo

        public SourceInfo()
        Creates empty SourceInfo class

      • SourceInfo

        public SourceInfo​(java.lang.String name)
        Create a SourceInfo class
        Parameters:
        name - name

      • SourceInfo

        public SourceInfo​(java.lang.String name,
                  java.lang.String url,
                  java.lang.String id)
        Create a SourceInfo class
        Parameters:
        name - name
        url - base URL
        id - unique id

    • Method Detail

      • hashCode

        public int hashCode()
        Overrides:
        hashCode in class java.lang.Object

      • equalsPref

        public boolean equalsPref​(SourceInfo<T,​U,​V,​W> other)
        Check if this object equals another SourceInfo with respect to the properties that get written to the preference file.

        This should be overridden and called in subclasses.

        Parameters:
        other - the SourceInfo object to compare to
        Returns:
        true if they are equal

      • equals

        public boolean equals​(java.lang.Object o)
        Overrides:
        equals in class java.lang.Object

      • getLocalizedCountry

        public static java.lang.String getLocalizedCountry​(java.lang.String countryCode)
        Returns a localized name for the given country code, or "Worldwide" if empty. This function falls back on the English name, and uses the ISO code as a last-resortvalue.
        Parameters:
        countryCode - An ISO 3166 alpha-2 country code or a UN M.49 numeric-3 area code
        Returns:
        The name of the country appropriate to the current locale.
        Since:
        15158
        See Also:
        Locale.getDisplayCountry()

      • toString

        public java.lang.String toString()
        Overrides:
        toString in class java.lang.Object

      • equalsBaseValues

        public boolean equalsBaseValues​(SourceInfo<T,​U,​V,​W> in)
        Determines if URL is equal to given source info.
        Parameters:
        in - source info
        Returns:
        true if URL is equal to given source info

      • setBounds

        public void setBounds​(V b)
        Sets the source polygonal bounds.
        Parameters:
        b - The source bounds (non-rectangular)

      • getBounds

        public V getBounds()
        Returns the source polygonal bounds.
        Returns:
        The source bounds (non-rectangular)

      • requiresAttribution

        public boolean requiresAttribution()
        Specified by:
        requiresAttribution in interface org.openstreetmap.gui.jmapviewer.interfaces.Attributed

      • getAttributionText

        public java.lang.String getAttributionText​(int zoom,
                                           org.openstreetmap.gui.jmapviewer.interfaces.ICoordinate topLeft,
                                           org.openstreetmap.gui.jmapviewer.interfaces.ICoordinate botRight)
        Specified by:
        getAttributionText in interface org.openstreetmap.gui.jmapviewer.interfaces.Attributed

      • getAttributionLinkURL

        public java.lang.String getAttributionLinkURL()
        Specified by:
        getAttributionLinkURL in interface org.openstreetmap.gui.jmapviewer.interfaces.Attributed

      • getAttributionImage

        public java.awt.Image getAttributionImage()
        Specified by:
        getAttributionImage in interface org.openstreetmap.gui.jmapviewer.interfaces.Attributed

      • getAttributionImageRaw

        public java.lang.String getAttributionImageRaw()
        Return the raw attribution logo information (an URL to the image).
        Returns:
        The url text
        Since:
        12257

      • getAttributionImageURL

        public java.lang.String getAttributionImageURL()
        Specified by:
        getAttributionImageURL in interface org.openstreetmap.gui.jmapviewer.interfaces.Attributed

      • getTermsOfUseText

        public java.lang.String getTermsOfUseText()
        Specified by:
        getTermsOfUseText in interface org.openstreetmap.gui.jmapviewer.interfaces.Attributed

      • getTermsOfUseURL

        public java.lang.String getTermsOfUseURL()
        Specified by:
        getTermsOfUseURL in interface org.openstreetmap.gui.jmapviewer.interfaces.Attributed

      • setTermsOfUseText

        public void setTermsOfUseText​(java.lang.String text)
        Sets the text to display to the user as terms of use.
        Parameters:
        text - The text
        See Also:
        getTermsOfUseText()

      • setTermsOfUseURL

        public void setTermsOfUseURL​(java.lang.String text)
        Sets a url that links to the terms of use text.
        Parameters:
        text - The url.
        See Also:
        getTermsOfUseURL()

      • getOriginalName

        public java.lang.String getOriginalName()
        Returns the entry name.
        Returns:
        The entry name
        Since:
        6968

      • setName

        public void setName​(java.lang.String language,
                    java.lang.String name)
        Sets the entry name and handle translation.
        Parameters:
        language - The used language
        name - The entry name
        Since:
        8091

      • clearId

        public void clearId()
        Store the id of this info to the preferences and clear it afterwards.

      • isDefaultEntry

        public boolean isDefaultEntry()
        Determines if this entry is enabled by default.
        Returns:
        true if this entry is enabled by default, false otherwise

      • setDefaultEntry

        public void setDefaultEntry​(boolean defaultEntry)
        Sets the default state of this entry.
        Parameters:
        defaultEntry - true if this entry has to be enabled by default, false otherwise

      • getDescription

        public java.lang.String getDescription()
        Returns the description text when existing.
        Returns:
        The description
        Since:
        8065

      • setDescription

        public void setDescription​(java.lang.String language,
                           java.lang.String description)
        Sets the description text when existing.
        Parameters:
        language - The used language
        description - the imagery description text
        Since:
        8091

      • getActiveIds

        public static <W extends SourceInfo<?,​?,​?,​?>> java.util.Collection<java.lang.String> getActiveIds​(java.lang.Class<W> clazz)
        Return the sorted list of activated source IDs.
        Type Parameters:
        W - The type of active id to get
        Parameters:
        clazz - The class of the type of id
        Returns:
        sorted list of activated source IDs
        Since:
        13536, 16545 (extracted)

      • getToolTipText

        public java.lang.String getToolTipText()
        Returns a tool tip text for display.
        Returns:
        The text
        Since:
        8065

      • getEulaAcceptanceRequired

        public java.lang.String getEulaAcceptanceRequired()
        Returns the EULA acceptance URL, if any.
        Returns:
        The URL to an EULA text that has to be accepted before use, or null

      • setEulaAcceptanceRequired

        public void setEulaAcceptanceRequired​(java.lang.String eulaAcceptanceRequired)
        Sets the EULA acceptance URL.
        Parameters:
        eulaAcceptanceRequired - The URL to an EULA text that has to be accepted before use

      • getCountryCode

        public java.lang.String getCountryCode()
        Returns the ISO 3166-1-alpha-2 country code.
        Returns:
        The country code (2 letters)

      • setCountryCode

        public void setCountryCode​(java.lang.String countryCode)
        Sets the ISO 3166-1-alpha-2 country code.
        Parameters:
        countryCode - The country code (2 letters)

      • getDate

        public java.lang.String getDate()
        Returns the date information.
        Returns:
        The date (in the form YYYY-MM-DD;YYYY-MM-DD, where DD and MM as well as a second date are optional)
        Since:
        11570

      • setDate

        public void setDate​(java.lang.String date)
        Sets the date information.
        Parameters:
        date - The date information
        Since:
        11570

      • getIcon

        public java.lang.String getIcon()
        Returns the entry icon.
        Returns:
        The entry icon

      • setIcon

        public void setIcon​(java.lang.String icon)
        Sets the entry icon.
        Parameters:
        icon - The entry icon

      • hasAttribution

        public boolean hasAttribution()
        Determines if this entry requires attribution.
        Returns:
        true if some attribution text has to be displayed, false otherwise

      • copyAttribution

        public void copyAttribution​(SourceInfo<T,​U,​V,​W> i)
        Copies attribution from another SourceInfo.
        Parameters:
        i - The other source info to get attribution from

      • setAttribution

        public void setAttribution​(org.openstreetmap.gui.jmapviewer.tilesources.AbstractTileSource s)
        Applies the attribution from this object to a tile source.
        Parameters:
        s - The tile source

      • getSourceType

        public U getSourceType()
        Returns the source type.
        Returns:
        The source type

      • setSourceType

        public void setSourceType​(U imageryType)
        Sets the source type.
        Parameters:
        imageryType - The source type

      • getSourceCategory

        public T getSourceCategory()
        Returns the source category.
        Returns:
        The source category

      • setSourceCategory

        public void setSourceCategory​(T category)
        Sets the source category.
        Parameters:
        category - The source category

      • getSourceCategoryOriginalString

        public java.lang.String getSourceCategoryOriginalString()
        Returns the source category original string (don't use except for error checks).
        Returns:
        The source category original string

      • setSourceCategoryOriginalString

        public void setSourceCategoryOriginalString​(java.lang.String categoryOriginalString)
        Sets the source category original string (don't use except for error checks).
        Parameters:
        categoryOriginalString - The source category original string

      • isBlacklisted

        public boolean isBlacklisted()
        Returns true if this layer's URL is matched by one of the regular expressions kept by the current OsmApi instance.
        Returns:
        true is this entry is blacklisted, false otherwise

      • setNoTileHeaders

        public void setNoTileHeaders​(MultiMap<java.lang.String,​java.lang.String> noTileHeaders)
        Sets the map of <header name, header value> that if any of this header will be returned, then this tile will be treated as "no tile at this zoom level"
        Parameters:
        noTileHeaders - Map of <header name, header value> which will be treated as "no tile at this zoom level"
        Since:
        9613

      • getNoTileHeaders

        public java.util.Map<java.lang.String,​java.util.Set<java.lang.String>> getNoTileHeaders()
        Overrides:
        getNoTileHeaders in class org.openstreetmap.gui.jmapviewer.tilesources.TileSourceInfo

      • setNoTileChecksums

        public void setNoTileChecksums​(MultiMap<java.lang.String,​java.lang.String> noTileChecksums)
        Sets the map of <checksum type, checksum value> that if any tile with that checksum will be returned, then this tile will be treated as "no tile at this zoom level"
        Parameters:
        noTileChecksums - Map of <checksum type, checksum value> which will be treated as "no tile at this zoom level"
        Since:
        9613

      • getNoTileChecksums

        public java.util.Map<java.lang.String,​java.util.Set<java.lang.String>> getNoTileChecksums()
        Overrides:
        getNoTileChecksums in class org.openstreetmap.gui.jmapviewer.tilesources.TileSourceInfo

      • setMetadataHeaders

        public void setMetadataHeaders​(java.util.Map<java.lang.String,​java.lang.String> metadataHeaders)
        Returns the map of <header name, metadata key> indicating, which HTTP headers should be moved to metadata
        Parameters:
        metadataHeaders - map of <header name, metadata key> indicating, which HTTP headers should be moved to metadata
        Since:
        8418

      • addOldId

        public void addOldId​(java.lang.String id)
        Adds an old Id.
        Parameters:
        id - the Id to be added
        Since:
        13536

      • getOldIds

        public java.util.Collection<java.lang.String> getOldIds()
        Get old Ids.
        Returns:
        collection of ids
        Since:
        13536

      • getDefaultLayers

        public java.util.List<DefaultLayer> getDefaultLayers()
        Returns default layers that should be shown for this Imagery (if at all supported by imagery provider) If no layer is set to default and there is more than one imagery available, then user will be asked to choose the layer to work on
        Returns:
        Collection of the layer names

      • setDefaultLayers

        public void setDefaultLayers​(java.util.List<DefaultLayer> layers)
        Sets the default layers that user will work with
        Parameters:
        layers - set the list of default layers

      • getCustomHttpHeaders

        public java.util.Map<java.lang.String,​java.lang.String> getCustomHttpHeaders()
        Returns custom HTTP headers that should be sent with request towards imagery provider
        Returns:
        headers

      • setCustomHttpHeaders

        public void setCustomHttpHeaders​(java.util.Map<java.lang.String,​java.lang.String> customHttpHeaders)
        Sets custom HTTP headers that should be sent with request towards imagery provider
        Parameters:
        customHttpHeaders - http headers