mkgeocode

MKGEOCODE

GEO IP

Die GEO-IP-Services werden verwendet, um anhand einer IP eine Position auf der Erde zu ermitteln.

Aktuell ist nur MaxMind als Service eingebunden. Ein mal als konstenpflichtiger WebService und als Lokaler Dienst (kostenlos Möglich) über GEOCityLite.

Aufruf:

$location = tx_mkgeocode_util_GeoIp::getLocationByIp();
echo $location->getLatitude() . ',' . $location->getLongitude();

GEOCODE

Die GEOCODE-Services werden verwendet, um anhand einer Adresse eine Position auf der Erde zu ermitteln.

Aktuell ist der Google Geocode und OpenStreetMap Nominatim Service implementiert. Beide sind initial deaktiviert und müssen über Typoscript/Extension Manager aktiviert/konfiguriert werden.

Aufruf, um anhand einer Adresse Koordinaten zu erhalten:

$location = tx_mkgeocode_util_GeoCode::getInstance()->getLocationByAddress(
    'Stefan-Heym-Platz', '1', 'Chemnitz', '', '09111', 'Deutschland'
);
echo $location->getLatitude() . ',' . $location->getLongitude();

Aufruf, um anhand von Koordinaten eine Adresse zu erhalten:

$location = tx_mkgeocode_util_GeoCode::getInstance()->getLocationByCoordinate(
    '50.833968', '12.925106'
);
echo $location->getStreet() . ' ' . $location->getHouseNumber();

Um die Mapquest API anbinden zu können ist ein API Key nötig. Dieser kann mit einem Account unter https://developer.mapquest.com/ erstellt werden. Eingetragen wird er mit TypoScript:

config.tx_mkgeocode.geocode.nominatim.configs.mapquestapi {
    search.parameters.key = PUT_YOUR_KEY_HERE
    reverse.parameters.key = PUT_YOUR_KEY_HERE
}

Bei nominatim GeoCode Services müssen die folgenden Parameter er-/gesetzt werden:

configs {
    openstreetmap {
        search.parameters {
            ### email, countrycodes und accept-language sollte/muss gesetzt werden
            # email = unknown@unknown.com
            # countrycodes = de,en
            # accept-language = de
        }
        reverse.parameters {
            ### email, countrycodes und accept-language sollte/muss gesetzt werden
            # email = unknown@unknown.com
            # countrycodes = de,en
            # accept-language = de
        }
    }
    mapquestapi {
        search.parameters {
            ### email, countrycodes und accept-language sollte/muss gesetzt werden
            # email = unknown@unknown.com
            # countrycodes = de,en
            # accept-language = de
        }
        reverse.parameters {
            ### email, countrycodes und accept-language sollte/muss gesetzt werden
            # email = unknown@unknown.com
            # countrycodes = de,en
            # accept-language = de
        }
    }
}