# api-ntrip-java-client

**Repository Path**: KyleLuo/api-ntrip-java-client

## Basic Information

- **Project Name**: api-ntrip-java-client
- **Description**: ntrip仓库
- **Primary Language**: Java
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-02
- **Last Updated**: 2026-06-02

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

api-ntrip-java-client
=====================

Este projecto consiste numa aplicação Android que contém um serviço para acesso a servidores que utilizam o protocolo NTRIP. Este trabalho teve como base código *open source* que pode ser encontrado em lefebure.com.

Existem três entidades diferentes:

- Um serviço NTRIP que permite a gestão de uma interface Bluetooth e de uma ligação TCP/IP, com o servidor de NTRIP. Os conteúdos RTCM provenientes da estação de referencia são enviados para uma porta série do GPS diferencial que por sua vez está ligado a uma interface Bluetooth. O código encontra-se na biblioteca NTRIPLib (`NTRIPService.java`) ;
- Uma classe que permite a interface com o serviço acima descrito de um a forma bastante fácil, encontra-se na biblioteca NTRIPLib (`NTrip.java`);
- Uma terceira entidade é uma aplicação exemplo que permite o programador avaliar a forma de utilizar o a serviço NTRIP, encontra-se em `NTRIPCustom`;

## Processo de linkagem da biblioteca ##

As instruções apresentadas aplicam-se ao Eclipse 3.7 com ADT plugin versão 18.0.0 ou superior.

No Eclipse, importar o projecto da biblioteca:

> 1. Menu File Import;
> 2. Existing projects into workspace;
> 3. Selecionar o projecto com a biblioteca (NTRIPLib);

Verificar se o projecto é biblioteca:

> 1. Selecionar o projecto no Package Explorer;
> 2. Menu Project Properties
> 3. Seleccionar Android
> 4. Verificar que o "Is Library" está seleccionado

Criar um novo projecto de android (`Menu New > Android project`) com uma actividade.
Utilizar a biblioteca previamente importada:

> 1. Selecionar o projecto no Package Explorer;
> 2. Menu Project Properties
> 3. Selecionar Android
> 4. Add
> 5. Seleccionar a biblioteca e carregar `ok`
> 6. Carregar `ok`

##Instruções de utilização da biblioteca##

Na actividade, criar uma instância da classe de biblioteca:

    NTrip ntrip = new NTrip(activity) {
	    @Override
	    public void UpdateStatus(String fixtype, String info1, String info2) {}

	    @Override
	    public void UpdateLogAppend(String msg) {}

	    @Override
	    public void UpdatePosition(double time, double lat, double lon) 
        {android.util.Log.d("Debug","Posição actualizada "+time+" "+lat+"º "+lon+"º");}

	    @Override
	    public void onServiceConnected() {	}
     };

Definir as opções NTrip:

    ntrip.MACAddress = bluetoothMAC;
    ntrip.MOUNTPOINT = mountpoint;
    ntrip.SERVERIP = serverIP;
    ntrip.SERVERPORT = serverPORT;
    ntrip.SendGGAToServer = true;
    ntrip.NetworkProtocol = "ntripv1";
    ntrip.USERNAME = server_username;
    ntrip.PASSWORD = server_pass;

Arrancar o sistema NTrip:

`ntrip.Connect();`

Fechar o sistema NTrip:

`ntrip.Disconnect();`


##Instruções de utilização do exemplo##

As instruções apresentadas aplicam-se ao Eclipse 3.7 com ADT plugin versão 18.0.0 ou superior.

No Eclipse, importar o projecto da biblioteca:
> 1. Menu File Import;
> 2. Existing projects into workspace;
> 3. Seleccionar o projecto com a biblioteca (NTRIPLib);

No Eclipse, importar o projecto de exemplo:

> 1. Menu File Import;
> 2. Existing projects into workspace;
> 3. Seleccionar o projecto com o exemplo (NTRIPCustom);