Developer Documentation &
Deep Linking Hub.

import 'package:url_launcher/url_launcher.dart';

/// Launches RazeGo Turn-by-Turn GPS navigation.
/// Supports single destinations and two-destination delivery routes (Pickup -> Dropoff).
Future<void> openInRazeGo({
  required double lat,
  required double lng,
  String? name,
  // Optional Second Destination (Dropoff / Customer Delivery)
  double? lat2,
  double? lng2,
  String? name2,
  bool navigate = true,
}) async {
  final query = <String, String>{
    'lat': lat.toString(),
    'lng': lng.toString(),
    if (name != null && name.trim().isNotEmpty) 'name': name.trim(),
    if (lat2 != null && lng2 != null) ...{
      'lat2': lat2.toString(),
      'lng2': lng2.toString(),
      if (name2 != null && name2.trim().isNotEmpty) 'name2': name2.trim(),
    },
    if (navigate) 'navigate': '1',
  };

  final appUri = Uri(scheme: 'raze', host: 'location', queryParameters: query);
  final universalUri = Uri.https('razego.adoliy.com', '/location', queryParameters);

  // 1. Try launching native RazeGo app directly
  try {
    final launched = await launchUrl(appUri, mode: LaunchMode.externalApplication);
    if (launched) return;
  } catch (_) {
    // If native scheme fails or app not installed, fallback to Universal Link
  }

  // 2. Universal Link fallback (opens interactive web card with App Store & Google Play buttons)
  await launchUrl(universalUri, mode: LaunchMode.externalApplication);
}

import { Linking } from 'react-native';

export interface RazeLocationOptions {
  lat: number;
  lng: number;
  name?: string;
  // Optional Second Destination (Dropoff / Customer Address)
  lat2?: number;
  lng2?: number;
  name2?: string;
  navigate?: boolean;
}

export const openInRazeGo = async ({
  lat,
  lng,
  name,
  lat2,
  lng2,
  name2,
  navigate = true,
}: RazeLocationOptions): Promise<void> => {
  const params = new URLSearchParams({
    lat: lat.toString(),
    lng: lng.toString(),
    ...(name ? { name } : {}),
    ...(lat2 !== undefined && lng2 !== undefined
      ? {
          lat2: lat2.toString(),
          lng2: lng2.toString(),
          ...(name2 ? { name2 } : {}),
        }
      : {}),
    ...(navigate ? { navigate: '1' } : {}),
  });

  const appUrl = `raze://location?${params.toString()}`;
  const universalUrl = `https://razego.adoliy.com/location?${params.toString()}`;

  try {
    const isSupported = await Linking.canOpenURL(appUrl);
    if (isSupported) {
      await Linking.openURL(appUrl);
      return;
    }
  } catch {
    // continue to fallback
  }

  // Fallback to Universal Link (displays web card or store download buttons)
  await Linking.openURL(universalUrl);
};

import UIKit

public enum RazeGoNavigator {
    /// Opens coordinates in RazeGo with direct GPS turn-by-turn guidance.
    /// Supports single destinations and 2-destination delivery routes (Pickup -> Dropoff).
    /// Falls back to the universal web card / App Store if RazeGo is not installed.
    public static func open(
        latitude: Double,
        longitude: Double,
        name: String? = nil,
        // Optional Second Destination (Dropoff / Customer Address)
        latitude2: Double? = nil,
        longitude2: Double? = nil,
        name2: String? = nil,
        directNavigation: Bool = true
    ) {
        var queryItems = [
            URLQueryItem(name: "lat", value: "\(latitude)"),
            URLQueryItem(name: "lng", value: "\(longitude)"),
            URLQueryItem(name: "navigate", value: directNavigation ? "1" : "0")
        ]
        if let name = name, !name.isEmpty {
            queryItems.append(URLQueryItem(name: "name", value: name))
        }
        if let lat2 = latitude2, let lng2 = longitude2 {
            queryItems.append(URLQueryItem(name: "lat2", value: "\(lat2)"))
            queryItems.append(URLQueryItem(name: "lng2", value: "\(lng2)"))
            if let name2 = name2, !name2.isEmpty {
                queryItems.append(URLQueryItem(name: "name2", value: name2))
            }
        }

        var appComponents = URLComponents()
        appComponents.scheme = "raze"
        appComponents.host = "location"
        appComponents.queryItems = queryItems

        var webComponents = URLComponents(string: "https://razego.adoliy.com/location")!
        webComponents.queryItems = queryItems

        guard let appUrl = appComponents.url, let webUrl = webComponents.url else { return }

        // Attempt direct launch into RazeGo; seamlessly fallback to Universal Link/Store if not installed
        if UIApplication.shared.canOpenURL(appUrl) {
            UIApplication.shared.open(appUrl, options: [:], completionHandler: nil)
        } else {
            UIApplication.shared.open(webUrl, options: [:], completionHandler: nil)
        }
    }
}

