All posts

Hand the street to Google Maps and the journey stays open

You have picked a spot inside a building, and iseeido is showing the way to its door: the whole route on one screen, how long it takes, and a yellow Start button. Under Start, since build 19, there is a second button. It says Open in Google Maps.

Tap it and the street belongs to another app. The interesting part is what iseeido does next, which is almost nothing.

A link, not a handshake

The button opens an ordinary Google Maps web address for directions. The code builds it from four parts, and only two of them say anything about your journey: where the door is, and how you’re travelling.

google.com/maps/dir/ destination the door, 6 decimals travelmode how you're travelling dir_action=navigate start turn-by-turn api=1 Google's link format
The address iseeido opens has four parts. Two describe the journey; two tell Google Maps what to do with it.

The destination is the door’s latitude and longitude, written to six decimal places. It is the same door iseeido’s own street leg aims for. The travel mode is the one you chose, in Google’s words: walking, driving, bicycling or transit. The address names no starting point, and it carries no place name and no spot inside. The third part asks Google Maps to start turn-by-turn straight away, rather than stopping at a preview of the route.

There was another way to do this. Google Maps on the iPhone also answers to an address scheme of its own, comgooglemaps://. The comment above the code says why iseeido doesn’t use it. A web address like this one is a universal link: it opens the app where it’s installed, and Google’s website where it isn’t. So iseeido never has to ask whether the app is there, and needs no fallback of its own.

  • 4parts in the address iseeido opens
  • 6decimal places on the door’s latitude and longitude
  • 5 minutesthe oldest location fix a journey will count

What iseeido does while you’re away

Nothing, and it has no choice in that. iseeido uses your location only while you’re using the app, never in the background. With Google Maps in front, it gets no location fixes at all, so it can’t follow you.

So the journey isn’t ended, and it isn’t handed over. It stays open, as you left it. Tapping the button does two things: it opens the address, and it adds one sentence to the route card for when you look back. “Directions are open in Google Maps. Come back to iseeido at the door, and it takes you inside.”

iseeido Google Maps Link out Street leg Journey stays open Door Inside You
The street leg leaves iseeido by a link and comes back at the door. The journey stays open in between.

Back at the door

Reopen iseeido and location fixes arrive again. Each one goes through the same code as on any journey. That code ignores a fix more than five minutes old, then measures how far you are from the door. Inside the arrival circle, which an earlier post describes, it does what it always does on arriving. With spoken directions on, it says “You’ve arrived at” and the name of the place or building. It plays the arrival vibration and shows the approach screen. Indoor guidance starts when you tap Start indoor navigation.

Nothing on that path knows Google Maps was involved. The architecture notes put it in a few words: it “arrives as usual”. There is one arrival, not two to keep in step.

Reopen iseeido before the door and the street leg is still on screen. If you’re off the route it had, it asks Google for a new one from where you are, as it would on any journey.

  1. Get directions. The route card shows the whole way to the door, with Start.
  2. Open in Google Maps. The address opens directions to the same door, in the travel mode you chose.
  3. The street. Google Maps guides you. iseeido gets no location, and the journey waits.
  4. Reopen iseeido at the door. A fresh fix inside the arrival circle brings up the approach screen.
  5. Start indoor navigation. One tap, and the scan takes over.

When iseeido’s own directions fail

The same button appears in one other place. When Google turns a route request down, iseeido says: “Street directions are unavailable right now. Try again later, or open them in Google Maps.” Under Try again sits Open in Google Maps. The door’s position doesn’t come from the route. It comes from where the map was placed on Earth, so iseeido still knows where to send you when it can’t draw the way.

When this was written, it was checked in the iPhone Simulator, which has no Google Maps app. There the address opened Google’s website, and the return at the door arrived as usual. The commit says plainly that the Google Maps app itself was not checked.

With the phone in your hand

If you’d rather walk or drive with Google Maps, you can, and you lose nothing inside the building. Remember one thing: iseeido won’t speak up at the door by itself, because it can’t tell where you are until you open it again. With VoiceOver, the button’s hint says as much: “Opens directions to the door in Google Maps. iseeido takes over again at the door.”

Opening the address gives Google Maps the door’s coordinates and your travel mode. The privacy policy says what iseeido’s own route requests send.