--- description: Capacitor plugin for handling geocoding and reverse geocoding with cross-platform support and high performance. title: Capacitor Geocoder Plugin for Android, iOS & Web - Capawesome image: https://capawesome.io/docs/assets/images/social/sdks/capacitor/geocoder.png --- [Skip to content ](#capacitor-geocoder-plugin) [πŸ” Introducing the **Capacitor Vault** plugin β€” store secrets behind biometrics or a device passcode. ](/blog/announcing-the-capacitor-vault-plugin/) * [ SDKs ](/docs/sdks/) * [ Formbricks ](/docs/sdks/capacitor/formbricks/) * Geocoder [ Geocoder ](/docs/sdks/capacitor/geocoder/) * [ API ](#api) * [ FAQ ](#faq) * [ Related Plugins ](#related-plugins) * [ Newsletter ](#newsletter) * [ Changelog ](#changelog) * [ Breaking Changes ](#breaking-changes) * [ License ](#license) * [ Google Sign-In ](/docs/sdks/capacitor/google-sign-in/) * [ Grafana Faro ](/docs/sdks/capacitor/grafana-faro/) * [ Gyroscope ](/docs/sdks/capacitor/gyroscope/) * [ Haptics ](/docs/sdks/capacitor/haptics/) * [ Home Indicator ](/docs/sdks/capacitor/home-indicator/) * [ In-App Browser ](/docs/sdks/capacitor/in-app-browser/) * [ Install Referrer ](/docs/sdks/capacitor/install-referrer/) * [ Keep Awake ](/docs/sdks/capacitor/keep-awake/) * [ libSQL ](/docs/sdks/capacitor/libsql/) * [ Light Sensor ](/docs/sdks/capacitor/light-sensor/) * [ Live Update ](/docs/sdks/capacitor/live-update/) * [ Localization ](/docs/sdks/capacitor/localization/) * [ Mail Composer ](/docs/sdks/capacitor/mail-composer/) * [ Managed Configurations ](/docs/sdks/capacitor/managed-configurations/) * [ Maps Launcher ](/docs/sdks/capacitor/maps-launcher/) * [ Media Session ](/docs/sdks/capacitor/media-session/) * [ ML Kit ](/docs/sdks/capacitor/mlkit/) * [ Navigation Bar ](/docs/sdks/capacitor/navigation-bar/) * [ Network ](/docs/sdks/capacitor/network/) * [ NFC ](/docs/sdks/capacitor/nfc/) * [ Node.js ](/docs/sdks/capacitor/nodejs/) * [ OAuth ](/docs/sdks/capacitor/oauth/) * [ Passkeys ](/docs/sdks/capacitor/passkeys/) * [ Password Autofill ](/docs/sdks/capacitor/password-autofill/) * [ PDF Generator ](/docs/sdks/capacitor/pdf-generator/) * [ PDF Viewer ](/docs/sdks/capacitor/pdf-viewer/) * [ Pedometer ](/docs/sdks/capacitor/pedometer/) * [ Permissions ](/docs/sdks/capacitor/permissions/) * [ Phone Dialer ](/docs/sdks/capacitor/phone-dialer/) * [ Photo Editor ](/docs/sdks/capacitor/photo-editor/) * [ Photo Manipulator ](/docs/sdks/capacitor/photo-manipulator/) * [ PixLive ](/docs/sdks/capacitor/pixlive/) * [ PostHog ](/docs/sdks/capacitor/posthog/) * [ Printer ](/docs/sdks/capacitor/printer/) * [ Privacy Screen ](/docs/sdks/capacitor/privacy-screen/) * [ Proximity Sensor ](/docs/sdks/capacitor/proximity-sensor/) * [ Purchases ](/docs/sdks/capacitor/purchases/) * [ RealtimeKit ](/docs/sdks/capacitor/realtimekit/) * [ Root Detection ](/docs/sdks/capacitor/root-detection/) * [ Screen Brightness ](/docs/sdks/capacitor/screen-brightness/) * [ Screen Orientation ](/docs/sdks/capacitor/screen-orientation/) * [ Screen Reader ](/docs/sdks/capacitor/screen-reader/) * [ Screenshot ](/docs/sdks/capacitor/screenshot/) * [ Secure Preferences ](/docs/sdks/capacitor/secure-preferences/) * [ Settings Launcher ](/docs/sdks/capacitor/settings-launcher/) * [ Shake ](/docs/sdks/capacitor/shake/) * [ Silent Mode ](/docs/sdks/capacitor/silent-mode/) * [ SIM ](/docs/sdks/capacitor/sim/) * [ SMS Composer ](/docs/sdks/capacitor/sms-composer/) * [ Speech Recognition ](/docs/sdks/capacitor/speech-recognition/) * [ Speech Synthesis ](/docs/sdks/capacitor/speech-synthesis/) * [ Share Target ](/docs/sdks/capacitor/share-target/) * [ Square Mobile Payments ](/docs/sdks/capacitor/square-mobile-payments/) * [ SQLite ](/docs/sdks/capacitor/sqlite/) * [ Superwall ](/docs/sdks/capacitor/superwall/) * [ System WebView ](/docs/sdks/capacitor/system-webview/) * [ Text Interaction ](/docs/sdks/capacitor/text-interaction/) * [ Text Zoom ](/docs/sdks/capacitor/text-zoom/) * [ Thermal State ](/docs/sdks/capacitor/thermal-state/) * [ Toast ](/docs/sdks/capacitor/toast/) * [ Torch ](/docs/sdks/capacitor/torch/) * [ Vault ](/docs/sdks/capacitor/vault/) * [ Volume ](/docs/sdks/capacitor/volume/) * [ Wallet ](/docs/sdks/capacitor/wallet/) * [ Wifi ](/docs/sdks/capacitor/wifi/) * [ Zip ](/docs/sdks/capacitor/zip/) * [ Cordova ](/docs/sdks/cordova/) * [ Cloud ](/docs/cloud/) * [ Integrations ](/docs/cloud/live-updates/integrations/) * Concepts * Reference * [ Troubleshooting ](/docs/cloud/live-updates/troubleshooting/) * [ FAQ ](/docs/cloud/live-updates/faq/) * [ Native Builds ](/docs/cloud/native-builds/) * [ Set Up Environments ](/docs/cloud/native-builds/environments/) * [ Overwrite Native Configurations ](/docs/cloud/native-builds/native-configurations/) * [ Auto-Increment Build Numbers ](/docs/cloud/native-builds/auto-incrementing-build-numbers/) * [ Configure the Web Build Script ](/docs/cloud/native-builds/web-build-script/) * [ Build from a Monorepo ](/docs/cloud/native-builds/monorepo/) * [ Use pnpm, Yarn, or bun ](/docs/cloud/native-builds/package-managers/) * [ Install Private npm Packages ](/docs/cloud/native-builds/npm-private-registry/) * [ Override the Java Version ](/docs/cloud/native-builds/override-java-version/) * [ Custom iOS Provisioning Profiles ](/docs/cloud/native-builds/custom-ios-provisioning-profiles/) * [ Build without Git ](/docs/cloud/native-builds/build-without-git/) * [ Access Git Behind a Firewall ](/docs/cloud/native-builds/firewall-access/) * [ Integrations ](/docs/cloud/native-builds/integrations/) * Reference * [ Troubleshooting ](/docs/cloud/native-builds/troubleshooting/) * [ FAQ ](/docs/cloud/native-builds/faq/) * [ App Store Publishing ](/docs/cloud/app-store-publishing/) * [ Submit a Build ](/docs/cloud/app-store-publishing/submit-a-build/) * [ Submit Automatically After a Build ](/docs/cloud/app-store-publishing/submit-automatically/) * [ Troubleshooting ](/docs/cloud/app-store-publishing/troubleshooting/) * [ FAQ ](/docs/cloud/app-store-publishing/faq/) * [ Automations ](/docs/cloud/automations/) * [ Reference ](/docs/cloud/automations/reference/) * [ Troubleshooting ](/docs/cloud/automations/troubleshooting/) * [ FAQ ](/docs/cloud/automations/faq/) * [ Assist ](/docs/cloud/assist/) * [ CLI ](/docs/cloud/cli/) * APIs and SDKs * [ Webhooks ](/docs/cloud/webhooks/) * [ Integrations ](/docs/cloud/integrations/) * Account * [ Organization ](/docs/cloud/organizations/) * [ Two-Factor Enforcement ](/docs/cloud/organizations/two-factor-authentication/) * [ Audit Logs ](/docs/cloud/organizations/audit-logs/) * [ Billing ](/docs/cloud/organizations/billing/) * [ License Keys ](/docs/cloud/license-keys/) * [ AI ](/docs/ai/) * [ Insiders ](/docs/insiders/) * [ Billing & Plans ](/docs/insiders/billing-and-plans/) * [ FAQ ](/docs/insiders/faq/) * [ License ](https://capawesome.io/legal/eula/) * [ Support ](/docs/support/) * [ Contributing ](/docs/contributing/) * Contributing code * [ Code of Conduct ](/docs/contributing/code-of-conduct/) * [ Questions ](https://docs.github.com/en/discussions/collaborating-with-your-community-using-discussions/participating-in-a-discussion#creating-a-discussion) * [ Blog ](/blog/) * Categories * [ API ](#api) * [ FAQ ](#faq) * [ Related Plugins ](#related-plugins) * [ Newsletter ](#newsletter) * [ Changelog ](#changelog) * [ Breaking Changes ](#breaking-changes) * [ License ](#license) # Capacitor Geocoder Plugin[ΒΆ](#capacitor-geocoder-plugin "Permanent link") Capacitor plugin for handling geocoding and reverse geocoding. [ ![Deliver Live Updates to your Capacitor app with Capawesome Cloud](../../../assets/external/cloud.capawesome.io/assets/banners/cloud-build-and-deploy-capacitor-apps.69628c3f.png) ](https://cloud.capawesome.io/) ## Features[ΒΆ](#features "Permanent link") The Capacitor Geocoder plugin is one of the most complete geocoding solutions for Capacitor apps. Here are some of the key features: * πŸ–₯️ **Cross-platform**: Supports Android, iOS and Web. * πŸ“ **Geocoding**: Convert addresses into geographic coordinates. * πŸ—ΊοΈ **Reverse Geocoding**: Convert geographic coordinates into human-readable addresses. * 🌐 **Multiple Providers**: Support for Google Maps and OpenStreetMap on Web. * 🌍 **Localization**: Customize the locale for geocoding requests. * πŸ”’ **Configurable Results**: Limit the number of addresses returned in reverse geocoding operations. * πŸ› οΈ **Native APIs**: Uses platform-native geocoding services on Android and iOS for reliable and accurate results. * πŸ“¦ **CocoaPods & SPM**: Supports CocoaPods and Swift Package Manager for iOS. * πŸ” **Up-to-date**: Always supports the latest Capacitor version. * ⭐️ **Support**: Priority support from the Capawesome Team. * ✨ **Handcrafted**: Built from the ground up with care and expertise, not forked or AI-generated. Missing a feature? Just [open an issue](https://github.com/capawesome-team/capacitor-plugins/issues) and we'll take a look! ## Use Cases[ΒΆ](#use-cases "Permanent link") The Geocoder plugin is typically used whenever an app needs to translate between addresses and coordinates, for example: * **Address search**: Convert a user-entered address into geographic coordinates to display the location on a map. * **Location labeling**: Show a human-readable address for given coordinates, for example the user's current position. * **Address forms**: Prefill address fields such as postal code, country, or administrative area based on coordinates. * **Localized results**: Return addresses in the user's preferred language using the `locale` option. ## Compatibility[ΒΆ](#compatibility "Permanent link") | Plugin Version | Capacitor Version | Status | | -------------- | ----------------- | -------------- | | 8.x.x | \>=8.x.x | Active support | | 0.1.x | 7.x.x | Deprecated | ## Demo[ΒΆ](#demo "Permanent link") | Android | iOS | Web | | --------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------- | | ![Android Demo](https://capawesome.io/docs/assets/images/gifs/capacitor-geocoder-android.gif) | ![iOS Demo](https://capawesome.io/docs/assets/images/gifs/capacitor-geocoder-ios.gif) | ![Web Demo](https://capawesome.io/docs/assets/images/gifs/capacitor-geocoder-web.gif) | ## Installation[ΒΆ](#installation "Permanent link") This plugin is only available to [Capawesome Insiders](https://capawesome.io/insiders/). First, make sure you have the Capawesome npm registry set up. You can do this by running the following commands: `[](#%5F%5Fcodelineno-0-1)npm config set @capawesome-team:registry https://npm.registry.capawesome.io [](#%5F%5Fcodelineno-0-2)npm config set //npm.registry.capawesome.io/:_authToken ` **Attention**: Replace `` with the license key you received from Polar. If you don't have a license key yet, you can get one by becoming a [Capawesome Insider](https://capawesome.io/insiders/). Next, you can use our **AI-Assisted Setup** to install the plugin. Add the [Capawesome Skills](https://github.com/capawesome-team/skills) to your AI tool using the following command: `[](#%5F%5Fcodelineno-1-1)npx skills add capawesome-team/skills --skill capacitor-plugins ` Then use the following prompt: `` [](#%5F%5Fcodelineno-2-1)Use the `capacitor-plugins` skill from `capawesome-team/skills` to install the `@capawesome-team/capacitor-geocoder` plugin in my project. `` If you prefer **Manual Setup**, install the plugin by running the following commands and follow the platform-specific instructions below: `[](#%5F%5Fcodelineno-3-1)npm install @capawesome-team/capacitor-geocoder universal-geocoder [](#%5F%5Fcodelineno-3-2)npx cap sync ` ## Usage[ΒΆ](#usage "Permanent link") The following examples show how to convert an address into coordinates and how to convert coordinates back into an address. ### Convert an address into coordinates[ΒΆ](#convert-an-address-into-coordinates "Permanent link") Use the `geocode(...)` method to translate a human-readable address into geographic coordinates, for example to display the location on a map: `[](#%5F%5Fcodelineno-4-1)import { Geocoder } from '@capawesome-team/capacitor-geocoder'; [](#%5F%5Fcodelineno-4-2) [](#%5F%5Fcodelineno-4-3)const geocode = async () => { [](#%5F%5Fcodelineno-4-4) const result = await Geocoder.geocode({ [](#%5F%5Fcodelineno-4-5) address: '1600 Amphitheatre Parkway, Mountain View, CA', [](#%5F%5Fcodelineno-4-6) }); [](#%5F%5Fcodelineno-4-7) console.log('Geocode result:', result); [](#%5F%5Fcodelineno-4-8)}; ` ### Convert coordinates into an address[ΒΆ](#convert-coordinates-into-an-address "Permanent link") Use the `geodecode(...)` method to translate geographic coordinates into one or more human-readable addresses. The number of returned addresses can be limited with the `limit` option: `[](#%5F%5Fcodelineno-5-1)import { Geocoder } from '@capawesome-team/capacitor-geocoder'; [](#%5F%5Fcodelineno-5-2) [](#%5F%5Fcodelineno-5-3)const geodecode = async () => { [](#%5F%5Fcodelineno-5-4) const result = await Geocoder.geodecode({ [](#%5F%5Fcodelineno-5-5) latitude: 37.422, [](#%5F%5Fcodelineno-5-6) longitude: -122.084, [](#%5F%5Fcodelineno-5-7) }); [](#%5F%5Fcodelineno-5-8) console.log('Geodecode result:', result); [](#%5F%5Fcodelineno-5-9)}; ` ## API[ΒΆ](#api "Permanent link") * [geocode(...)](#geocode) * [geodecode(...)](#geodecode) * [Interfaces](#interfaces) ### geocode(...)[ΒΆ](#geocode "Permanent link") `[](#%5F%5Fcodelineno-6-1)geocode(options: GeocodeOptions) => Promise ` Translate an address into geographic coordinates. Only available on Android and iOS. | Param | Type | | ----------- | --------------------------------- | | **options** | [GeocodeOptions](#geocodeoptions) | **Returns:** `Promise<[GeocodeResult](#geocoderesult)>` **Since:** 0.0.1 --- ### geodecode(...)[ΒΆ](#geodecode "Permanent link") `[](#%5F%5Fcodelineno-7-1)geodecode(options: GeodecodeOptions) => Promise ` Translate geographic coordinates into a human-readable address. Only available on Android and iOS. | Param | Type | | ----------- | ------------------------------------- | | **options** | [GeodecodeOptions](#geodecodeoptions) | **Returns:** `Promise<[GeodecodeResult](#geodecoderesult)>` **Since:** 0.0.1 --- ### Interfaces[ΒΆ](#interfaces "Permanent link") #### GeocodeResult[ΒΆ](#geocoderesult "Permanent link") | Prop | Type | Description | Since | | ------------- | ------ | --------------------------------------- | ----- | | **latitude** | number | The latitude of the geocoded location. | 0.0.1 | | **longitude** | number | The longitude of the geocoded location. | 0.0.1 | #### GeocodeOptions[ΒΆ](#geocodeoptions "Permanent link") | Prop | Type | Description | Default | Since | | ---------------- | -------------------------------- | ----------------------------------------------------------------------------------------------------------- | ---------------- | ----- | | **address** | string | The address to geocode. | | 0.0.1 | | **locale** | string | The locale (BCP 47 language tag) to use for the geocoding request. By default, the device's locale is used. | | 0.0.1 | | **webApiKey** | string | The API key to use for the geocoding service. Only available on Web. | | 0.0.1 | | **webProvider** | 'googlemaps' \| 'openstreetmaps' | The provider to use for the geocoding service. Only available on Web. | 'openstreetmaps' | 0.0.1 | | **webUserAgent** | string | The User-Agent identifying your application. Only available on the web. | | 0.0.1 | #### GeodecodeResult[ΒΆ](#geodecoderesult "Permanent link") | Prop | Type | Description | Since | | ------------- | ----------- | ------------------------------------------------------------------------------------------------------------------------ | ----- | | **addresses** | Address\[\] | The list of addresses that match the given coordinates. The number of addresses returned is limited by the limit option. | 0.0.1 | #### Address[ΒΆ](#address "Permanent link") | Prop | Type | Description | Since | | ---------------- | ---------- | ---------------------------------------------------------------- | ----- | | **adminArea** | string | The administrative area (e.g. state or province) of the address. | 0.0.1 | | **addressLines** | string\[\] | The lines of the address. | 0.0.1 | | **countryCode** | string | The country code of the address. | 0.0.1 | | **countryName** | string | The name of the country. | 0.0.1 | | **phoneNumber** | string | The phone number of the address. | 0.0.1 | | **postalCode** | string | The postal code of the address. | 0.0.1 | | **subAdminArea** | string | The sub-administrative area (e.g. county) of the address. | 0.0.1 | | **url** | string | The URL of the address. | 0.0.1 | #### GeodecodeOptions[ΒΆ](#geodecodeoptions "Permanent link") | Prop | Type | Description | Default | Since | | ---------------- | -------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------- | ----- | | **latitude** | number | The latitude of the location to reverse geocode. | | 0.0.1 | | **limit** | number | The maximum number of results to return. | 5 | 0.0.1 | | **longitude** | number | The longitude of the location to reverse geocode. | | 0.0.1 | | **webApiKey** | string | The API key to use for the geocoding service. Only available on Web. | | 0.0.1 | | **webProvider** | 'googlemaps' \| 'openstreetmaps' | The provider to use for the geocoding service. Only available on Web. | 'openstreetmaps' | 0.0.1 | | **webUserAgent** | string | The User-Agent identifying your application. Only needed if webProvider is set to openstreetmaps which uses the Nominatim service (see https://operations.osmfoundation.org/policies/nominatim/). The goal is to be able to limit the number of requests per application. Only available on the web. | | 0.0.1 | ## FAQ[ΒΆ](#faq "Permanent link") ### What is the difference between geocoding and reverse geocoding?[ΒΆ](#what-is-the-difference-between-geocoding-and-reverse-geocoding "Permanent link") Geocoding translates a human-readable address into geographic coordinates, which is what the `geocode` method does. Reverse geocoding is the opposite: the `geodecode` method translates a latitude and longitude into one or more human-readable addresses. ### Which geocoding services does the plugin use?[ΒΆ](#which-geocoding-services-does-the-plugin-use "Permanent link") On Android and iOS, the plugin uses the platform-native geocoding services for reliable and accurate results. On the Web, you can choose between Google Maps and OpenStreetMap using the `webProvider` option, with OpenStreetMap being the default. ### Do I need an API key to use this plugin?[ΒΆ](#do-i-need-an-api-key-to-use-this-plugin "Permanent link") No API key is required on Android and iOS since the plugin uses the platform-native geocoding services. On the Web, you can provide an API key for the geocoding service using the `webApiKey` option. When using the default OpenStreetMap provider, you should also set the `webUserAgent` option to identify your application, as required by the [Nominatim usage policy](https://operations.osmfoundation.org/policies/nominatim/). ### How can I limit the number of addresses returned by a reverse geocoding request?[ΒΆ](#how-can-i-limit-the-number-of-addresses-returned-by-a-reverse-geocoding-request "Permanent link") Use the `limit` option of the `geodecode` method. By default, a maximum of 5 addresses is returned for the given coordinates. ### Can I get results in a specific language?[ΒΆ](#can-i-get-results-in-a-specific-language "Permanent link") Yes, both methods accept a `locale` option that takes a BCP 47 language tag. If no locale is provided, the device's locale is used. ### Can I use this plugin with Ionic, React, Vue or Angular?[ΒΆ](#can-i-use-this-plugin-with-ionic-react-vue-or-angular "Permanent link") Yes, the plugin is framework-agnostic. It works in any Capacitor app regardless of the web framework, including Ionic with Angular, React, or Vue, as well as plain JavaScript projects. ## Related Plugins[ΒΆ](#related-plugins "Permanent link") * [Maps Launcher](https://capawesome.io/docs/sdks/capacitor/maps-launcher/): Launch navigation apps with turn-by-turn directions. * [Compass](https://capawesome.io/docs/sdks/capacitor/compass/): Read the device compass heading. ## Newsletter[ΒΆ](#newsletter "Permanent link") Stay up to date with the latest news and updates about the Capawesome, Capacitor, and Ionic ecosystem by subscribing to our [Capawesome Newsletter](https://cloud.capawesome.io/newsletter/). ## Changelog[ΒΆ](#changelog "Permanent link") See [CHANGELOG.md](https://github.com/capawesome-team/capacitor-plugins/blob/main/packages/geocoder/CHANGELOG.md). ## Breaking Changes[ΒΆ](#breaking-changes "Permanent link") See [BREAKING.md](https://github.com/capawesome-team/capacitor-plugins/blob/main/packages/geocoder/BREAKING.md). ## License[ΒΆ](#license "Permanent link") See [LICENSE](https://github.com/capawesome-team/capacitor-plugins/blob/main/packages/geocoder/LICENSE). July 8, 2026 Back to top ```json {"@context": "https://schema.org", "@graph": [{"@type": "TechArticle", "@id": "https://capawesome.io/docs/sdks/capacitor/geocoder/#article", "headline": "Capacitor Geocoder Plugin for Android, iOS & Web", "name": "Capacitor Geocoder Plugin for Android, iOS & Web", "description": "Capacitor plugin for handling geocoding and reverse geocoding with cross-platform support and high performance.", "inLanguage": "en", "url": "https://capawesome.io/docs/sdks/capacitor/geocoder/", "mainEntityOfPage": "https://capawesome.io/docs/sdks/capacitor/geocoder/", "author": {"@type": "Organization", "name": "Capawesome", "url": "https://capawesome.io", "logo": {"@type": "ImageObject", "url": "https://capawesome.io/assets/images/logo.svg"}}, "publisher": {"@type": "Organization", "name": "Capawesome", "url": "https://capawesome.io", "logo": {"@type": "ImageObject", "url": "https://capawesome.io/assets/images/logo.svg"}}, "about": {"@id": "https://capawesome.io/docs/sdks/capacitor/geocoder/#software"}}, {"@type": "SoftwareSourceCode", "@id": "https://capawesome.io/docs/sdks/capacitor/geocoder/#software", "name": "Capacitor Geocoder Plugin for Android, iOS & Web", "description": "Capacitor plugin for handling geocoding and reverse geocoding with cross-platform support and high performance.", "url": "https://capawesome.io/docs/sdks/capacitor/geocoder/", "programmingLanguage": "TypeScript", "runtimePlatform": "Capacitor", "codeRepository": "https://github.com/capawesome-team", "author": {"@type": "Organization", "name": "Capawesome", "url": "https://capawesome.io", "logo": {"@type": "ImageObject", "url": "https://capawesome.io/assets/images/logo.svg"}}, "publisher": {"@type": "Organization", "name": "Capawesome", "url": "https://capawesome.io", "logo": {"@type": "ImageObject", "url": "https://capawesome.io/assets/images/logo.svg"}}}]} {"@context": "https://schema.org", "@type": "FAQPage", "mainEntity": [{"@type": "Question", "name": "What is the difference between geocoding and reverse geocoding?", "acceptedAnswer": {"@type": "Answer", "text": "Geocoding translates a human-readable address into geographic coordinates, which is what the geocode method does. Reverse geocoding is the opposite: the geodecode method translates a latitude and longitude into one or more human-readable addresses."}}, {"@type": "Question", "name": "Which geocoding services does the plugin use?", "acceptedAnswer": {"@type": "Answer", "text": "On Android and iOS, the plugin uses the platform-native geocoding services for reliable and accurate results. On the Web, you can choose between Google Maps and OpenStreetMap using the webProvider option, with OpenStreetMap being the default."}}, {"@type": "Question", "name": "Do I need an API key to use this plugin?", "acceptedAnswer": {"@type": "Answer", "text": "No API key is required on Android and iOS since the plugin uses the platform-native geocoding services. On the Web, you can provide an API key for the geocoding service using the webApiKey option. When using the default OpenStreetMap provider, you should also set the webUserAgent option to identify your application, as required by the Nominatim usage policy."}}, {"@type": "Question", "name": "How can I limit the number of addresses returned by a reverse geocoding request?", "acceptedAnswer": {"@type": "Answer", "text": "Use the limit option of the geodecode method. By default, a maximum of 5 addresses is returned for the given coordinates."}}, {"@type": "Question", "name": "Can I get results in a specific language?", "acceptedAnswer": {"@type": "Answer", "text": "Yes, both methods accept a locale option that takes a BCP 47 language tag. If no locale is provided, the device's locale is used."}}, {"@type": "Question", "name": "Can I use this plugin with Ionic, React, Vue or Angular?", "acceptedAnswer": {"@type": "Answer", "text": "Yes, the plugin is framework-agnostic. It works in any Capacitor app regardless of the web framework, including Ionic with Angular, React, or Vue, as well as plain JavaScript projects."}}], "url": "https://capawesome.io/docs/sdks/capacitor/geocoder/"} ```