package com.example.navigation

import android.content.Context
import android.content.Intent
import android.net.Uri

object RazeGoLauncher {
    fun open(
        context: Context,
        lat: Double,
        lng: Double,
        name: String? = null,
        // Optional Second Destination (Dropoff / Customer Address)
        lat2: Double? = null,
        lng2: Double? = null,
        name2: String? = null,
        navigate: Boolean = true
    ) {
        val query = StringBuilder("lat=$lat&lng=$lng")
        if (!name.isNullOrBlank()) {
            query.append("&name=").append(Uri.encode(name))
        }
        if (lat2 != null && lng2 != null) {
            query.append("&lat2=$lat2&lng2=$lng2")
            if (!name2.isNullOrBlank()) {
                query.append("&name2=").append(Uri.encode(name2))
            }
        }
        if (navigate) {
            query.append("&navigate=1")
        }

        // Try direct intent to com.raze.app.raze
        val appIntent = Intent(Intent.ACTION_VIEW, Uri.parse("raze://location?$query")).apply {
            setPackage("com.raze.app.raze")
            addFlags(Intent.FLAG_ACTIVITY_NEW_TASK)
        }

        try {
            context.startActivity(appIntent)
        } catch (e: Exception) {
            // Universal Link fallback (opens web card or Play Store)
            val webIntent = Intent(
                Intent.ACTION_VIEW,
                Uri.parse("https://razego.adoliy.com/location?$query")
            ).apply {
                addFlags(Intent.FLAG_ACTIVITY_NEW_TASK)
            }
            context.startActivity(webIntent)
        }
    }
}

<!-- 1-Click Navigation Link for Single Destination -->
<a href="https://razego.adoliy.com/location?lat=33.3152&lng=44.3661&name=Baghdad%20Tower&navigate=1"
   target="_blank"
   rel="noopener noreferrer"
   class="raze-btn">
   Navigate with RazeGo
</a>

<!-- 2-Destination Delivery Route (Pickup -> Dropoff) for Food & Taxi Apps -->
<a href="https://razego.adoliy.com/location?lat=33.3152&lng=44.3661&name=Restaurant%20Pickup&lat2=33.3010&lng=44.3780&name2=Customer%20Dropoff&navigate=1"
   target="_blank"
   rel="noopener noreferrer"
   class="raze-btn">
   Start Delivery Route (2 Stops)
</a>

<!-- JavaScript Trigger Function -->
<script>
function navigateWithRaze(lat, lng, name = '', lat2 = null, lng2 = null, name2 = '') {
  const params = new URLSearchParams({
    lat: lat.toString(),
    lng: lng.toString(),
    ...(name ? { name } : {}),
    ...(lat2 != null && lng2 != null ? { lat2: lat2.toString(), lng2: lng2.toString(), ...(name2 ? { name2 } : {}) } : {}),
    navigate: '1'
  });
  window.open(`https://razego.adoliy.com/location?${params.toString()}`, '_blank', 'noopener,noreferrer');
}
</script>