부산버스앱 URL Scheme 공개

부산버스앱 URL Scheme 연동

 

 

모바일 애플리케이션 및 브라우저에서 부산버스앱을 실행시키는 custom URL scheme을 사용해보세요.

“http://”, “ftp://”, “market://” 과 같은 문자열을 url scheme 이라 부릅니다.

url scheme을 통해 앱이 실행되는 방식은 다음과 같습니다.

1) 웹페이지에서 하이퍼링크 클릭시 url scheme이 system에 전달됨
2) system에서 전달된 url scheme을 보고 실행가능한 앱이 있는지 확인
3) 해당 url scheme을 받을 수 있는 앱이 있다면 앱을 실행시키며 이 url을 함께 전달
4) 앱이 실행되면서 url에 포함된 내용을 참조해서 특정 기능을 수행함

※ 웹 페이지에서 url scheme을 이용해 부산버스앱을 실행하는 경우, 앱이 미설치된 경우의 예외처리를 구현해야 합니다.

 

1. URL 스킴 구성

 

기본 형식

부산버스앱을 실행시키기 위해서는 다음과 같은 형식의 custom url을 구성해야 합니다.

 

 

 busanbus://명령어/detail?옵션

 

 

 

 

2. URL 스킴 적용 예제

 

앱 실행

 

명령어: home

 

Sample

busanbus://home

 

 

특성 버스 정류소 정보 호출

 

명령어: stop

파라미터=옵션: busstop=xxxxxx(버스정류소 번호 5자리)

 

Sample

busanbus://stop/detail?busstop=05060

 

 

특정 노선의 정류소 정보 호출

 

명령어: line

파라미터=옵션: nosun=xxxxxx, uniqueid=xxxxxx, ord=xxxxx, busstopname=xxxxx, updown=xxxxx

 

Sample

busanbus://line/detail?nosun=xxxxx&uniqueid=xxxxx&ord=xxxxx&busstopname=xxxxx&updown=xxxxx

 

 

 

 

3. 앱 미설치 시 예외 처리방법

 

시스템 오류메시지를 숨기기 위한 iframe 처리 등이 필요할 수 있습니다.

intent scheme을 이용하면 앱 미설치시 자동으로 마켓으로 이동하므로, 좀더 단순한 처리가 가능합니다.

intent scheme을 이용한 웹 페이지 구성 예는 아래와 같습니다.

 

 

<html>
 <head>
     <meta http-equiv=”Content-Type” content=”text/html; charset=UTF-8″>
   <meta name=”viewport” content=”width=device-width”>
 </head>
 <body>
     <h2><a id=”applink” href=”busanbus://stop/detail?busstop=05060″>05060노선 조회</a></h2>
    </body>
</html>

 

 

부산버스앱이 설치되어 있지 않거나, 구버전이어서 호출이 가능하지 않은지는 아래와 같이 확인이 가능합니다.

 

 

Intent intent = new Intent(android.content.Intent.ACTION_VIEW, Uri.parse(“busanbus://home”));
intent.addCategory(android.content.Intent.CATEGORY_BROWSABLE);
                       
PackageManager pm = getPackageManager();
boolean isInstalled = !pm.queryIntentActivities(intent,
PackageManager.MATCH_DEFAULT_ONLY).isEmpty();

 

 

 

 

댓글 남기기