Privacy Policy

1. Introduction

This Privacy Policy describes how we collect, use, and protect your personal information when you use our chatbot, which interacts with the Gemini AI API and stores your questions in our database.

2. Information Collected

When using our chatbot, we collect the following types of information:

  • Conversation Information: All messages you send and receive through the chatbot.
  • Identification Data: We may collect data such as IP address and geographic location information.

3. Use of Information

The information collected is used for the following purposes:

  • Interaction with the AI API: Your messages are sent to the Gemini API to generate appropriate responses.
  • Question Storage: Your questions are stored in our database for analysis and service improvement purposes.

4. Information Sharing

We do not share your personal information with third parties, except in the following cases:

  • Service Providers: We may share information with vendors who help us operate our service, such as the Gemini API.
  • Legal Compliance: We may disclose information to comply with legal obligations or respond to legal processes.

5. Information Security

We implement appropriate security measures to protect your information from unauthorized access, alteration, disclosure, or destruction. These measures include:

  • Encryption: Use of encryption to protect data in transit.
  • Restricted Access: Access to information is limited to employees and partners who need this information to operate our service.

6. Your Rights

You have the right to:

  • Access and Correct: Request access to your personal information and correct inaccurate data.
  • Delete Data: Request the deletion of your personal information, subject to certain conditions.
  • Withdraw Consent: Withdraw your consent to the processing of your personal information.

7. Changes to the Privacy Policy

We reserve the right to update this Privacy Policy at any time. We will notify you of any significant changes through our website or other appropriate communication channels.

8. Contact

If you have any questions about this Privacy Policy, please contact us at [email protected]

9. Consent

By using our service, you agree to the collection and use of your information as described in this Privacy Policy.

This Privacy Policy has been created to ensure that your personal information is treated with security and respect. We appreciate your trust and are committed to protecting your privacy.

Geocode

Suggestions API

The complete response can be checked below: The purpose of this third endpoint, Suggestions, is to return the geographic coordinates from an address provided in the URL itself.

To make the request to Suggestions, it is necessary to send the request using the GET method to the following endpoint:

All parameters to obtain the geographic coordinates and address suggestions will be sent in the URL itself.

Note: Currently returning only to directions located in Brazil.

The Suggestions API has been updated to V2. The endpoint https://api.maplink.global/geocode/v1/suggestions will still work, but it is recommended to use the new endpoint for more accurate results and because new features will be exclusive to the new version.

Parameter list

Mandatory parameter

  • q – Provide the address or part of it.

Optional parameters

  • center – Reference coordinates for the search results. Format: center=-23.552088765,-46.6341653162;
  • radius – Specifies the search radius, in meters, from the central point defined in center. If not entered, the default value is 500,000 meters (500 km);
  • limit – Limits the number of results returned.

Example 1 – Search for suggestions from free text

In this example, we want to get suggestions for the text "Alameda Campinas, 01404100, Jardim Paulista". The request is below:

https://api.maplink.global/geocode/v2/suggestions?q=Alameda%20Campinas,%2001404100,%20Jardim%20Paulista

Note: It is recommended to describe the address with the greatest amount of information, ordering the most important elements (Street, Number, Zip Code, District, City, State) and without abbreviations for greater assertiveness of results.

In the response, the following information is returned:

  • found – Number of records returned.
  • results – Array of objects with all the results found:
    • id – Address identifier provided in the request;
    • address – Object with address information:
      • road – Name of the road;
      • district – District;
      • zipCode – Zipcode;
      • city – City;
      • state – State;
      • mainLocation – Object with the geographic coordinates of the point:
        • lat – Latitude;
        • lon – Longitude;
    • type – Indicates the best element found in the cartographic database for returning the geographic coordinate;
    • score – Reference score of the result of the geocoding process;
    • label – Complete address found used in the geocoding process.

Note: The higher the score, the more relevant the result will be to the requested address.

The full response can be found below:

