| // Do not edit directly! |
| // This file was generated by camel-quarkus-maven-plugin:update-extension-doc-page |
| = Geocoder |
| :linkattrs: |
| :cq-artifact-id: camel-quarkus-geocoder |
| :cq-native-supported: true |
| :cq-status: Stable |
| :cq-status-deprecation: Stable |
| :cq-description: Find geocodes (latitude and longitude) for a given address or the other way round. |
| :cq-deprecated: false |
| :cq-jvm-since: 1.1.0 |
| :cq-native-since: 1.2.0 |
| |
| [.badges] |
| [.badge-key]##JVM since##[.badge-supported]##1.1.0## [.badge-key]##Native since##[.badge-supported]##1.2.0## |
| |
| Find geocodes (latitude and longitude) for a given address or the other way round. |
| |
| == What's inside |
| |
| * xref:{cq-camel-components}::geocoder-component.adoc[Geocoder component], URI syntax: `geocoder:address:latlng` |
| |
| Please refer to the above link for usage and configuration details. |
| |
| == Maven coordinates |
| |
| https://code.quarkus.io/?extension-search=camel-quarkus-geocoder[Create a new project with this extension on code.quarkus.io, window="_blank"] |
| |
| Or add the coordinates to your existing project: |
| |
| [source,xml] |
| ---- |
| <dependency> |
| <groupId>org.apache.camel.quarkus</groupId> |
| <artifactId>camel-quarkus-geocoder</artifactId> |
| </dependency> |
| ---- |
| |
| Check the xref:user-guide/index.adoc[User guide] for more information about writing Camel Quarkus applications. |
| |
| == SSL in native mode |
| |
| This extension auto-enables SSL support in native mode. Hence you do not need to add |
| `quarkus.ssl.native=true` to your `application.properties` yourself. See also |
| https://quarkus.io/guides/native-and-ssl[Quarkus SSL guide]. |
| |
| == Additional Camel Quarkus configuration |
| |
| Locales different from the build machine's default locale do not work well in native mode due to https://github.com/oracle/graal/issues/1645[this GraalVM bug]. The `google-maps-services` library this extension depends on uses `Locale.English` to format double latitude and longitude values. As a consequence of these two facts, the locale on the building machine must be set to some English locale, such as `en_US.UTF-8`, `en_GB.UTF-8` or `en_IE.UTF-8` so that the calls to the Google Maps API work properly. On Linux, you need to check the value of the `LANG` environment variable, e.g. via `echo $LANG` and change the value via `export LANG=en_US.UTF-8` if necessary. |
| |