Primii pași

Porniți cu Geo-Engine în doar câteva minute.

Condiții prealabile

Înainte de a începe, veți avea nevoie de:

1. Cheie API - Contactați managerul dvs de conturi Quarticle sau vizitați panoul dvs
2. Client HTTP - curl, Postman sau orice bibliotecă HTTP
3. Cunoștințe REST de bază - Familiaritate cu cererile HTTP și JSON

Pasul 1: Obținerea cheii API

1. Contactați managerul de conturi Quarticle sau conectați-vă la panoul Geo-Engine
2. Navigați la Setări → Chei API
3. Faceți clic pe Generare cheie nouă
4. Copiați și stocați cheia API în siguranță

Pasul 2: Efectuați prima cerere

Să geocodificăm o adresă folosind API-ul Qarta:

cURL

curl -X GET "https://graph.quarticle.ro/graph/api/v1/places/geocode?q=New%20York" \
  -H "Authorization: YOUR_API_KEY"

JavaScript

const response = await fetch(
  'https://graph.quarticle.ro/graph/api/v1/places/geocode?q=New%20York',
  {
    method: 'GET',
    headers: {
      'Authorization': 'YOUR_API_KEY'
    }
  }
);

const data = await response.json();
console.log(data);

Python

import requests

headers = {
    'Authorization': 'YOUR_API_KEY'
}

response = requests.get(
    'https://graph.quarticle.ro/graph/api/v1/places/geocode',
    params={'q': 'New York'},
    headers=headers
)

print(response.json())

Răspuns așteptat:

{
  "result": {
    "lat": 40.7128,
    "lon": -74.0060,
    "label": "New York, NY, USA",
    "placeId": "abc123",
    "geocodingQuality": "locality"
  }
}

Pasul 3: Explorați API-ul

• Prezentarea generală a API-ului Qarta - Explorați toate capacitățile disponibile
• Descărcați colecția Postman - Importați cereri pregătite
• Ghidul de pornire rapidă - Aprofundare în punctele finale Qarta

Pașii comuni următori

• Autentificare sigură - Consultați Ghidul de autentificare
• Gestionare erori - Aflați despre Răspunsurile de eroare
• Verificare limite de rată - Revizuiți Limitarea ratei

Depanare

401 Unauthorized

• Verificați dacă cheia API este corectă
• Verificați că cheia API nu a expirat
• Asigurați-vă că utilizați antetul Authorization cu cheia API direct (fără prefixul Bearer)

Erori CORS

• Erorile CORS în browser sunt un semn puternic că apelați API-ul cu cheia API expusă în cod pe partea clientului — aceasta este un risc de securitate. Cheia API trebuie utilizată doar pe server
• Direcționați cererile din browser printr-un proxy pe backend care atașează cheia: consultați ghidurile GeoServer Proxy sau Full API Proxy
• Pentru integrări server-to-server, utilizați cereri HTTP directe

Aveți nevoie de ajutor?

• Răsfoiți Ghiduri pentru cazuri de utilizare obișnuite
• Contactați suportul