Findme

FindMe is a tool that allows obtaining a client's geolocation (GPS coordinates) through a URL link sent to them. When the client accesses the link and grants permission to use their location, their device's GPS retrieves the coordinates and sends them back to the system. This process enables to accurately determine a client's real-time location.

To obtain a client's geolocation using the FindMe tool, follow these three steps:

Send a request to FindMe to initiate the client's viability process.
Share the FindMe link with the client.
The client confirms their location, and the viability request receives a response with the client's coordinates. Here is the breakthroug of that pass:

Step-by-step process

1. Initiate a FindMe viability process

To start the FindMe viability process, send a request to the FindMe "viability" route, passing a unique parameter (such as a client phone number, ID, code, or any other unique identifier) as a parameter. This parameter will be used throughout the process.

Example request:

curl --location 'https://findme.ozmap.com.br/viability/example'

Once this request is sent, a connection will be established and remain open for 3 minutes, awaiting the client's response. If the client does not access the FindMe link and send their location within this period, the connection will automatically close, requiring a new request to be sent.

2. Send the FindMe link to the client

After initiating the viability process and opening the FindMe connection for the client (e.g., "example"), share the following URL with them so they can access it:

https://findme.ozmap.com.br/?id=example

The URL displays an interactive map showing the client's current location. The client can either accept this default position or manually select a different location by clicking anywhere on the map. Once satisfied with their selection, the client can press the "SEND" button to transmit the chosen coordinates to the system.

After submission, the client will receive a confirmation message indicating that their location has been successfully sent.

3. Client confirms location

Once the client confirms their location, the initial viability request made to the FindMe route will return a response containing the client's coordinates.

Example response:

{
  "message": "Localização do cliente foi definida",
  "code": "example",
  "coords": [
    -5.472353201,
    -41.05608975
  ]
}

This response contains the coordinates of the client's confirmed location.

Integrações