Setting the Navigation Destination
The SendLocation RPC gives you the ability to send a GPS location to the active navigation app on the head unit.
When using the SendLocation RPC, you will not have access to any information about how the user interacted with this location, only if the request was successfully sent. The request will be handled by Core from that point on using the active navigation system.
Checking If Your App Has Permission to Use Send Location
The SendLocation RPC is restricted by most vehicle manufacturers. As a result, the head unit you are connecting to will reject the request if you do not have the correct permissions. Please check the Understanding Permissions section for more information on how to check permissions for an RPC.
Checking if Head Unit Supports Send Location
Since there is a possibility that some head units will not support the send location feature, you should check head unit support before attempting to send the request. You should also update your app's UI based on whether or not you can use SendLocation.
If using library v.4.4 and connecting to SDL Core v.4.5 or newer, you can use the SystemCapabilityManager to check the navigation capability returned by Core as shown in the code sample below.
If connecting to older versions of Core (or using older versions of the library), you will have to check the sdlManager.getRegisterAppInterfaceResponse().getHmiCapabilities().isNavigationAvailable(); after the SDL app has started successfully to see if an embedded navigation system is available. If it is, then you can assume that SendLocation will work.
sdlManager.getSystemCapabilityManager().getCapability(SystemCapabilityType.NAVIGATION, new OnSystemCapabilityListener() { @Override public void onCapabilityRetrieved(Object capability) { NavigationCapability navCapability = (NavigationCapability) capability; Boolean isNavigationSupported = navCapability.getSendLocationEnabled(); } @Override public void onError(String info) { HMICapabilities hmiCapabilities = (HMICapabilities) sdlManager.getSystemCapabilityManager().getCapability(SystemCapabilityType.HMI); Boolean isNavigationSupported = hmiCapabilities.isNavigationAvailable(); } });
Using Send Location
To use the SendLocation request, you must at minimum include the longitude and latitude of the location.
SendLocation sendLocation = new SendLocation(); sendLocation.setLatitudeDegrees(42.877737); sendLocation.setLongitudeDegrees(-97.380967); sendLocation.setLocationName("The Center"); sendLocation.setLocationDescription("Center of the United States"); // Create Address OasisAddress address = new OasisAddress(); address.setSubThoroughfare("900"); address.setThoroughfare("Whiting Dr"); address.setLocality("Yankton"); address.setAdministrativeArea("SD"); address.setPostalCode("57078"); address.setCountryCode("US-SD"); address.setCountryName("United States"); sendLocation.setAddress(address); // Monitor response sendLocation.setOnRPCResponseListener(new OnRPCResponseListener() { @Override public void onResponse(int correlationId, RPCResponse response) { Result result = response.getResultCode(); if(result.equals(Result.SUCCESS)){ // SendLocation was successfully sent. }else if(result.equals(Result.INVALID_DATA)){ // The request you sent contains invalid data and was rejected. }else if(result.equals(Result.DISALLOWED)){ // Your app does not have permission to use SendLocation. } } @Override public void onError(int correlationId, Result resultCode, String info){ Log.e(TAG, "onError: "+ resultCode+ " | Info: "+ info ); } }); sdlManager.sendRPC(sendLocation);
Checking the Result of Send Location
The SendLocation response has 3 possible results that you should expect:
SUCCESS- Successfully sent.INVALID_DATA- The request contains invalid data and was rejected.DISALLOWED- Your app does not have permission to useSendLocation.