Each package has a page that contains a list of its classes and interfaces, with a summary for each. This page can contain six categories:
+Each class, interface, nested class and nested interface has its own separate page. Each of these pages has three sections consisting of a class/interface description, summary tables, and detailed member descriptions:
+Each summary entry contains the first sentence from the detailed description for that item. The summary entries are alphabetical, while the detailed descriptions are in the order they appear in the source code. This preserves the logical groupings established by the programmer.
+Each annotation type has its own separate page with the following sections:
+Each enum has its own separate page with the following sections:
+Each documented package, class and interface has its own Use page. This page describes what packages, classes, methods, constructors and fields use any part of the given class or package. Given a class or interface A, its Use page includes subclasses of A, fields declared as A, methods that return A, and methods and constructors with parameters of type A. You can access this page by first going to the package, class or interface, then clicking on the "Use" link in the navigation bar.
+There is a Class Hierarchy page for all packages, plus a hierarchy for each package. Each hierarchy page contains a list of classes and a list of interfaces. The classes are organized by inheritance structure starting with java.lang.Object. The interfaces do not inherit from java.lang.Object.
The Deprecated API page lists all of the API that have been deprecated. A deprecated API is not recommended for use, generally due to improvements, and a replacement API is usually given. Deprecated APIs may be removed in future implementations.
+The Index contains an alphabetic list of all classes, interfaces, constructors, methods, and fields.
+These links take you to the next or previous class, interface, package, or related page.
+These links show and hide the HTML frames. All pages are available with or without frames.
+The All Classes link shows all classes and interfaces except non-static nested types.
+Each serializable or externalizable class has a description of its serialization fields and methods. This information is of interest to re-implementors, not to developers using the API. While there is no link in the navigation bar, you can get to this information by going to any serialized class and clicking "Serialized Form" in the "See also" section of the class description.
+The Constant Field Values page lists the static final fields and their values.
+public abstract class StreetsideAbstractImage +extends java.lang.Object +implements java.lang.Comparable<StreetsideAbstractImage>+
StreetsideImportedImage and StreetsideImage.| Modifier and Type | +Method and Description | +
|---|---|
long |
+getCd()
+Returns the Epoch time when the image was captured.
+ |
+
java.lang.String |
+getDate()
+Returns the date the picture was taken in DMY format.
+ |
+
java.lang.String |
+getDate(java.lang.String format)
+Returns the date the picture was taken in the given format.
+ |
+
double |
+getHe()
+Returns the original direction towards the image has been taken.
+ |
+
java.lang.String |
+getId() |
+
org.openstreetmap.josm.data.coor.LatLon |
+getLatLon()
+Returns a LatLon object containing the original coordinates of the object.
+ |
+
double |
+getMovingHe()
+Returns the direction towards the image has been taken.
+ |
+
org.openstreetmap.josm.data.coor.LatLon |
+getMovingLatLon()
+Returns a LatLon object containing the current coordinates of the object.
+ |
+
org.openstreetmap.josm.plugins.streetside.StreetsideSequence |
+getSequence()
+Returns the sequence which contains this image.
+ |
+
double |
+getTempHe()
+Returns the last fixed direction of the object.
+ |
+
org.openstreetmap.josm.data.coor.LatLon |
+getTempLatLon()
+Returns the last fixed coordinates of the object.
+ |
+
boolean |
+isModified()
+Returns whether the object has been modified or not.
+ |
+
boolean |
+isVisible()
+Returns whether the image is visible on the map or not.
+ |
+
void |
+move(double x,
+ double y)
+Moves the image temporally to another position
+ |
+
StreetsideAbstractImage |
+next()
+If the StreetsideImage belongs to a StreetsideSequence, returns the next
+ image in the sequence.
+ |
+
StreetsideAbstractImage |
+previous()
+If the StreetsideImage belongs to a StreetsideSequence, returns the previous
+ image in the sequence.
+ |
+
void |
+setCd(long cd)
+Sets the Epoch time when the picture was captured.
+ |
+
void |
+setHe(double he) |
+
void |
+setId(java.lang.String id) |
+
void |
+setLatLon(org.openstreetmap.josm.data.coor.LatLon latLon) |
+
void |
+setSequence(org.openstreetmap.josm.plugins.streetside.StreetsideSequence sequence)
+Sets the StreetsideSequence object which contains the StreetsideImage.
+ |
+
void |
+setVisible(boolean visible)
+Set's whether the image should be visible on the map or not.
+ |
+
void |
+stopMoving()
+Called when the mouse button is released, meaning that the picture has
+ stopped being dragged, so the temporal values are saved.
+ |
+
void |
+turn(double ca)
+Turns the image direction.
+ |
+
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, waitcompareTopublic java.lang.String getId()+
public void setId(java.lang.String id)+
id - the id to setpublic double getHe()+
public long getCd()+
public java.lang.String getDate()+
public java.lang.String getDate(java.lang.String format)+
format - Format of the date. See SimpleDateFormat.java.lang.NullPointerException - if parameter format is nullpublic org.openstreetmap.josm.data.coor.LatLon getLatLon()+
public double getMovingHe()+
public org.openstreetmap.josm.data.coor.LatLon getMovingLatLon()+
public org.openstreetmap.josm.plugins.streetside.StreetsideSequence getSequence()+
public double getTempHe()+
public org.openstreetmap.josm.data.coor.LatLon getTempLatLon()+
public boolean isModified()+
public boolean isVisible()+
public void move(double x, + double y)+
x - The movement of the image in longitude units.y - The movement of the image in latitude units.public StreetsideAbstractImage next()+
public StreetsideAbstractImage previous()+
public void setHe(double he)+
public void setCd(long cd)+
cd - Epoch time when the image was captured.public void setLatLon(org.openstreetmap.josm.data.coor.LatLon latLon)+
public void setSequence(org.openstreetmap.josm.plugins.streetside.StreetsideSequence sequence)+
sequence - The StreetsideSequence that contains the StreetsideImage.java.lang.IllegalArgumentException - if the image is not already part of the
+ StreetsideSequence. Call
+ StreetsideSequence.add(StreetsideAbstractImage) first.public void setVisible(boolean visible)+
visible - true if the image is set to be visible; false otherwise.public void stopMoving()+
public void turn(double ca)+
ca - The angle the image is moving.| Modifier and Type | +Method and Description | +
|---|---|
StreetsideAbstractImage |
+StreetsideAbstractImage.next()
+If the StreetsideImage belongs to a StreetsideSequence, returns the next
+ image in the sequence.
+ |
+
StreetsideAbstractImage |
+StreetsideAbstractImage.previous()
+If the StreetsideImage belongs to a StreetsideSequence, returns the previous
+ image in the sequence.
+ |
+
See: Description
+| Class | +Description | +
|---|---|
| StreetsideAbstractImage | +
+ Abstract superclass for all image objects.
+ |
+
| Class and Description | +
|---|
| StreetsideAbstractImage
+ Abstract superclass for all image objects.
+ |
+
| StreetsideSequence
+ Class that stores a sequence of
+StreetsideAbstractImage objects. |
+
null
+ */
+ public String getDate(String format) {
+ final Date date = new Date(getCd());
+ final SimpleDateFormat formatter = new SimpleDateFormat(format, Locale.US);
+ formatter.setTimeZone(Calendar.getInstance().getTimeZone());
+ return formatter.format(date);
+ }
+
+ /**
+ * Returns a LatLon object containing the original coordinates of the object.
+ *
+ * @return The LatLon object with the position of the object.
+ */
+ public LatLon getLatLon() {
+ return latLon;
+ }
+
+ /**
+ * Returns the direction towards the image has been taken.
+ *
+ * @return The direction of the image (0 means north and goes clockwise).
+ */
+ public double getMovingHe() {
+ return movingHe;
+ }
+
+ /**
+ * Returns a LatLon object containing the current coordinates of the object.
+ * When you are dragging the image this changes.
+ *
+ * @return The LatLon object with the position of the object.
+ */
+ public LatLon getMovingLatLon() {
+ return movingLatLon;
+ }
+
+ /**
+ * Returns the sequence which contains this image. Never null.
+ *
+ * @return The StreetsideSequence object that contains this StreetsideImage.
+ */
+
+ public StreetsideSequence getSequence() {
+ synchronized (this) {
+ if (sequence == null) {
+ sequence = new StreetsideSequence();
+ sequence.add(this);
+ }
+ return sequence;
+ }
+ }
+
+ /**
+ * Returns the last fixed direction of the object.
+ *
+ * @return The last fixed direction of the object. 0 means north.
+ */
+ public double getTempHe() {
+ return tempHe;
+ }
+
+ /**
+ * Returns the last fixed coordinates of the object.
+ *
+ * @return A LatLon object containing.
+ */
+ public LatLon getTempLatLon() {
+ return tempLatLon;
+ }
+
+ /**
+ * Returns whether the object has been modified or not.
+ *
+ * @return true if the object has been modified; false otherwise.
+ */
+ public boolean isModified() {
+ return !getMovingLatLon().equals(latLon) || Math.abs(getMovingHe() - cd) > EPSILON;
+ }
+
+ /**
+ * Returns whether the image is visible on the map or not.
+ *
+ * @return True if the image is visible; false otherwise.
+ */
+ public boolean isVisible() {
+ return visible;
+ }
+
+ /**
+ * Moves the image temporally to another position
+ *
+ * @param x
+ * The movement of the image in longitude units.
+ * @param y
+ * The movement of the image in latitude units.
+ */
+ public void move(final double x, final double y) {
+ movingLatLon = new LatLon(tempLatLon.getY() + y, tempLatLon.getX() + x);
+ }
+
+ /**
+ * If the StreetsideImage belongs to a StreetsideSequence, returns the next
+ * image in the sequence.
+ *
+ * @return The following StreetsideImage, or null if there is none.
+ */
+ public StreetsideAbstractImage next() {
+ synchronized (this) {
+ return getSequence().next(this);
+ }
+ }
+
+ /**
+ * If the StreetsideImage belongs to a StreetsideSequence, returns the previous
+ * image in the sequence.
+ *
+ * @return The previous StreetsideImage, or null if there is none.
+ */
+ public StreetsideAbstractImage previous() {
+ synchronized (this) {
+ return getSequence().previous(this);
+ }
+ }
+
+ public void setHe(final double he) {
+ this.he = he;
+ }
+
+ /**
+ * Sets the Epoch time when the picture was captured.
+ *
+ * @param cd
+ * Epoch time when the image was captured.
+ */
+ public synchronized void setCd(final long cd) {
+ this.cd = cd;
+ }
+
+ public void setLatLon(final LatLon latLon) {
+ if (latLon != null) {
+ this.latLon = latLon;
+ }
+ }
+
+ /**
+ * Sets the StreetsideSequence object which contains the StreetsideImage.
+ *
+ * @param sequence
+ * The StreetsideSequence that contains the StreetsideImage.
+ * @throws IllegalArgumentException
+ * if the image is not already part of the
+ * {@link StreetsideSequence}. Call
+ * {@link StreetsideSequence#add(StreetsideAbstractImage)} first.
+ */
+ public void setSequence(final StreetsideSequence sequence) {
+ synchronized (this) {
+ if (sequence != null && !sequence.getImages().contains(this)) {
+ throw new IllegalArgumentException();
+ }
+ this.sequence = sequence;
+ }
+ }
+
+ /**
+ * Set's whether the image should be visible on the map or not.
+ *
+ * @param visible
+ * true if the image is set to be visible; false otherwise.
+ */
+ public void setVisible(final boolean visible) {
+ this.visible = visible;
+ }
+
+ /**
+ * Called when the mouse button is released, meaning that the picture has
+ * stopped being dragged, so the temporal values are saved.
+ */
+ public void stopMoving() {
+ tempLatLon = movingLatLon;
+ tempHe = movingHe;
+ }
+
+ /**
+ * Turns the image direction.
+ *
+ * @param ca
+ * The angle the image is moving.
+ */
+ public void turn(final double ca) {
+ movingHe = tempHe + ca;
+ }
+}
Index: applications/editors/josm/plugins/MicrosoftStreetside/src/org/openstreetmap/josm/plugins/streetside/StreetsideCubemap.java
===================================================================
--- applications/editors/josm/plugins/MicrosoftStreetside/src/org/openstreetmap/josm/plugins/streetside/StreetsideCubemap.java (revision 34317)
+++ applications/editors/josm/plugins/MicrosoftStreetside/src/org/openstreetmap/josm/plugins/streetside/StreetsideCubemap.java (revision 34317)
@@ -0,0 +1,141 @@
+// License: GPL. For details, see LICENSE file.
+package org.openstreetmap.josm.plugins.streetside;
+
+import java.awt.image.BufferedImage;
+import java.util.EnumSet;
+import java.util.HashMap;
+import java.util.Map;
+
+import org.openstreetmap.josm.data.coor.LatLon;
+import org.openstreetmap.josm.plugins.streetside.cubemap.CubemapUtils;
+import org.openstreetmap.josm.plugins.streetside.utils.StreetsideProperties;
+
+import org.openstreetmap.josm.plugins.streetside.cubemap.CubemapUtils.CubemapFaces;
+
+/**
+ * @author renerr18
+ *
+ *
+ */
+public class StreetsideCubemap extends StreetsideAbstractImage implements Comparablenull, no popup will be shown.
+ */
+ private Component popupParent;
+ /**
+ * The UNIX epoch time when the popup for this action was shown the last time
+ */
+ private long lastPopupShowTime;
+ /**
+ * The contents that are transfered into the clipboard when the action is executed.
+ * If this is null, the clipboard won't be changed.
+ */
+ private Transferable contents;
+
+ public ClipboardAction(final String name, final Transferable contents) {
+ super(name, ImageProvider.get("copy", ImageSizes.SMALLICON));
+ this.contents = contents;
+
+ // Init popup
+ popup = new JPopupMenu();
+ // TODO: tr( RRH
+ JLabel label = new JLabel(I18n.tr("Key copied to clipboard") + '…');
+ label.setBorder(BorderFactory.createEmptyBorder(5, 5, 5, 5));
+ popup.add(label);
+ popup.setBackground(new Color(0f, 0f, 0f, .5f));
+ label.setForeground(Color.WHITE);
+ }
+
+ /**
+ * @param contents the contents, which should be copied to the clipboard when the {@link Action} is executed
+ */
+ public void setContents(Transferable contents) {
+ this.contents = contents;
+ setEnabled(contents != null);
+ }
+
+ /**
+ * Sets the component, under which the popup will be shown, which indicates that the key was copied to the clipboard.
+ * @param popupParent the component to set as parent of the popup
+ */
+ public void setPopupParent(Component popupParent) {
+ this.popupParent = popupParent;
+ }
+
+ /* (non-Javadoc)
+ * @see java.awt.event.ActionListener#actionPerformed(java.awt.event.ActionEvent)
+ */
+ @Override
+ public void actionPerformed(ActionEvent e) {
+ if (contents != null) {
+ Toolkit.getDefaultToolkit().getSystemClipboard().setContents(contents, null);
+ if (popupParent != null) {
+ popup.show(popupParent, 0, popupParent.getHeight() + 2);
+ new Thread(() -> {
+ long threadStart = System.currentTimeMillis();
+ lastPopupShowTime = threadStart;
+ try {
+ Thread.sleep(POPUP_DURATION);
+ } catch (InterruptedException e1) {
+ if (threadStart == lastPopupShowTime) {
+ popup.setVisible(false);
+ }
+ }
+ if (System.currentTimeMillis() >= lastPopupShowTime + POPUP_DURATION) {
+ popup.setVisible(false);
+ }
+ }).start();
+ }
+ }
+ }
+
+}
Index: applications/editors/josm/plugins/MicrosoftStreetside/src/org/openstreetmap/josm/plugins/streetside/gui/imageinfo/ImageInfoHelpPopup.java
===================================================================
--- applications/editors/josm/plugins/MicrosoftStreetside/src/org/openstreetmap/josm/plugins/streetside/gui/imageinfo/ImageInfoHelpPopup.java (revision 34317)
+++ applications/editors/josm/plugins/MicrosoftStreetside/src/org/openstreetmap/josm/plugins/streetside/gui/imageinfo/ImageInfoHelpPopup.java (revision 34317)
@@ -0,0 +1,92 @@
+// License: GPL. For details, see LICENSE file.
+package org.openstreetmap.josm.plugins.streetside.gui.imageinfo;
+
+import java.awt.BorderLayout;
+import java.awt.Color;
+import java.awt.Component;
+import java.awt.IllegalComponentStateException;
+import java.awt.event.ActionEvent;
+
+import javax.swing.AbstractAction;
+import javax.swing.JLabel;
+import javax.swing.JPanel;
+import javax.swing.JPopupMenu;
+import javax.swing.JTextPane;
+
+import org.openstreetmap.josm.plugins.streetside.gui.boilerplate.SelectableLabel;
+import org.openstreetmap.josm.plugins.streetside.gui.boilerplate.StreetsideButton;
+import org.openstreetmap.josm.plugins.streetside.utils.StreetsideColorScheme;
+import org.openstreetmap.josm.plugins.streetside.utils.StreetsideProperties;
+import org.openstreetmap.josm.tools.I18n;
+import org.openstreetmap.josm.tools.ImageProvider;
+import org.openstreetmap.josm.tools.Logging;
+
+public class ImageInfoHelpPopup extends JPopupMenu {
+
+ private static final long serialVersionUID = -1721594904273820586L;
+
+ private final Component invokerComp;
+ private boolean alreadyDisplayed;
+
+ public ImageInfoHelpPopup(Component invoker) {
+ invokerComp = invoker;
+ removeAll();
+ setLayout(new BorderLayout());
+
+ JPanel topBar = new JPanel();
+ topBar.add(new JLabel(ImageProvider.get("streetside-logo-white")));
+ topBar.setBackground(StreetsideColorScheme.TOOLBAR_DARK_GREY);
+ add(topBar, BorderLayout.NORTH);
+
+ JTextPane mainText = new JTextPane();
+ mainText.setContentType("text/html");
+ mainText.setFont(SelectableLabel.DEFAULT_FONT);
+ // TODO: tr( RRH
+ mainText.setText(
+ "true if the popup is displayed
+ */
+ public boolean showPopup() {
+ if (!alreadyDisplayed && invokerComp.isShowing()) {
+ try {
+ show(invokerComp, invokerComp.getWidth(), 0);
+ alreadyDisplayed = true;
+ return true;
+ } catch (IllegalComponentStateException e) {
+ Logging.log(Logging.LEVEL_WARN, "Could not show ImageInfoHelpPopup, because probably the invoker component has disappeared from screen.", e);
+ }
+ }
+ return false;
+ }
+}
Index: applications/editors/josm/plugins/MicrosoftStreetside/src/org/openstreetmap/josm/plugins/streetside/gui/imageinfo/ImageInfoPanel.java
===================================================================
--- applications/editors/josm/plugins/MicrosoftStreetside/src/org/openstreetmap/josm/plugins/streetside/gui/imageinfo/ImageInfoPanel.java (revision 34317)
+++ applications/editors/josm/plugins/MicrosoftStreetside/src/org/openstreetmap/josm/plugins/streetside/gui/imageinfo/ImageInfoPanel.java (revision 34317)
@@ -0,0 +1,238 @@
+// License: GPL. For details, see LICENSE file.
+package org.openstreetmap.josm.plugins.streetside.gui.imageinfo;
+
+import java.awt.Font;
+import java.awt.GridBagConstraints;
+import java.awt.GridBagLayout;
+import java.awt.Image;
+import java.awt.Insets;
+import java.awt.datatransfer.StringSelection;
+import java.awt.image.BufferedImage;
+import java.util.Collection;
+
+import javax.swing.ImageIcon;
+import javax.swing.JLabel;
+import javax.swing.JPanel;
+import javax.swing.JTextPane;
+
+import org.apache.commons.logging.Log;
+import org.apache.commons.logging.LogFactory;
+import org.openstreetmap.josm.data.SelectionChangedListener;
+import org.openstreetmap.josm.data.osm.DataSet;
+import org.openstreetmap.josm.data.osm.OsmPrimitive;
+import org.openstreetmap.josm.data.osm.Tag;
+import org.openstreetmap.josm.data.preferences.AbstractProperty.ValueChangeListener;
+import org.openstreetmap.josm.gui.dialogs.ToggleDialog;
+import org.openstreetmap.josm.plugins.streetside.StreetsideAbstractImage;
+import org.openstreetmap.josm.plugins.streetside.StreetsideDataListener;
+import org.openstreetmap.josm.plugins.streetside.StreetsideImage;
+import org.openstreetmap.josm.plugins.streetside.gui.boilerplate.SelectableLabel;
+import org.openstreetmap.josm.plugins.streetside.gui.boilerplate.StreetsideButton;
+import org.openstreetmap.josm.plugins.streetside.model.UserProfile;
+import org.openstreetmap.josm.plugins.streetside.utils.StreetsideProperties;
+import org.openstreetmap.josm.plugins.streetside.utils.StreetsideURL;
+import org.openstreetmap.josm.tools.I18n;
+
+public final class ImageInfoPanel extends ToggleDialog implements StreetsideDataListener, SelectionChangedListener {
+ private static final long serialVersionUID = 4141847503072417190L;
+ private static final Log L = LogFactory.getLog(ImageInfoPanel.class);
+ private static ImageInfoPanel instance;
+ private static final ImageIcon EMPTY_USER_AVATAR = new ImageIcon(new BufferedImage(32, 32, BufferedImage.TYPE_INT_ARGB));
+
+ //private final JLabel numDetectionsLabel;
+ //private final JCheckBox showDetectionsCheck;
+ private final JLabel usernameLabel;
+ private final JTextPane imgKeyValue;
+ private final WebLinkAction imgLinkAction;
+ private final ClipboardAction copyImgKeyAction;
+ private final AddTagToPrimitiveAction addStreetsideTagAction;
+ private final JTextPane seqKeyValue;
+
+ private ValueChangeListenertrue if the popup is displayed
+*/
+public boolean showPopup() {
+ if (!alreadyDisplayed && invokerComp.isShowing()) {
+ try {
+ show(invokerComp, invokerComp.getWidth(), 0);
+ alreadyDisplayed = true;
+ return true;
+ } catch (IllegalComponentStateException e) {
+ Logging.log(Logging.LEVEL_WARN, "Could not show ImageInfoHelpPopup, because probably the invoker component has disappeared from screen.", e);
+ }
+ }
+ return false;
+}
+}
Index: applications/editors/josm/plugins/MicrosoftStreetside/src/org/openstreetmap/josm/plugins/streetside/gui/imageinfo/StreetsideViewerPanel.java
===================================================================
--- applications/editors/josm/plugins/MicrosoftStreetside/src/org/openstreetmap/josm/plugins/streetside/gui/imageinfo/StreetsideViewerPanel.java (revision 34317)
+++ applications/editors/josm/plugins/MicrosoftStreetside/src/org/openstreetmap/josm/plugins/streetside/gui/imageinfo/StreetsideViewerPanel.java (revision 34317)
@@ -0,0 +1,174 @@
+//License: GPL. For details, see LICENSE file.
+package org.openstreetmap.josm.plugins.streetside.gui.imageinfo;
+
+import java.awt.BorderLayout;
+import java.util.Collection;
+
+import javax.swing.JCheckBox;
+import javax.swing.JPanel;
+import javax.swing.SwingUtilities;
+
+import org.openstreetmap.josm.data.SelectionChangedListener;
+import org.openstreetmap.josm.data.osm.DataSet;
+import org.openstreetmap.josm.data.osm.OsmPrimitive;
+import org.openstreetmap.josm.data.preferences.AbstractProperty.ValueChangeListener;
+import org.openstreetmap.josm.plugins.streetside.StreetsideAbstractImage;
+import org.openstreetmap.josm.plugins.streetside.StreetsideDataListener;
+import org.openstreetmap.josm.plugins.streetside.StreetsideImage;
+import org.openstreetmap.josm.plugins.streetside.actions.ImageReloadAction;
+import org.openstreetmap.josm.plugins.streetside.cubemap.CubemapUtils;
+import org.openstreetmap.josm.plugins.streetside.cubemap.GraphicsUtils;
+import org.openstreetmap.josm.plugins.streetside.gui.boilerplate.StreetsideButton;
+import org.openstreetmap.josm.plugins.streetside.utils.CubemapBox;
+import org.openstreetmap.josm.plugins.streetside.utils.StreetsideProperties;
+import org.openstreetmap.josm.plugins.streetside.utils.StreetsideURL;
+import org.openstreetmap.josm.tools.I18n;
+import org.openstreetmap.josm.tools.Logging;
+
+
+public final class StreetsideViewerPanel extends JPanel
+ implements StreetsideDataListener, SelectionChangedListener {
+
+ private static final long serialVersionUID = 4141847503072417190L;
+
+ private JCheckBox highResImageryCheck;
+ private WebLinkAction imgLinkAction;
+ private ImageReloadAction imgReloadAction;
+ private ValueChangeListenernull if no such URL could be found
+ */
+ public static URL parseNextFromLinkHeaderValue(String value) {
+ if (value != null) {
+ // Iterate over the different entries of the Link header
+ for (final String link : value.split(",", Integer.MAX_VALUE)) {
+ boolean isNext = false;
+ URL url = null;
+ // Iterate over the parts of each entry (typically it's one `rel="‹linkType›"` and one like `null
+ */
+ public static URL browseImage(String id) {
+ if (id == null) {
+ throw new IllegalArgumentException("The image key must not be null!");
+ }
+ return StreetsideURL.string2URL(VirtualEarth.BASE_URL_PREFIX + id + VirtualEarth.BASE_URL_SUFFIX);
+ }
+
+ /**
+ * Gives you the URL for the blur editor of the image with the given key.
+ * @param key the key of the image for which you want to open the blur editor
+ * @return the URL of the blur editor
+ * @throws IllegalArgumentException if the image key is null
+ */
+ public static URL blurEditImage(final String key) {
+ if (key == null) {
+ throw new IllegalArgumentException("The image key must not be null!");
+ }
+ String urlEncodedKey;
+ try {
+ urlEncodedKey = URLEncoder.encode(key, StandardCharsets.UTF_8.name());
+ } catch (final UnsupportedEncodingException e) {
+ Logging.log(Logging.LEVEL_ERROR, "Unsupported encoding when URL encoding", e);
+ urlEncodedKey = key;
+ }
+ return StreetsideURL.string2URL(MainWebsite.BASE_URL, "app/blur?focus=photo&pKey=", urlEncodedKey);
+ }
+
+ /**
+ * Gives you the URL for the blur editor of the image with the given key.
+ * @param key the key of the image for which you want to open the blur editor
+ * @return the URL of the blur editor
+ * @throws IllegalArgumentException if the image key is null
+ */
+ public static URL streetsidePrivacyLink(final String id) {
+ if (id == null) {
+ throw new IllegalArgumentException("The image id must not be null!");
+ }
+ String urlEncodedId;
+ try {
+ urlEncodedId = URLEncoder.encode(id, StandardCharsets.UTF_8.name());
+ } catch (final UnsupportedEncodingException e) {
+ Logging.log(Logging.LEVEL_ERROR, "Unsupported encoding when URL encoding", e);
+ urlEncodedId = id;
+ }
+ return StreetsideURL.string2URL(StreetsideURL.STREETSIDE_PRIVACY_URL, urlEncodedId);
+ }
+
+ /**
+ * Gives you the URL which the user should visit to initiate the OAuth authentication process
+ * @param redirectURI the URI to which the user will be redirected when the authentication is finished.
+ * When this is null, it's omitted from the query string.
+ * @return the URL that the user should visit to start the OAuth authentication
+ */
+ public static URL connect(String redirectURI) {
+ final HashMapnull.
+ */
+ public static null if the parameter is
+ * not a {@link JsonArray} of exactly size 2 containing two {@link JsonNumber}s.
+ */
+ static LatLon decodeLatLon(final JsonArray json) {
+ final double[] result = decodeDoublePair(json);
+ if (result != null) {
+ return new LatLon(result[1], result[0]);
+ }
+ return null;
+ }
+
+ /**
+ * Decodes a pair of double values, which are stored in a {@link JsonArray} of exactly size 2.
+ * @param json the {@link JsonArray} containing the two values
+ * @return a double array which contains the two values in the same order, or null
+ * if the parameter was not a {@link JsonArray} of exactly size 2 containing two {@link JsonNumber}s
+ */
+ @SuppressWarnings("PMD.ReturnEmptyArrayRatherThanNull")
+ static double[] decodeDoublePair(final JsonArray json) {
+ if (
+ json != null &&
+ json.size() == 2 &&
+ json.get(0) instanceof JsonNumber &&
+ json.get(1) instanceof JsonNumber
+ ) {
+ return new double[]{json.getJsonNumber(0).doubleValue(), json.getJsonNumber(1).doubleValue()};
+ }
+ return null;
+ }
+
+ /**
+ * Decodes a timestamp formatted as a {@link String} to the equivalent UNIX epoch timestamp
+ * (number of milliseconds since 1970-01-01T00:00:00.000+0000).
+ * @param timestamp the timestamp formatted according to the format yyyy-MM-dd'T'HH:mm:ss.SSSX
+ * @return the point in time as a {@link Long} value representing the UNIX epoch time, or null if the
+ * parameter does not match the required format (this also triggers a warning via
+ * {@link Logging#warn(Throwable)}), or the parameter is null.
+ */
+ static Long decodeTimestamp(final String timestamp) {
+ if (timestamp != null) {
+ try {
+ return new SimpleDateFormat("yyyy-MM-dd'T'HH:mm:ss.SSSX", Locale.UK).parse(timestamp).getTime();
+ } catch (ParseException e) {
+ StackTraceElement calledBy = e.getStackTrace()[Math.min(e.getStackTrace().length - 1, 2)];
+ Logging.log(Logging.LEVEL_WARN,String.format(
+ "Could not decode time from the timestamp `%s` (called by %s.%s:%d)",
+ timestamp, calledBy.getClassName(), calledBy.getMethodName(), calledBy.getLineNumber()
+ ), e);
+ }
+ }
+ return null;
+ }
+}
Index: applications/editors/josm/plugins/MicrosoftStreetside/src/org/openstreetmap/josm/plugins/streetside/utils/api/JsonImageDetailsDecoder.java
===================================================================
--- applications/editors/josm/plugins/MicrosoftStreetside/src/org/openstreetmap/josm/plugins/streetside/utils/api/JsonImageDetailsDecoder.java (revision 34317)
+++ applications/editors/josm/plugins/MicrosoftStreetside/src/org/openstreetmap/josm/plugins/streetside/utils/api/JsonImageDetailsDecoder.java (revision 34317)
@@ -0,0 +1,45 @@
+// License: GPL. For details, see LICENSE file.
+package org.openstreetmap.josm.plugins.streetside.utils.api;
+
+
+import javax.json.JsonObject;
+import javax.json.JsonValue;
+
+import org.openstreetmap.josm.plugins.streetside.StreetsideData;
+import org.openstreetmap.josm.plugins.streetside.StreetsideImage;
+import org.openstreetmap.josm.plugins.streetside.utils.StreetsideURL.APIv3;
+
+
+/**
+ * Decodes the JSON returned by {@link APIv3} into Java objects.
+ * Takes a {@link JsonObject} and {@link #decodeImageInfos(JsonObject, StreetsideData)} tries to add the timestamps.
+ */
+public final class JsonImageDetailsDecoder {
+ private JsonImageDetailsDecoder() {
+ // Private constructor to avoid instantiation
+ }
+
+ public static void decodeImageInfos(final JsonObject json, final StreetsideData data) {
+ if (data != null) {
+ JsonDecoder.decodeFeatureCollection(json, j -> {
+ decodeImageInfo(j, data);
+ return null;
+ });
+ }
+ }
+
+ private static void decodeImageInfo(final JsonObject json, final StreetsideData data) {
+ if (json != null && data != null) {
+ JsonValue properties = json.get("properties");
+ if (properties instanceof JsonObject) {
+ String id = ((JsonObject) properties).getString("id", null);
+ Long he = JsonDecoder.decodeTimestamp(((JsonObject)properties).getString("he", null));
+ if (id != null && he != null) {
+ data.getImages().stream().filter(
+ img -> img instanceof StreetsideImage && id.equals(((StreetsideImage) img).getId())
+ ).forEach(img -> img.setHe(he));
+ }
+ }
+ }
+ }
+}
Index: applications/editors/josm/plugins/MicrosoftStreetside/src/org/openstreetmap/josm/plugins/streetside/utils/api/JsonImageDetectionDecoder.java
===================================================================
--- applications/editors/josm/plugins/MicrosoftStreetside/src/org/openstreetmap/josm/plugins/streetside/utils/api/JsonImageDetectionDecoder.java (revision 34317)
+++ applications/editors/josm/plugins/MicrosoftStreetside/src/org/openstreetmap/josm/plugins/streetside/utils/api/JsonImageDetectionDecoder.java (revision 34317)
@@ -0,0 +1,106 @@
+// License: GPL. For details, see LICENSE file.
+package org.openstreetmap.josm.plugins.streetside.utils.api;
+
+import java.awt.Shape;
+import java.awt.geom.Path2D;
+
+import javax.json.JsonArray;
+import javax.json.JsonNumber;
+import javax.json.JsonObject;
+import javax.json.JsonValue;
+
+import org.openstreetmap.josm.plugins.streetside.model.ImageDetection;
+import org.openstreetmap.josm.plugins.streetside.utils.StreetsideURL.APIv3;
+import org.openstreetmap.josm.tools.Logging;
+
+
+/**
+ * Decodes the JSON returned by {@link APIv3} into Java objects.
+ * Takes a {@link JsonObject} and {@link #decodeImageDetection(JsonObject)} tries to convert it to a {@link ImageDetection}.
+ */
+public final class JsonImageDetectionDecoder {
+ private JsonImageDetectionDecoder() {
+ // Private constructor to avoid instantiation
+ }
+
+ // TODO: Image detections? Keep? @rrh
+ public static ImageDetection decodeImageDetection(final JsonObject json) {
+ if (json == null || !"Feature".equals(json.getString("type", null))) {
+ return null;
+ }
+
+ final JsonValue properties = json.get("properties");
+ if (properties instanceof JsonObject) {
+ final String key = ((JsonObject) properties).getString("key", null);
+ final String packag = ((JsonObject) properties).getString("package", null);
+ final String imageKey = ((JsonObject) properties).getString("image_key", null);
+ final String value = ((JsonObject) properties).getString("value", null);
+ final JsonValue scoreVal = ((JsonObject) properties).get("score");
+ final Double score = scoreVal instanceof JsonNumber ? ((JsonNumber) scoreVal).doubleValue() : null;
+ final Shape shape = decodeShape(((JsonObject) properties).get("shape"));
+ if (shape instanceof Path2D && imageKey != null && key != null && score != null && packag != null && value != null) {
+ return new ImageDetection((Path2D) shape, imageKey, key, score, packag, value);
+ }
+ }
+ return null;
+ }
+
+ private static Shape decodeShape(JsonValue json) {
+ if (json instanceof JsonObject) {
+ if (!"Polygon".equals(((JsonObject) json).getString("type", null))) {
+ Logging.warn(
+ String.format("Image detections using shapes with type=%s are currently not supported!",
+ ((JsonObject) json).getString("type", "‹no type set›"))
+ );
+ } else {
+ final JsonValue coordinates = ((JsonObject) json).get("coordinates");
+ if (coordinates instanceof JsonArray && !((JsonArray) coordinates).isEmpty()) {
+ return decodePolygon((JsonArray) coordinates);
+ }
+ }
+ }
+ return null;
+ }
+
+ /**
+ * Decodes a polygon (may be a multipolygon) from JSON
+ * @param json the json array to decode, must not be null
+ * @return the decoded polygon as {@link Path2D.Double}
+ */
+ private static Path2D decodePolygon(final JsonArray json) {
+ final Path2D shape = new Path2D.Double();
+ json.forEach(val -> {
+ final Shape part = val instanceof JsonArray ? decodeSimplePolygon((JsonArray) val) : null;
+ if (part != null) {
+ shape.append(part, false);
+ }
+ });
+ if (shape.getCurrentPoint() != null) {
+ return shape;
+ }
+ return null;
+ }
+
+ /**
+ * Decodes a simple polygon (consisting of only one continuous path) from JSON
+ * @param json the json array to decode, must not be null
+ * @return the decoded polygon as {@link Path2D.Double}
+ * @throws NullPointerException if parameter is null
+ */
+ private static Path2D decodeSimplePolygon(final JsonArray json) {
+ final Path2D shape = new Path2D.Double();
+ json.forEach(val -> {
+ double[] coord = JsonDecoder.decodeDoublePair(val instanceof JsonArray ? (JsonArray) val : null);
+ if (shape.getCurrentPoint() == null && coord != null) {
+ shape.moveTo(coord[0], coord[1]);
+ } else if (coord != null) {
+ shape.lineTo(coord[0], coord[1]);
+ }
+ });
+ if (shape.getCurrentPoint() != null) {
+ shape.closePath();
+ return shape;
+ }
+ return null;
+ }
+}
Index: applications/editors/josm/plugins/MicrosoftStreetside/src/org/openstreetmap/josm/plugins/streetside/utils/api/JsonLocationChangesetEncoder.java
===================================================================
--- applications/editors/josm/plugins/MicrosoftStreetside/src/org/openstreetmap/josm/plugins/streetside/utils/api/JsonLocationChangesetEncoder.java (revision 34317)
+++ applications/editors/josm/plugins/MicrosoftStreetside/src/org/openstreetmap/josm/plugins/streetside/utils/api/JsonLocationChangesetEncoder.java (revision 34317)
@@ -0,0 +1,57 @@
+// License: GPL. For details, see LICENSE file.
+package org.openstreetmap.josm.plugins.streetside.utils.api;
+
+import java.util.Objects;
+
+import javax.json.Json;
+import javax.json.JsonArrayBuilder;
+import javax.json.JsonObjectBuilder;
+
+import org.openstreetmap.josm.plugins.streetside.StreetsideImage;
+
+import org.openstreetmap.josm.plugins.streetside.StreetsideLocationChangeset;
+
+
+public final class JsonLocationChangesetEncoder {
+ private JsonLocationChangesetEncoder() {
+ // Private constructor to avoid instantiation
+ }
+
+ public static JsonObjectBuilder encodeLocationChangeset(StreetsideLocationChangeset changeset) {
+ Objects.requireNonNull(changeset);
+ final JsonArrayBuilder imgChanges = Json.createArrayBuilder();
+ for (StreetsideImage img : changeset) {
+ imgChanges.add(encodeImageChanges(img));
+ }
+ return Json.createObjectBuilder()
+ .add("type", "location")
+ .add("changes", imgChanges)
+ .add("request_comment", "JOSM-created");
+ }
+
+ private static JsonObjectBuilder encodeImageChanges(StreetsideImage img) {
+ Objects.requireNonNull(img);
+
+ final JsonObjectBuilder to = Json.createObjectBuilder();
+ if (!img.getTempLatLon().equalsEpsilon(img.getLatLon())) {
+ to.add("geometry", Json.createObjectBuilder()
+ .add("coordinates", Json.createArrayBuilder()
+ .add(img.getTempLatLon().getX())
+ .add(img.getTempLatLon().getY())
+ ).add("type", "Point")
+ );
+ }
+ if (Math.abs(img.getHe() - img.getTempHe()) > 1e-9) {
+ to.add("properties", Json.createObjectBuilder().add("ca", img.getTempHe()));
+ } else {
+ to.add("properties", Json.createObjectBuilder());
+ }
+ if (!img.getTempLatLon().equalsEpsilon(img.getLatLon())) {
+ to.add("type", "Feature");
+ }
+
+ return Json.createObjectBuilder()
+ .add("image_key", img.getId())
+ .add("to", to);
+ }
+}
Index: applications/editors/josm/plugins/MicrosoftStreetside/src/org/openstreetmap/josm/plugins/streetside/utils/api/JsonMapObjectDecoder.java
===================================================================
--- applications/editors/josm/plugins/MicrosoftStreetside/src/org/openstreetmap/josm/plugins/streetside/utils/api/JsonMapObjectDecoder.java (revision 34317)
+++ applications/editors/josm/plugins/MicrosoftStreetside/src/org/openstreetmap/josm/plugins/streetside/utils/api/JsonMapObjectDecoder.java (revision 34317)
@@ -0,0 +1,61 @@
+// License: GPL. For details, see LICENSE file.
+package org.openstreetmap.josm.plugins.streetside.utils.api;
+
+import javax.json.JsonArray;
+import javax.json.JsonObject;
+import javax.json.JsonValue;
+
+import org.openstreetmap.josm.data.coor.LatLon;
+import org.openstreetmap.josm.plugins.streetside.model.MapObject;
+import org.openstreetmap.josm.plugins.streetside.utils.StreetsideURL.APIv3;
+
+/**
+ * Decodes the JSON returned by {@link APIv3} into Java objects.
+ * Takes a {@link JsonObject} and {@link #decodeMapObject(JsonObject)} tries to convert it to a {@link MapObject}.
+ */
+public final class JsonMapObjectDecoder {
+ private JsonMapObjectDecoder() {
+ // Private constructor to avoid instantiation
+ }
+
+ public static MapObject decodeMapObject(final JsonObject json) {
+ if (json == null || !"Feature".equals(json.getString("type", null))) {
+ return null;
+ }
+
+ final JsonValue properties = json.get("properties");
+ final JsonValue geometry = json.get("geometry");
+ if (properties instanceof JsonObject && geometry instanceof JsonObject) {
+ final String key = ((JsonObject) properties).getString("key", null);
+ final String packg = ((JsonObject) properties).getString("package", null);
+ final String value = ((JsonObject) properties).getString("value", null);
+ final Long firstSeenTime = JsonDecoder.decodeTimestamp(((JsonObject) properties).getString("first_seen_at", null));
+ final Long lastSeenTime = JsonDecoder.decodeTimestamp(((JsonObject) properties).getString("last_seen_at", null));
+ final Long updatedTime = JsonDecoder.decodeTimestamp(((JsonObject) properties).getString("updated_at", null));
+
+ final JsonValue coordVal = "Point".equals(((JsonObject) geometry).getString("type", null))
+ ? ((JsonObject) geometry).get("coordinates")
+ : null;
+ final LatLon coordinate = coordVal instanceof JsonArray ? JsonDecoder.decodeLatLon((JsonArray) coordVal) : null;
+
+ if (
+ key != null &&
+ packg != null &&
+ value != null &&
+ firstSeenTime != null &&
+ lastSeenTime != null &&
+ updatedTime != null &&
+ coordinate != null
+ ) {
+ return new MapObject(
+ coordinate,
+ key,
+ packg,
+ value,
+ firstSeenTime, lastSeenTime, updatedTime
+ );
+ }
+ }
+ return null;
+ }
+}
Index: applications/editors/josm/plugins/MicrosoftStreetside/src/org/openstreetmap/josm/plugins/streetside/utils/api/JsonSequencesDecoder.java
===================================================================
--- applications/editors/josm/plugins/MicrosoftStreetside/src/org/openstreetmap/josm/plugins/streetside/utils/api/JsonSequencesDecoder.java (revision 34317)
+++ applications/editors/josm/plugins/MicrosoftStreetside/src/org/openstreetmap/josm/plugins/streetside/utils/api/JsonSequencesDecoder.java (revision 34317)
@@ -0,0 +1,137 @@
+// License: GPL. For details, see LICENSE file.
+package org.openstreetmap.josm.plugins.streetside.utils.api;
+
+import java.lang.reflect.Array;
+import java.util.function.Function;
+
+import javax.json.JsonArray;
+import javax.json.JsonNumber;
+import javax.json.JsonObject;
+import javax.json.JsonString;
+import javax.json.JsonValue;
+
+import org.openstreetmap.josm.data.coor.LatLon;
+import org.openstreetmap.josm.plugins.streetside.StreetsideImage;
+import org.openstreetmap.josm.plugins.streetside.StreetsideSequence;
+import org.openstreetmap.josm.plugins.streetside.utils.StreetsideURL.APIv3;
+
+/**
+ * Decodes the JSON returned by {@link APIv3} into Java objects.
+ * Takes a {@link JsonObject} and {@link #decodeSequence(JsonObject)} tries to convert it to a {@link StreetsideSequence}.
+ */
+public final class JsonSequencesDecoder {
+ private JsonSequencesDecoder() {
+ // Private constructor to avoid instantiation
+ }
+
+ /**
+ * Parses a given {@link JsonObject} as a GeoJSON Feature into a {@link StreetsideSequence}.
+ * @param json the {@link JsonObject} to be parsed
+ * @return a {@link Streetsideequence} that is parsed from the given {@link JsonObject}. If mandatory information is
+ * missing from the JSON or it's not meeting the expecting format in another way, null will be
+ * returned.
+ */
+ public static StreetsideSequence decodeSequence(final JsonObject json) {
+ if (json == null || !"Feature".equals(json.getString("type", null))) {
+ return null;
+ }
+ StreetsideSequence result = null;
+ final JsonObject properties = json.getJsonObject("properties");
+ final Long ca = properties == null ? null : JsonDecoder.decodeTimestamp(properties.getString("cd", null));
+ if (properties != null && properties.getString("id", null) != null && properties.getString("user_key", null) != null && ca != null) {
+ result = new StreetsideSequence(properties.getString("id", null), ca);
+
+ final Double[] hes = decodeCoordinateProperty(
+ properties,
+ "hes",
+ val -> val instanceof JsonNumber ? ((JsonNumber) val).doubleValue() : null,
+ Double.class
+ );
+ final String[] imageIds = decodeCoordinateProperty(
+ properties,
+ "image_ids",
+ val -> val instanceof JsonString ? ((JsonString) val).getString() : null,
+ String.class
+ );
+ final LatLon[] geometry = decodeLatLons(json.getJsonObject("geometry"));
+ final int sequenceLength = Math.min(Math.min(hes.length, imageIds.length), geometry.length);
+ for (int i = 0; i < sequenceLength; i++) {
+ if (hes[i] != null && imageIds[i] != null && geometry[i] != null) {
+ final StreetsideImage img = new StreetsideImage(imageIds[i], geometry[i], hes[i]);
+ result.add(img);
+ }
+ }
+ if (result.getImages().isEmpty()) {
+ result = null;
+ }
+ }
+ return result;
+ }
+
+ /**
+ * Converts a {@link JsonArray} to a java array.
+ * The conversion from {@link JsonValue} to a java type is done by the supplied function.
+ * @param array the array to be converted
+ * @param decodeValueFunction the function used for conversion from {@link JsonValue} to the desired type.
+ * @param clazz the desired type that the elements of the resulting array should have
+ * @return the supplied array converted from {@link JsonArray} to a java array of the supplied type, converted using
+ * the supplied function. Never null, in case of array==null, an array of length 0 is returned.
+ */
+ @SuppressWarnings("unchecked")
+ private static null. If no `coordinateProperties` are set, or if the desired key is not set or is not
+ * an array, then an empty array of the desired type is returned.
+ */
+ @SuppressWarnings("unchecked")
+ private static null.
+ */
+ public static null if the parameter is
+ * not a {@link JsonArray} of exactly size 2 containing two {@link JsonNumber}s.
+ */
+ static LatLon decodeLatLon(final JsonArray json) {
+ final double[] result = decodeDoublePair(json);
+ if (result != null) {
+ return new LatLon(result[1], result[0]);
+ }
+ return null;
+ }
+
+ /**
+ * Decodes a pair of double values, which are stored in a {@link JsonArray} of exactly size 2.
+ * @param json the {@link JsonArray} containing the two values
+ * @return a double array which contains the two values in the same order, or null
+ * if the parameter was not a {@link JsonArray} of exactly size 2 containing two {@link JsonNumber}s
+ */
+ @SuppressWarnings("PMD.ReturnEmptyArrayRatherThanNull")
+ static double[] decodeDoublePair(final JsonArray json) {
+ if (
+ json != null &&
+ json.size() == 2 &&
+ json.get(0) instanceof JsonNumber &&
+ json.get(1) instanceof JsonNumber
+ ) {
+ return new double[]{json.getJsonNumber(0).doubleValue(), json.getJsonNumber(1).doubleValue()};
+ }
+ return null;
+ }
+
+ /**
+ * Decodes a timestamp formatted as a {@link String} to the equivalent UNIX epoch timestamp
+ * (number of milliseconds since 1970-01-01T00:00:00.000+0000).
+ * @param timestamp the timestamp formatted according to the format yyyy-MM-dd'T'HH:mm:ss.SSSX
+ * @return the point in time as a {@link Long} value representing the UNIX epoch time, or null if the
+ * parameter does not match the required format (this also triggers a warning via
+ * {@link Logging#warn(Throwable)}), or the parameter is null.
+ */
+ static Long decodeTimestamp(final String timestamp) {
+ if (timestamp != null) {
+ try {
+ return new SimpleDateFormat("yyyy-MM-dd'T'HH:mm:ss.SSSX", Locale.UK).parse(timestamp).getTime();
+ } catch (ParseException e) {
+ StackTraceElement calledBy = e.getStackTrace()[Math.min(e.getStackTrace().length - 1, 2)];
+ Logging.log(Logging.LEVEL_WARN,String.format(
+ "Could not decode time from the timestamp `%s` (called by %s.%s:%d)",
+ timestamp, calledBy.getClassName(), calledBy.getMethodName(), calledBy.getLineNumber()
+ ), e);
+ }
+ }
+ return null;
+ }
+}
Index: applications/editors/josm/plugins/MicrosoftStreetside/src/org/openstreetmap/josm/plugins/streetside/utils/api/JsonStreetsideSequencesDecoder.java
===================================================================
--- applications/editors/josm/plugins/MicrosoftStreetside/src/org/openstreetmap/josm/plugins/streetside/utils/api/JsonStreetsideSequencesDecoder.java (revision 34317)
+++ applications/editors/josm/plugins/MicrosoftStreetside/src/org/openstreetmap/josm/plugins/streetside/utils/api/JsonStreetsideSequencesDecoder.java (revision 34317)
@@ -0,0 +1,188 @@
+// License: GPL. For details, see LICENSE file.
+package org.openstreetmap.josm.plugins.streetside.utils.api;
+
+import java.lang.reflect.Array;
+import java.util.function.Function;
+
+import javax.json.JsonArray;
+import javax.json.JsonNumber;
+import javax.json.JsonObject;
+import javax.json.JsonString;
+import javax.json.JsonValue;
+
+import org.openstreetmap.josm.data.coor.LatLon;
+import org.openstreetmap.josm.plugins.streetside.StreetsideImage;
+import org.openstreetmap.josm.plugins.streetside.StreetsideSequence;
+import org.openstreetmap.josm.plugins.streetside.utils.StreetsideURL.APIv3;
+
+/**
+ * Decodes the JSON returned by {@link APIv3} into Java objects.
+ * Takes a {@link JsonObject} and {@link #decodeSequence(JsonObject)} tries to convert it to a {@link StreetsideSequence}.
+ */
+public final class JsonStreetsideSequencesDecoder {
+ private JsonStreetsideSequencesDecoder() {
+ // Private constructor to avoid instantiation
+ }
+
+ /**
+ * Parses a given {@link JsonObject} as a GeoJSON Feature into a {@link StreetsideSequence}.
+ * @param json the {@link JsonObject} to be parsed
+ * @return a {@link StreetsideSequence} that is parsed from the given {@link JsonObject}. If mandatory information is
+ * missing from the JSON or it's not meeting the expecting format in another way, null will be
+ * returned.
+ */
+ public static StreetsideSequence decodeSequence(final JsonObject json) {
+ if (json == null || !"Feature".equals(json.getString("type", null))) {
+ return null;
+ }
+ StreetsideSequence result = null;
+ final JsonObject properties = json.getJsonObject("properties");
+ final Long ca = properties == null ? null : JsonDecoder.decodeTimestamp(properties.getString("cd", null));
+ if (properties != null && properties.getString("id", null) != null && ca != null) {
+ result = new StreetsideSequence(properties.getString("id", null), ca);
+
+ final Double[] cas = decodeCoordinateProperty(
+ properties,
+ "hes",
+ val -> val instanceof JsonNumber ? ((JsonNumber) val).doubleValue() : null,
+ Double.class
+ );
+ final String[] imageIds = decodeCoordinateProperty(
+ properties,
+ "image_ids",
+ val -> val instanceof JsonString ? ((JsonString) val).getString() : null,
+ String.class
+ );
+ final LatLon[] geometry = decodeLatLons(json.getJsonObject("geometry"));
+ final int sequenceLength = Math.min(Math.min(cas.length, imageIds.length), geometry.length);
+ for (int i = 0; i < sequenceLength; i++) {
+ if (cas[i] != null && imageIds[i] != null && geometry[i] != null) {
+ final StreetsideImage img = new StreetsideImage(imageIds[i], geometry[i], cas[i]);
+ result.add(img);
+ }
+ }
+ if (result.getImages().isEmpty()) {
+ result = null;
+ }
+ }
+ return result;
+ }
+
+ /**
+ * Parses a given {@link JsonObject} as a GeoJSON Feature into a {@link StreetsideSequence}.
+ * @param json the {@link JsonObject} to be parsed
+ * @return a {@link StreetsideSequence} that is parsed from the given {@link JsonObject}. If mandatory information is
+ * missing from the JSON or it's not meeting the expecting format in another way, null will be
+ * returned.
+ */
+ public static StreetsideImage decodeBubbleData(final StreetsideImage image) {
+ if (image == null) {
+ return null;
+ }
+ // Declare and instantiate new Streetside object to ensure proper setting of superclass attributes
+ StreetsideImage result = null;
+ if(image.getId() != null ) {
+ result = new StreetsideImage(image.getId(), new LatLon(image.getLa(), image.getLo()), 0.0);
+ result.setAl(image.getAl());
+ result.setRo(image.getRo());
+ result.setPi(image.getPi());
+ result.setHe(image.getHe());
+ result.setBl(image.getBl());
+ result.setMl(image.getMl());
+ result.setNe(image.getNe());
+ result.setPr(image.getPr());
+ result.setNbn(image.getNbn());
+ result.setPbn(image.getPbn());
+ result.setRn(image.getRn());
+ result.setCd(image.getCd());
+ }
+ return result;
+ }
+
+ /**
+ * Parses a given {@link JsonObject} as a GeoJSON Feature into a {@link StreetsideSequence}.
+ * @param json the {@link JsonObject} to be parsed
+ * @return a {@link StreetsideSequence} that is parsed from the given {@link JsonObject}. If mandatory information is
+ * missing from the JSON or it's not meeting the expecting format in another way, null will be
+ * returned.
+ */
+ public static StreetsideSequence decodeStreetsideSequence(final JsonObject json) {
+ if (json == null) {
+ return null;
+ }
+ StreetsideSequence result = null;
+
+ if (json.getString("id", null) != null && json.getString("la", null) != null && json.getString("lo", null) != null) {
+ result = new StreetsideSequence(json.getString("id", null), json.getJsonNumber("la").doubleValue(), json.getJsonNumber("lo").doubleValue(), json.getJsonNumber("cd").longValue());
+ }
+
+ return result;
+ }
+
+ /**
+ * Converts a {@link JsonArray} to a java array.
+ * The conversion from {@link JsonValue} to a java type is done by the supplied function.
+ * @param array the array to be converted
+ * @param decodeValueFunction the function used for conversion from {@link JsonValue} to the desired type.
+ * @param clazz the desired type that the elements of the resulting array should have
+ * @return the supplied array converted from {@link JsonArray} to a java array of the supplied type, converted using
+ * the supplied function. Never null, in case of array==null, an array of length 0 is returned.
+ */
+ @SuppressWarnings("unchecked")
+ private static null. If no `coordinateProperties` are set, or if the desired key is not set or is not
+ * an array, then an empty array of the desired type is returned.
+ */
+ @SuppressWarnings("unchecked")
+ private static null is supplied to the method as the array.
+ */
+ @Test
+ public void testDecodeJsonArray()
+ throws NoSuchMethodException, SecurityException, IllegalAccessException,
+ IllegalArgumentException, InvocationTargetException {
+ Method method = JsonSequencesDecoder.class.getDeclaredMethod("decodeJsonArray", JsonArray.class, Function.class, Class.class);
+ method.setAccessible(true);
+ assertEquals(
+ 0,
+ ((String[]) method.invoke(null, null, (Function