_%lVe^K)!t5bA1r=Oe!^*R4b;EAbT_|ku`hF0C)mP`OuK1h3lPj?ADU
zsT`T_wVuj;;)RdXbj_X^)}esBazT&@%`n#>b|kWlJF%J4e$J%#$R7!
zGtO%35i~YMKNFCpRja;R*55G@#NiaG=Fn29@lfS4(+dAIrRT{KcSs0%pR`}wQzJ?K
zUN(t!hAESF{F*!6^VPJ&C({KLE-ia!o|ma{?r(lVc^zR(&^M7sWS9lYm?vY({KxE_
zUsPOr4e;fpK-#9<&qtE%&mfct`qoYo;Ji&^_Wn^4?2>F)(S7{=+y0sdso&_#w2B$U
z8ZtCd-o55B5gT#e@Tehg2e0$_K9x6-6l1~*yeUhBg_lP%>jRJLeH4AFx--a=xPLAl
z^Kn$G_jJx`8LGxumF)&5`i1kbQ>qn$c}*~!7JeUVv!&zIBK%_
zLGl7_bbZAHE3!U}4Hp6))O*ql{{kastecRr+$rnQfY7FNua_QsdL6QJ^i#=R6@>C{elt%X48vv_VUpp*+)XO918V
zwZ}5K@aT$bKk1Jou)XKoX-5>pIi%k)GREsoqhL|J_7N{a2-fOxxvv>*NYRD&R^e?S
zYH)bo+&=fhp&`kOmUXP<@G4jj)=*mETVEM!`^T?(!e@$@cf20)T#9Co`n48Q5aG-7
zIn&U<>*Zo1h`44QTqX>PGmfWguH@)3M+qplMJ5+c{vLxJ0V4_VE(U4`K3
zO?Rj1nPKzSk3R{$hM{BvBsBboO|$Ptq18t#{sRsCFpNm=>VtNF7n!qZd^eoY(TI;X
znUb8>snI;vX%#r!r}GS~^c*C16ucq+S4@h5lHu8YZthV{;5XCS1>sdK0Q#JQh6(CV
z7ZpE2gn6$BE~`}Y@lFTa-Sh)`HqJ5``WL+UeXcr_w)FER?k?e?
zOoe(9R|3S)a#3b=CGc-N;5>BRQ`o_^V(=
z@ep!v_r~5#93HLzuWH;pkW<@kF53zH!7M0Qe#E3^o*B{PJF6&O+-HHMkXwYbpPu}&
zAq;WZymAHh^&1J#Y1T!@l)k`_22EjHnns8aa4w_Z9q^r^G-K8Zhot1ZWugh&{>7ZS
zSH5Z-KCOoXT?$wlVFYr974k471AipKyS*5r+^=6<5wB~ozg8*+JiKQj=d@xHc|Ujg
zRd1I^u!hYzF>xsiXcw~Mt+E~Y;t3SFPsT-
z-r@4-;YQvqJVBo24y{S++l!Vr?E6dW>`7HWO^Qr~K3cLG51XyR+p_LVlnDbTZP4~j
znyk(4WNkMsUR%r~XBd6IZ|eo))m!?47*OYi@gireiUw-LB1
zf||uM7A7zH+l+q+!Z;B4>ae^;byG~wgby-?$(l;zy2*sc@_r}tou}BaM#e~BbjW0(
z=&;LHlO)G!rtUVfl;6SYsW;y04GW&))`Bb1d+m9bJ1W054}cJ3bnS9uc>V?xF1p+w
zwD65(QQE$1G`R*R=b8HlN%vf$;7RN*B5gQry*vY*kwoEkzrx3k(!njduxP);B
zgv`+#GgQNNg`{Ridoe6O+m07^Bp(h$)av?t6s-Mi;s=PP7KjVhyQ*sGlw@nu
z5mQ8YRyuBc^3JP~KzphP$K}dUFEP6eK?mvb1|3%?I03oot=j>fdoy|D&2rXC(3J6$
zKoMnMUg3*l1hnqES@+pEfl$;nYTCMH3)A)BFBePxMV@9VwKJtTb;uMQHv2cc8;c*S
zK*m8P1P^3#3L8@qG$*W|D*9z7>d)OfBouXCb?-&T`kyhmCc$s){SqRu>UeQVtUrCC
zKl)2#O>+^)HALd8aJ(NlzZ|%MHh+s-Y`GcQh&k?x0wX!BoBr^aW<YBnhm*(-Ju(-p+g05o;
zVJ4M0G@QhA61!XPeJhQUMswIBDbE(IReXF0$TiV^A{Q}`X;%F$zs$NTH~+#wbMa448(j(!pe?I
z6g+gMY>_5kMYGvz%=J)Mnwv@q_N1W`9&4_DMBLfG&@W<3V0a(X|GC*?C;Ex?o0}pr
z4g_B;pXB6$5~3FC2VW}>_Q6-UIa7OFp*K;6;?IIn2_bmc
z~gd@?DX${OAE36jooq(79#*0R5VGZnF~
zY(X_KAY`r6Yc
zY!zFp{PnBJ5zxk|sxLc|HxSj2;%;-DffUUFPx##_V$G(4E!QwOSb4fq8piz#xI}R0
zlXw`W2frHaR#14v2Q`RG-rv^
zGq>QBhR=E_#_R`%`2sYFC241t+5>1FJ(=w3!~F;T8kW>tnlM-1ca
z>q&rj$=>7qJS`_muoeSnmv(%cfi<{9h(bmm*iDz{i@#Z^u6l1XS>J%+kr=cBSGP2#
z=`Mp$aYUibpFT!OxMV8wVj!Kob|`O=9O~K)Q84B#e?{+viUKhw8dq;q*`RnJY8v{T
zDuHY+C=XX(`HH540X(xm7{~rLn+}?TT}o;k$q1wjv$|689#3nU-AD6}Z79*l-ghwhN1>h!}txaSR889oG^LlIE9
zt#v)IsTS;klS^9)q)KgW?j&Ks$)SS9fUA1>JhmgPXbzLeg?+L}6)yyHG
z?~yVL3KiuIO?fwlSwSeb?r(wI+2aDIxz|a#fBI0{xQp+(aBfH#>QAQs602^Q`t?WynJ8d#bdr9Dx0H%E+1EaQhFkopC@=<13M4jn0io5_
z%zKI-qPgn-MAHC&ftKu~M=ph=(KH6Gs(qcZd1NOxfF_~nolayG
z43S4B1kU-0RtGe+4i~*9)-wZZitz)U{&=%OORRWFaDL%(H*hpn=yIN_UHtS$MfNiC
z)U>c(YwV(rf2zI{*Z7<~i@szpM~MEWFGB1z1&^bxi34?lZ^9^)?l9oqd8BtscT_7{
z%D%YhJ(8H#1vHUeHnF#9tG(_Lr<@C;Qj)IlYb*0N2@m8!xW7tMKO^%NAiM;k#pq7Ifvh_91Ijt4pjL_fvSW
zC}rH6dtzKSadBKtg|Tbp1HzoYo6DW
zK_ln9GF5pYKoRCW!d$PN8}zGudZjoQR2VYDniUxyr)D-ldX@o^04;sDcF^0yhUB4q
z-&q1%3e@z$z|a4JOxrWuFaIe;;>q|n72zu-TjWo$4W(+L+Hbfjm&7^wx^3<+-9`#N
zh=jePU|{ci7VGq@8`!9;C|v*m
literal 0
HcmV?d00001
diff --git a/src/type.ts b/src/type.ts
index 74060c9..7a7e98c 100644
--- a/src/type.ts
+++ b/src/type.ts
@@ -24,7 +24,8 @@ export type MapId =
| 'dgis'
| 'liftago'
| 'petalmaps'
- | 'sygic';
+ | 'sygic'
+ | 'w3w';
export type DirectionMode = 'car' | 'walk' | 'public-transport' | 'bike';
diff --git a/src/utils.ts b/src/utils.ts
index 89a992f..a910c42 100644
--- a/src/utils.ts
+++ b/src/utils.ts
@@ -556,6 +556,16 @@ export const generateMapUrl = ({
url = `${prefixes.sygic}coordinate|${lng}|${lat}|`;
}
url += sygicDirectionsMode ? `${sygicDirectionsMode}` : '';
+ break;
+ case 'w3w':
+ // w3w only supports passing the 3 word reference or the current user location
+ // https://developer.what3words.com/tutorial/mobile-linking-to-the-what3words-app#supported-uris
+ if (address) {
+ url = `${prefixes.w3w}show?threewords=${address}`;
+ } else {
+ url = `${prefixes.w3w}show?currentlocation`;
+ }
+
break;
}
From d52cc0ff6b3b44a5ffe36d58aeede9fceed8682a Mon Sep 17 00:00:00 2001
From: Luke <66969275+lcorbett89@users.noreply.github.com>
Date: Sat, 15 Mar 2025 22:59:20 +0000
Subject: [PATCH 2/4] add tests
---
tests/index.test.ts | 22 ++++++++++++++++++++++
1 file changed, 22 insertions(+)
diff --git a/tests/index.test.ts b/tests/index.test.ts
index 0e039c8..c90a90d 100644
--- a/tests/index.test.ts
+++ b/tests/index.test.ts
@@ -634,4 +634,26 @@ describe('showLocation', () => {
);
});
});
+ describe('w3w', () => {
+ it('opens with correct url if address is not provided', () => {
+ verifyThatSettingsLeadToUrl(
+ {
+ latitude,
+ longitude,
+ app: 'w3w',
+ },
+ 'w3w://show?currentlocation',
+ );
+ });
+
+ it('opens with correct url if address (w3w) is provided', () => {
+ verifyThatSettingsLeadToUrl(
+ {
+ app: 'w3w',
+ address: 'test.three.words',
+ },
+ 'w3w://show?threewords=test.three.words',
+ );
+ });
+ });
});
From 39e7ad24482f4b1d4b1b1598f00d7f019177747a Mon Sep 17 00:00:00 2001
From: Luke <66969275+lcorbett89@users.noreply.github.com>
Date: Sat, 15 Mar 2025 23:40:44 +0000
Subject: [PATCH 3/4] add 'words' field instead of using 'address' as this
breaks apple maps directions
---
src/index.ts | 3 +++
src/type.ts | 1 +
src/utils.ts | 11 +++++++++--
tests/index.test.ts | 4 +++-
4 files changed, 16 insertions(+), 3 deletions(-)
diff --git a/src/index.ts b/src/index.ts
index d567049..4640da0 100644
--- a/src/index.ts
+++ b/src/index.ts
@@ -26,6 +26,7 @@ export const showLocation = async ({
latitude,
longitude,
address,
+ words,
sourceLatitude,
sourceLongitude,
appleIgnoreLatLon,
@@ -52,6 +53,7 @@ export const showLocation = async ({
latitude,
longitude,
address,
+ words,
googleForceLatLon,
googlePlaceId,
title: customTitle,
@@ -135,6 +137,7 @@ export const showLocation = async ({
sourceLng,
sourceLatLng,
address: fullAddress,
+ words,
title,
encodedTitle,
prefixes,
diff --git a/src/type.ts b/src/type.ts
index 7a7e98c..a1c12aa 100644
--- a/src/type.ts
+++ b/src/type.ts
@@ -51,6 +51,7 @@ export interface ShowLocationProps {
/** optionally you can enter a full address that will be queried against the map app's API and return the initial results if not the actual matched result. */
/** latitude and longitude will be ignored if the address field is set */
address?: string | null;
+ words?: string | null;
sourceLatitude?: number | null;
sourceLongitude?: number | null;
appleIgnoreLatLon?: boolean;
diff --git a/src/utils.ts b/src/utils.ts
index a910c42..4696bc4 100644
--- a/src/utils.ts
+++ b/src/utils.ts
@@ -175,6 +175,7 @@ export const checkOptions = ({
latitude,
longitude,
address,
+ words,
googleForceLatLon,
googlePlaceId,
title,
@@ -186,6 +187,7 @@ export const checkOptions = ({
latitude?: number | string;
longitude?: number | string;
address?: string | null;
+ words?: string | null;
googleForceLatLon?: boolean | null | undefined;
googlePlaceId?: number | string | null | undefined;
title?: string | null | undefined;
@@ -202,6 +204,9 @@ export const checkOptions = ({
if (address && typeof address !== 'string') {
throw new MapsException('Option `address` should be of type `string`.');
}
+ if (words && typeof words !== 'string') {
+ throw new MapsException('Option `words` should be of type `string`.');
+ }
if (title && typeof title !== 'string') {
throw new MapsException('`title` should be of type `string`.');
}
@@ -244,6 +249,7 @@ export const generateMapUrl = ({
sourceLng,
sourceLatLng,
address,
+ words,
title,
encodedTitle,
prefixes,
@@ -262,6 +268,7 @@ export const generateMapUrl = ({
sourceLng?: number;
sourceLatLng?: string;
address?: string | null;
+ words?: string | null;
title?: string | null;
encodedTitle?: string;
prefixes: Record;
@@ -560,8 +567,8 @@ export const generateMapUrl = ({
case 'w3w':
// w3w only supports passing the 3 word reference or the current user location
// https://developer.what3words.com/tutorial/mobile-linking-to-the-what3words-app#supported-uris
- if (address) {
- url = `${prefixes.w3w}show?threewords=${address}`;
+ if (words) {
+ url = `${prefixes.w3w}show?threewords=${words}`;
} else {
url = `${prefixes.w3w}show?currentlocation`;
}
diff --git a/tests/index.test.ts b/tests/index.test.ts
index c90a90d..f856b10 100644
--- a/tests/index.test.ts
+++ b/tests/index.test.ts
@@ -649,8 +649,10 @@ describe('showLocation', () => {
it('opens with correct url if address (w3w) is provided', () => {
verifyThatSettingsLeadToUrl(
{
+ latitude,
+ longitude,
app: 'w3w',
- address: 'test.three.words',
+ words: 'test.three.words',
},
'w3w://show?threewords=test.three.words',
);
From b581f18ce155df65ac38a34f9daf29b69ae001b2 Mon Sep 17 00:00:00 2001
From: Luke <66969275+lcorbett89@users.noreply.github.com>
Date: Sun, 16 Mar 2025 00:01:18 +0000
Subject: [PATCH 4/4] Update README.md
---
README.md | 6 ++++--
1 file changed, 4 insertions(+), 2 deletions(-)
diff --git a/README.md b/README.md
index bfc0135..06ab086 100644
--- a/README.md
+++ b/README.md
@@ -282,13 +282,15 @@ showLocation({
});
```
-When using the whatThreeWords app, only the 3 words should be used in the `address` field instead of the `latitude` and `longitude` properties.
+When using the whatThreeWords app, the 3 words should be passed into the `words` field along with the `latitude` and `longitude` properties.
```js
import {showLocation} from 'react-native-map-link';
showLocation({
- address: 'daring.lion.race', // Required if using w3w provider
+ latitude: 38.8976763,
+ longitude: -77.0387185,
+ words: 'rope.noses.canny', // Required if using w3w provider
app: 'w3w', // optionally specify specific app to use
});
```