1.0.0 • Published 4 years ago

@oniq/capacitor-plugin-geocoder v1.0.0

Weekly downloads
2
License
MIT
Repository
gitlab
Last release
4 years ago

capacitor-plugin-geocoder

Capacitory plugin for Reverse and forward geocode. Note: This plugin is not tested high enought, and it's still in experimental phase, use at your own risk.

Demo

Soon.

Maintainers

MaintainerGitlabContact
Fernando ZamperinOniQ Tecnologia Website

Installation

$ npm i --save @oniq/capacitor-plugin-geocoder

Using yarn?

yarn add @oniq/capacitor-plugin-geocoder

Android configuration

In file android/app/src/main/java/**/**/MainActivity.java, add the plugin to the initialization list:

  import br.com.oniq.geocoder.NativeGeocoder;

  this.init(savedInstanceState, new ArrayList<Class<? extends Plugin>>() {{
+   add(NativeGeocoder.class); //Add class here
  }});

iOS configuration

No extra step is needed

API

Reverse Geocode

Transforms latitude and longitude into a Result object containing information about a place (can be a street or a known placemark)

import { Plugins } from '@capacitor/core';
const { NativeGeocoder } = Plugins;

NativeGeocoder.reverseGeocode({
    latitude: -23.6065943,
    longitude: -46.7468018,
}).then(result => {
    // Result is an array containing adresses information;
}).catch(err => {
    console.error(err)
})

Parameters

An object containing the following parameters:

ParameterTypeOptionalDescription
latitudeNumberNoLatitude
longitudeNumberNoLongitude
optionsObjectYesObject containing optional options

All available options attributes:

AttributeTypeComment
localeStringOptional. Force the locale for the results, if not set will be used the devices default
maxResultsNumberOptional. Min and default value: 1, max value: 5

Forward Geocode

Transforms a string of an address into a full complete address object containing Latitude and Longitude

import { Plugins } from '@capacitor/core';
const { NativeGeocoder } = Plugins;

NativeGeocoder.forwardGeocode({
    address: "San Francisco" //Can be a city, street, or some known place;\
}).then(result => {
    // Result is an array containing adresses information;
}).catch(err => {
    console.error(err)
})

Parameters

An object containing the following parameters:

ParameterTypeOptionalDescription
addressStringNoThe string to be geocoded (can be street, avenue, known place)
optionsObjectYesObject containing optional options

All available options attributes:

AttributeTypeComment
localeStringOptional. Force the locale for the results, if not set will be used the devices default
maxResultsNumberOptional. Min and default value: 1, max value: 5
1.0.0

4 years ago

0.0.2

4 years ago

0.0.1

4 years ago