com.graphhopper.reader.pbf.PbfFieldDecoder Maven / Gradle / Ivy

Go to download

Show more of this group Show more artifacts with this name
Show all versions of graphhopper Show documentation

GraphHopper is a fast and memory efficient Java road routing engine working seamlessly with OpenStreetMap data.

There is a newer version: 0.7.0

// This software is released into the Public Domain.  See copying.txt for details.
package com.graphhopper.reader.pbf;

import java.util.Date;

import org.openstreetmap.osmosis.osmbinary.Osmformat;

/**
 * Manages decoding of the lower level PBF data structures.
 * 
 * @author Brett Henderson
 * 

 */
public class PbfFieldDecoder
{
    private static final double COORDINATE_SCALING_FACTOR = 0.000000001;
    private String[] strings;
    private int coordGranularity;
    private long coordLatitudeOffset;
    private long coordLongitudeOffset;
    private int dateGranularity;

    /**
     * Creates a new instance.
     * 

     * @param primitiveBlock The primitive block containing the fields to be decoded.
     */
    public PbfFieldDecoder( Osmformat.PrimitiveBlock primitiveBlock )
    {
        this.coordGranularity = primitiveBlock.getGranularity();
        this.coordLatitudeOffset = primitiveBlock.getLatOffset();
        this.coordLongitudeOffset = primitiveBlock.getLonOffset();
        this.dateGranularity = primitiveBlock.getDateGranularity();

        Osmformat.StringTable stringTable = primitiveBlock.getStringtable();
        strings = new String[stringTable.getSCount()];
        for (int i = 0; i < strings.length; i++)
        {
            strings[i] = stringTable.getS(i).toStringUtf8();
        }
    }

    /**
     * Decodes a raw latitude value into degrees.
     * 

     * @param rawLatitude The PBF encoded value.
     * @return The latitude in degrees.
     */
    public double decodeLatitude( long rawLatitude )
    {
        return COORDINATE_SCALING_FACTOR * (coordLatitudeOffset + (coordGranularity * rawLatitude));
    }

    /**
     * Decodes a raw longitude value into degrees.
     * 

     * @param rawLongitude The PBF encoded value.
     * @return The longitude in degrees.
     */
    public double decodeLongitude( long rawLongitude )
    {
        return COORDINATE_SCALING_FACTOR * (coordLongitudeOffset + (coordGranularity * rawLongitude));
    }

    /**
     * Decodes a raw timestamp value into a Date.
     * 

     * @param rawTimestamp The PBF encoded timestamp.
     * @return The timestamp as a Date.
     */
    public Date decodeTimestamp( long rawTimestamp )
    {
        return new Date(dateGranularity * rawTimestamp);
    }

    /**
     * Decodes a raw string into a String.
     * 
     * @param rawString The PBF encoding string.
     * @return The string as a String.
     */
    public String decodeString( int rawString )
    {
        return strings[rawString];
    }
}