About kpostal

Kpostal package can search for Korean postal addresses using Kakao postcode service.
This package is inspired by Kopo package that is discontinued.

By default, it uses the Address Search page hosted on Github.
It's the easiest way to use it.

To respond to errors that arise from hosting problems, it also supports hosting local server.

Kpostal also provides latitude, longitude of the address. It uses the free Geocoding services provided by the iOS and Android platforms. This means that there are restrictions to their use. More information can be found in the Apple documentation for iOS and the Google documentation for Android and the geocoding plugin. If you use kakao maps api, you can also get a kakao geocoding value.

Support Null-Safety!

Getting Started

Add kpostal to your pubspec.yaml file:

dependencies:
  kpostal:

Setup

🧑🏻‍💻 Neither iOS nor Android requires any action when using default hosting.

[Android] Check internet permission setting on release mode!

// AndroidManifest.xml
<uses-permission android:name="android.permission.INTERNET"/>

❗ Use local server (Optional)

If you use the [useLocalServer] option to host a local server, you should make the platform specific settings required for http communication.

Android

Add android:usesClearextTraffic="true" to in AndroidManifest.xml file.

<application
        android:label="[your_app]"
        android:icon="@mipmap/ic_launcher"
        ...
        android:usesCleartextTraffic="true"
        ...
        >
    ...
</application>

iOS

Add NSAppTransportSecurity to info.plist file.

<plist version="1.0">
<dict>
    ...
    <key>NSAppTransportSecurity</key>
    <dict>
        <key>NSAllowsArbitraryLoads</key>
        <true/>
    </dict>
    ...
</dict>
</plist>

🧩 Kakao geocoding(*optional)

1. Go to Kakao Developer Site
2. Register developer and create app
3. Add Web Platform: Select App – [Platform] – [Web Platform Registration] – Site Domain Registration
4. Register Site Domain: Select the Web platform, and register Site Domain.
   • default, use https://tykann.github.io
   • if you use local server, use http://localhost:{your port, default is 8080}
5. Use the JavaScript key at the top of the page as the app key for the map API.

Example

import 'package:kpostal/kpostal.dart';

// Use callback.
TextButton(
    onPressed: () async {
        await Navigator.push(context, MaterialPageRoute(
            builder: (_) => KpostalView(
                callback: (Kpostal result) {
                    print(result.address);
                },
            ),
        ));
    },
    child: Text('Search!'),
),

// Not use callback.
TextButton(
    onPressed: () async {
        Kpostal result = await Navigator.push(context, MaterialPageRoute(builder: (_) => KpostalView()));
        print(result.address);
    },
    child: Text('Search!'),
),

// Use local server.
KpostalView(
    useLocalServer: true, // default is false
    localPort: 8080, // default is 8080
    kakaoKey: '{your kakao developer app\'s JS key}' // if not declared, only use platform's geocoding
    callback: ...
)