/**
* Vraag een gemeente op op basis van zijn naam.
*
* @param string $gemeenteNaam
* @param integer $gewestId Zie de KVDgis_Crab2Gateway::GEWEST_ constanten
* @return array Associatieve array met de volgende sleutels:
* <ul>
* <li>gewestId: Het nummer van het gewest waarin de straat ligt.</li>
* <li>gemeenteNaam: Naam van de gemeente.</li>
* <li>gemeenteId: Het Crab Id van de gemeente. Dit is niet gelijk aan de NIS-code.</li>
* <li>nisGemeenteCode: De NIS-code voor de gemeente.</li>
* <li>taalCode: De eerste taal in de gemeente.</li>
* <li>taalCodeGemeenteNaam: De taalvode van de gemeetenaam.</li>
* <li>centerX: De x-coordinaat van de centroide van de gemeente.</li>
* <li>centerY: De y-coordinaat van de centroide van de gemeente.</li>
* </ul>
* @throws RuntimeException Indien de gemeente niet kon geladen worden.
*/
public function getGemeenteByGemeenteNaam($gemeenteNaam, $gewestId = self::GEWEST_VLAANDEREN)
{
$params = new stdClass();
$params->GemeenteNaam = $gemeenteNaam;
$params->GewestId = $gewestId;
$paramsWrapper = new SoapParam($params, "GetGemeenteByGemeenteNaam");
try {
$result = $this->_client->GetGemeenteByGemeenteNaam($paramsWrapper);
return $this->loadGemeenteArray($result->GetGemeenteByGemeenteNaamResult);
} catch (Exception $e) {
throw new RuntimeException("Kon de gemeente met gemeenteNaam {$gemeenteNaam} niet laden wegens: " . $e->getMessage());
}
}
