1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
|
package cgeo.geocaching.apps.cache.navi;
import cgeo.geocaching.R;
import cgeo.geocaching.SearchResult;
import cgeo.geocaching.Settings;
import cgeo.geocaching.StaticMapsProvider;
import cgeo.geocaching.cgCache;
import cgeo.geocaching.cgGeo;
import cgeo.geocaching.cgWaypoint;
import cgeo.geocaching.cgeoapplication;
import cgeo.geocaching.apps.AbstractAppFactory;
import cgeo.geocaching.geopoint.Geopoint;
import cgeo.geocaching.utils.Log;
import org.apache.commons.lang3.StringUtils;
import android.app.Activity;
import android.app.AlertDialog;
import android.content.DialogInterface;
import android.view.Menu;
import android.view.MenuItem;
import android.view.View;
import android.view.ViewGroup;
import android.widget.ArrayAdapter;
import android.widget.TextView;
import java.util.ArrayList;
import java.util.List;
public final class NavigationAppFactory extends AbstractAppFactory {
public enum NavigationAppsEnum {
/** The internal compass activity */
COMPASS(new CompassApp(), 0),
/** The external radar app */
RADAR(new RadarApp(), 1),
/** The selected map */
INTERNAL_MAP(new InternalMap(), 2),
/** The internal static map activity */
STATIC_MAP(new StaticMapApp(), 3),
/** The external Locus app */
LOCUS(new LocusApp(), 4),
/** The external RMaps app */
RMAPS(new RMapsApp(), 5),
/** Google Maps */
GOOGLE_MAPS(new GoogleMapsApp(), 6),
/** Google Navigation */
GOOGLE_NAVIGATION(new GoogleNavigationApp(), 7),
/** Google Streetview */
GOOGLE_STREETVIEW(new StreetviewApp(), 8),
/** The external OruxMaps app */
ORUX_MAPS(new OruxMapsApp(), 9),
/** The external navigon app */
NAVIGON(new NavigonApp(), 10);
NavigationAppsEnum(NavigationApp app, int id) {
this.app = app;
this.id = id;
}
/**
* The app instance to use
*/
public final NavigationApp app;
/**
* The id - used in c:geo settings
*/
public final int id;
}
/**
* Default way to handle selection of navigation tool.<br />
* A dialog is created for tool selection and the selected tool is started afterwards.
* <p />
* Delegates to
* {@link #showNavigationMenu(cgGeo, Activity, cgCache, SearchResult, cgWaypoint, Geopoint, boolean, boolean)} with
* <code>showInternalMap = true</code> and <code>showDefaultNavigation = false</code>
*
* @param geo
* @param activity
* @param cache
* @param waypoint
* @param destination
*/
public static void showNavigationMenu(final cgGeo geo, final Activity activity,
final cgCache cache, final cgWaypoint waypoint, final Geopoint destination) {
showNavigationMenu(geo, activity, cache, waypoint, destination, true, false);
}
/**
* Specialized way to handle selection of navigation tool.<br />
* A dialog is created for tool selection and the selected tool is started afterwards.
*
* @param geo
* @param activity
* @param cache
* may be <code>null</code>
* @param waypoint
* may be <code>null</code>
* @param destination
* may be <code>null</code>
* @param showInternalMap
* should be <code>false</code> only when called from within the internal map
* @param showDefaultNavigation
* should be <code>false</code> by default
*
* @see #showNavigationMenu(cgGeo, Activity, cgCache, cgWaypoint, Geopoint)
*/
public static void showNavigationMenu(final cgGeo geo, final Activity activity,
final cgCache cache, final cgWaypoint waypoint, final Geopoint destination,
final boolean showInternalMap, final boolean showDefaultNavigation) {
final AlertDialog.Builder builder = new AlertDialog.Builder(activity);
builder.setTitle(R.string.cache_menu_navigate);
builder.setIcon(android.R.drawable.ic_menu_mapmode);
final List<NavigationAppsEnum> items = new ArrayList<NavigationAppFactory.NavigationAppsEnum>();
final int defaultNavigationTool = Settings.getDefaultNavigationTool();
final boolean hasStaticMaps = hasStaticMap(cache, waypoint);
for (NavigationAppsEnum navApp : getInstalledNavigationApps(activity)) {
if (NavigationAppsEnum.STATIC_MAP.id == navApp.id) {
if (hasStaticMaps) {
items.add(navApp);
}
} else if ((showInternalMap || !(navApp.app instanceof InternalMap)) &&
(showDefaultNavigation || defaultNavigationTool != navApp.id)) {
items.add(navApp);
}
}
/*
* Using an ArrayAdapter with list of NavigationAppsEnum items avoids
* handling between mapping list positions allows us to do dynamic filtering of the list based on usecase.
*/
final ArrayAdapter<NavigationAppsEnum> adapter = new ArrayAdapter<NavigationAppsEnum>(activity, android.R.layout.select_dialog_item, items) {
@Override
public View getView(int position, View convertView, ViewGroup parent) {
TextView textView = (TextView) super.getView(position, convertView, parent);
textView.setText(getItem(position).app.getName());
return textView;
}
@Override
public View getDropDownView(int position, View convertView, ViewGroup parent) {
TextView textView = (TextView) super.getDropDownView(position, convertView, parent);
textView.setText(getItem(position).app.getName());
return textView;
}
};
adapter.setDropDownViewResource(android.R.layout.select_dialog_item);
builder.setAdapter(adapter, new DialogInterface.OnClickListener() {
public void onClick(DialogInterface dialog, int item) {
NavigationAppsEnum selectedItem = adapter.getItem(item);
selectedItem.app.invoke(geo, activity, cache, waypoint, destination);
}
});
final AlertDialog alert = builder.create();
alert.show();
}
private static boolean hasStaticMap(cgCache cache, cgWaypoint waypoint) {
if (waypoint != null) {
String geocode = waypoint.getGeocode();
int id = waypoint.getId();
if (StringUtils.isNotEmpty(geocode) && cgeoapplication.getInstance().isOffline(geocode, null)) {
return StaticMapsProvider.doesExistStaticMapForWaypoint(geocode, id);
}
}
if (cache != null) {
String geocode = cache.getGeocode();
if (StringUtils.isNotEmpty(geocode) && cgeoapplication.getInstance().isOffline(geocode, null)) {
return StaticMapsProvider.doesExistStaticMapForCache(geocode);
}
}
return false;
}
/**
* Returns all installed navigation apps.
*
* @param activity
* @return
*/
public static List<NavigationAppsEnum> getInstalledNavigationApps(final Activity activity) {
final List<NavigationAppsEnum> installedNavigationApps = new ArrayList<NavigationAppsEnum>();
for (NavigationAppsEnum appEnum : NavigationAppsEnum.values()) {
if (appEnum.app.isInstalled(activity)) {
installedNavigationApps.add(appEnum);
}
}
return installedNavigationApps;
}
/**
* This offset is used to build unique menu ids to avoid collisions of ids in menus
*/
private static final int MENU_ITEM_OFFSET = 12345;
/**
* Adds the installed navigation tools to the given menu.
* Use {@link #onMenuItemSelected(MenuItem, cgGeo, Activity, cgCache, SearchResult, cgWaypoint, Geopoint)} on
* selection event to start the selected navigation tool.
*
* <b>Only use this way if {@link #showNavigationMenu(cgGeo, Activity, cgCache, SearchResult, cgWaypoint, Geopoint)}
* is not suitable for the given usecase.</b>
*
* @param menu
* @param activity
*/
public static void addMenuItems(final Menu menu, final Activity activity) {
addMenuItems(menu, activity, true, false);
}
/**
* Adds the installed navigation tools to the given menu.
* Use {@link #onMenuItemSelected(MenuItem, cgGeo, Activity, cgCache, cgWaypoint, Geopoint)} on
* selection event to start the selected navigation tool.
*
* <b>Only use this way if
* {@link #showNavigationMenu(cgGeo, Activity, cgCache, cgWaypoint, Geopoint, boolean, boolean)} is
* not suitable for the given usecase.</b>
*
* @param menu
* @param activity
* @param showInternalMap
* @param showDefaultNavigation
*/
public static void addMenuItems(final Menu menu, final Activity activity,
final boolean showInternalMap, final boolean showDefaultNavigation) {
final int defaultNavigationTool = Settings.getDefaultNavigationTool();
for (NavigationAppsEnum navApp : getInstalledNavigationApps(activity)) {
if ((showInternalMap || !(navApp.app instanceof InternalMap)) &&
(showDefaultNavigation || defaultNavigationTool != navApp.id)) {
menu.add(0, MENU_ITEM_OFFSET + navApp.id, 0, navApp.app.getName());
}
}
}
/**
* Handles menu selections for menu entries created with {@link #addMenuItems(Menu, Activity)} or
* {@link #addMenuItems(Menu, Activity, boolean, boolean)}.
*
* @param item
* @param geo
* @param activity
* @param cache
* @param waypoint
* @param destination
* @return
*/
public static boolean onMenuItemSelected(final MenuItem item,
final cgGeo geo, Activity activity, cgCache cache, cgWaypoint waypoint, final Geopoint destination) {
if (cache == null && waypoint == null && destination == null) {
return false;
}
final NavigationApp app = getAppFromMenuItem(item);
if (app != null) {
try {
return app.invoke(geo, activity, cache, waypoint, destination);
} catch (Exception e) {
Log.e("NavigationAppFactory.onMenuItemSelected: " + e.toString());
}
}
return false;
}
private static NavigationApp getAppFromMenuItem(MenuItem item) {
final int id = item.getItemId();
for (NavigationAppsEnum navApp : NavigationAppsEnum.values()) {
if (MENU_ITEM_OFFSET + navApp.id == id) {
return navApp.app;
}
}
return null;
}
/**
* Starts the default navigation tool if correctly set and installed or the compass app as default fallback.
*
* @param geo
* @param activity
* @param cache
* @param search
* @param waypoint
* @param destination
*/
public static void startDefaultNavigationApplication(final cgGeo geo, Activity activity, cgCache cache,
cgWaypoint waypoint, final Geopoint destination) {
final NavigationApp app = getDefaultNavigationApplication(activity);
if (app != null) {
try {
app.invoke(geo, activity, cache, waypoint, destination);
} catch (Exception e) {
Log.e("NavigationAppFactory.startDefaultNavigationApplication: " + e.toString());
}
}
}
/**
* Starts the second default navigation tool if correctly set and installed or the compass app as default fallback.
*
* @param geo
* @param activity
* @param cache
* @param search
* @param waypoint
* @param destination
*/
public static void startDefaultNavigationApplication2(final cgGeo geo, Activity activity, cgCache cache,
cgWaypoint waypoint, final Geopoint destination) {
final NavigationApp app = getDefaultNavigationApplication2(activity);
if (app != null) {
try {
app.invoke(geo, activity, cache, waypoint, destination);
} catch (Exception e) {
Log.e("NavigationAppFactory.startDefaultNavigationApplication2: " + e.toString());
}
}
}
/**
* Returns the default navigation tool if correctly set and installed or the compass app as default fallback
*
* @param activity
* @return never <code>null</code>
*/
public static NavigationApp getDefaultNavigationApplication(Activity activity) {
final int defaultNavigationTool = Settings.getDefaultNavigationTool();
final List<NavigationAppsEnum> installedNavigationApps = getInstalledNavigationApps(activity);
for (NavigationAppsEnum navigationApp : installedNavigationApps) {
if (navigationApp.id == defaultNavigationTool) {
return navigationApp.app;
}
}
// default navigation tool wasn't set already or couldn't be found (not installed any more for example)
return NavigationAppsEnum.COMPASS.app;
}
/**
* Returns the second default navigation tool if correctly set and installed or the compass app as default fallback
*
* @param activity
* @return never <code>null</code>
*/
public static NavigationApp getDefaultNavigationApplication2(Activity activity) {
final int defaultNavigationTool = Settings.getDefaultNavigationTool2();
final List<NavigationAppsEnum> installedNavigationApps = getInstalledNavigationApps(activity);
for (NavigationAppsEnum navigationApp : installedNavigationApps) {
if (navigationApp.id == defaultNavigationTool) {
return navigationApp.app;
}
}
// second default navigation tool wasn't set already or couldn't be found (not installed any more for example)
return NavigationAppsEnum.COMPASS.app;
}
}
|