{
    "results": [
        {
            "id": "6684353bf0662a1541ff6385",
            "address": {
                "road": "ALAMEDA CAMPINAS",
                "district": "JARDIM PAULISTA",
                "zipCode": "01404100",
                "city": "SÃO PAULO",
                "state": {
                    "name": "SÃO PAULO",
                    "code": "SP"
                },
                "mainLocation": {
                    "lat": -23.56631144908,
                    "lon": -46.65360036597
                }
            },
            "type": "ROAD",
            "label": "ALAMEDA CAMPINAS, 01404100, JARDIM PAULISTA, SÃO PAULO, SP",
            "score": 85.4173641545432
        },
        {
            "id": "6684353bf0662a1541ff63a2",
            "address": {
                "road": "ALAMEDA CAMPINAS",
                "district": "JARDIM PAULISTA",
                "zipCode": "01404200",
                "city": "SÃO PAULO",
                "state": {
                    "name": "SÃO PAULO",
                    "code": "SP"
                },
                "mainLocation": {
                    "lat": -23.56714829171,
                    "lon": -46.65440337412
                }
            },
            "type": "ROAD",
            "label": "ALAMEDA CAMPINAS, 01404200, JARDIM PAULISTA, SÃO PAULO, SP",
            "score": 67.51744304384503
        },
        {
            "id": "6684353bf0662a1541ff635d",
            "address": {
                "road": "ALAMEDA CAMPINAS",
                "district": "JARDIM PAULISTA",
                "zipCode": "01404000",
                "city": "SÃO PAULO",
                "state": {
                    "name": "SÃO PAULO",
                    "code": "SP"
                },
                "mainLocation": {
                    "lat": -23.5663551335,
                    "lon": -46.65364273168
                }
            },
            "type": "ROAD",
            "label": "ALAMEDA CAMPINAS, 01404000, JARDIM PAULISTA, SÃO PAULO, SP",
            "score": 67.51744304384503
        },
        {
            "id": "6684353bf0662a1541ff63a3",
            "address": {
                "road": "ALAMEDA CAMPINAS 150",
                "district": "JARDIM PAULISTA",
                "zipCode": "01404900",
                "city": "SÃO PAULO",
                "state": {
                    "name": "SÃO PAULO",
                    "code": "SP"
                },
                "mainLocation": {
                    "lat": -23.56343039334,
                    "lon": -46.6507807755
                }
            },
            "type": "ROAD",
            "label": "ALAMEDA CAMPINAS 150, 01404900, JARDIM PAULISTA, SÃO PAULO, SP",
            "score": 63.98775935173035
        },
        {
            "id": "6684353bf0662a1541ff637b",
            "address": {
                "road": "ALAMEDA CAMPINAS",
                "district": "JARDIM PAULISTA",
                "zipCode": "01404001",
                "city": "SÃO PAULO",
                "state": {
                    "name": "SÃO PAULO",
                    "code": "SP"
                },
                "mainLocation": {
                    "lat": -23.56880844109,
                    "lon": -46.65604091167
                }
            },
            "type": "ROAD",
            "label": "ALAMEDA CAMPINAS, 01404001, JARDIM PAULISTA, SÃO PAULO, SP",
            "score": 62.547320382935666
        },
        {
            "id": "6684353bf0662a1541ff63b9",
            "address": {
                "road": "ALAMEDA CAMPINAS",
                "district": "JARDIM PAULISTA",
                "zipCode": "01404002",
                "city": "SÃO PAULO",
                "state": {
                    "name": "SÃO PAULO",
                    "code": "SP"
                },
                "mainLocation": {
                    "lat": -23.57150846699,
                    "lon": -46.65863824537
                }
            },
            "type": "ROAD",
            "label": "ALAMEDA CAMPINAS, 01404002, JARDIM PAULISTA, SÃO PAULO, SP",
            "score": 62.36442055021014
        },
        {
            "id": "6684353bf0662a1541ff637c",
            "address": {
                "road": "ALAMEDA CAMPINAS",
                "district": "JARDIM PAULISTA",
                "zipCode": "01404003",
                "city": "SÃO PAULO",
                "state": {
                    "name": "SÃO PAULO",
                    "code": "SP"
                },
                "mainLocation": {
                    "lat": -23.5727482959,
                    "lon": -46.65984093151
                }
            },
            "type": "ROAD",
            "label": "ALAMEDA CAMPINAS, 01404003, JARDIM PAULISTA, SÃO PAULO, SP",
            "score": 62.36442055021014
        },
        {
            "id": "66842f7b6969121fb9f0de4e",
            "address": {
                "road": "ALAMEDA CAMPINAS",
                "district": "JARDIM PAULISTA",
                "zipCode": "12947480",
                "city": "ATIBAIA",
                "state": {
                    "name": "SÃO PAULO",
                    "code": "SP"
                },
                "mainLocation": {
                    "lat": -23.141018593,
                    "lon": -46.557696254
                }
            },
            "type": "ROAD",
            "label": "ALAMEDA CAMPINAS, 12947480, JARDIM PAULISTA, ATIBAIA, SP",
            "score": 60.32122203281947
        },
        {
            "id": "6684353bf0662a1541ff6359",
            "address": {
                "road": "ALAMEDA CAMPINAS, 433",
                "district": "JARDIM PAULISTA",
                "zipCode": "01404901",
                "city": "SÃO PAULO",
                "state": {
                    "name": "SÃO PAULO",
                    "code": "SP"
                },
                "mainLocation": {
                    "lat": -23.56550964281,
                    "lon": -46.65281726051
                }
            },
            "type": "ROAD",
            "label": "ALAMEDA CAMPINAS, 433, 01404901, JARDIM PAULISTA, SÃO PAULO, SP",
            "score": 58.74167782919748
        },
        {
            "id": "6684343ef0662a1541f5003c",
            "address": {
                "road": "ALAMEDA SARUTAIÁ",
                "district": "JARDIM PAULISTA",
                "zipCode": "01403010",
                "city": "SÃO PAULO",
                "state": {
                    "name": "SÃO PAULO",
                    "code": "SP"
                },
                "mainLocation": {
                    "lat": -23.5689407,
                    "lon": -46.6549067
                }
            },
            "type": "ROAD",
            "label": "ALAMEDA SARUTAIÁ, 01403010, JARDIM PAULISTA, SÃO PAULO, SP",
            "score": 55.39309246199472
        }
    ],
    "found": 10
}