MapFan AR Global External linkage specification

Description of external linkage specification for Map Display and Route Search of iOS application "MapFan AR Global" is below.

This external linkage specification is to display its map and its route booting the application "MapFan AR Global" externally.

Using this external linkage specification makes it display the map at a designated location and search the route to the designated place from external iOS application and website on iPhone.

To interoperate this system, the mechanism “URL scheme” is used. Detailed specification is as follows.

Caution/Request

◆Caution
<About the Terms of Use>
Please read Terms of Use below before using this external linkage specification.
Using this external linkage specification, you agreed to be bound by these terms of use.

<Disclaimer>
This specification may be changed without notice.
And this external linkage specification may be discontinued without notice.

<About the Operation Guarantee>
When "MapFan AR Global" is booting by external linkage specification, which "MapFan AR Global" is running (including in the background), it is not always operated as designated by the status of application display.

◆Request
As a process in the case when "MapFan AR Global" application does not exist in cooperating from the application, please display the following URL.

https://itunes.apple.com/jp/app/mapfan-ar-global/id820093646?mt=8

*It is the web page of "MapFan AR Global" of AppStore.

Functional Specification

◆URL Scheme
[URL Scheme] mapfanarg:

Character encoding: UTF-8
Method of designation of Parameter: Designate the value of parameter URL encode.

◆Parameter list

Parameter Parameter Name Input Condition Description
TYPE Booting Type RS/MV Designated to boot "MapFan AR Global" from the following mode.

RS:Route Search
  Parameter=BG, ED(Required)
MV:Map Display
  Parameter=MP(Required), PP, PN

*Designated pin and route will be deleted before booting.
BG Departure Number of 1 byte character,
Comma,
Period
Designated to the "Coordinate" of "Departure" using for the "Route search".

*In case "Departure" is undesignated, the latest "Current Location" which "MapFan AR Global" have had is set as "Departure".

i.e. BG=35.682085,139.766221
ED Destination Number of 1 byte character,
Comma,
Period
Designated to the "Coordinate" of "Destination" using for the "Route search".

i.e.ED=35.682085,139.766221
MP Central coordinate of the map Number of 1 byte character,
Comma,
Period
Designated to the "Coordinate" of "Central coordinate of the map" using for the "Map Display".

i.e.MP=35.682085,139.766221
PP Pinned coordinate Number of 1 byte character,
Comma,
Period
Designated to the "Coordinate" of "Pinned coordinate" using for the "Map Display".

i.e.PP=35.682085,139.766221
PN Pinned Name Less than 256 characters Designated to the "Pinned Name" using for the "Map Display".

◆LatLong format
LatLong format is defined as below.
-Parameter form: [Latitude],[Longitude]
-Datum: WGS84
-LatLong format: Degree

URL Scheme Boot Sample

◆General Boot

mapfanarg://

◆Route Search (Set only destination)

mapfanarg://?TYPE=RS&ED=35.632546%2C139.881328

◆Route Search (Set both departure and destination)

mapfanarg://?TYPE=RS&BG=35.688742%2C139.691774&ED=35.632546%2C139.881328

◆Map Display (Without Pin)

mapfanarg://?TYPE=MV&MP=35.632546%2C139.881328

◆Map Display (Pinned)

mapfanarg://?TYPE=MV&MP=35.632546%2C139.881328&PP=35.632000%2C139.881000&PN=%e6%9d%b1%e4%ba%ac%e3%83%87%e3%82%a3%e3%82%ba%e3%83%8b%e3%83%bc%e3%83%a9%e3%83%b3%e3%83%89

Change History

[Feb. 26, 2014] New release