MSA Scanner API Dokümantasyonu

API Nasıl Çalışır?

MSA Scanner API kullanabilmek için önce bir API key almanız gerekir. Başvurunuz onaylandıktan sonra size özel bir anahtar ile aşağıdaki endpoint’leri kullanabilirsiniz.

Temel Endpoint Yapısı

Adres → Koordinat

Bir şehir, adres veya konum bilgisini koordinata çevirmek için kullanılır.

Parametreler

• key : API anahtarınız
• q : Arama sorgusu

Örnek İstek

GET /api/geocode.php?key=YOUR_API_KEY&q=Istanbul

Örnek Cevap

{
  "success": true,
  "endpoint": "geocode",
  "provider": "msascanner-geocoder",
  "query": "Istanbul",
  "count": 2,
  "total_results": 2,
  "results": [
    {
      "formatted": "Istanbul, Turkey",
      "lat": 41.006381,
      "lng": 28.9758715,
      "country": "Turkey",
      "country_code": "tr",
      "state": "Istanbul",
      "city": "Istanbul",
      "postcode": "34122",
      "confidence": 3
    }
  ]
}

Koordinat → Adres

Latitude ve longitude bilgisine göre adres veya konum detayı döndürür.

Parametreler

• key : API anahtarınız
• lat : Enlem
• lon : Boylam

Örnek İstek

GET /api/reverse.php?key=YOUR_API_KEY&lat=40.1828&lon=29.0673

Örnek Cevap

{
  "success": true,
  "endpoint": "reverse",
  "provider": "msascanner-geocoder",
  "lat": "40.1828",
  "lon": "29.0673",
  "count": 1,
  "total_results": 1,
  "results": [
    {
      "formatted": "İnönü Caddesi, 16010 Osmangazi, Turkey",
      "lat": 40.1827361,
      "lng": 29.0672803,
      "country": "Turkey",
      "country_code": "tr",
      "state": "Bursa",
      "city": "Osmangazi",
      "district": "Hocaalizade Mahallesi",
      "suburb": "Kayıhan",
      "road": "İnönü Caddesi",
      "postcode": "16010",
      "confidence": 9
    }
  ]
}

JS API Kullanımı

fetch("https://msascanner.com/api/geocode.php?key=YOUR_API_KEY&q=Istanbul")
  .then(response => response.json())
  .then(data => console.log(data))
  .catch(error => console.error(error));

fetch("https://msascanner.com/api/reverse.php?key=YOUR_API_KEY&lat=40.1828&lon=29.0673")
  .then(response => response.json())
  .then(data => console.log(data))
  .catch(error => console.error(error));

Ayrı sayfa: documentation-of-js-api.php

PHP API Kullanımı

<?php
$url = "https://msascanner.com/api/geocode.php?key=YOUR_API_KEY&q=" . urlencode("Istanbul");
$response = file_get_contents($url);
$data = json_decode($response, true);

print_r($data);
?>

<?php
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://msascanner.com/api/reverse.php?key=YOUR_API_KEY&lat=40.1828&lon=29.0673");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$result = curl_exec($ch);
curl_close($ch);

echo $result;
?>

Ayrı sayfa: documentation-of-php-api.php

Olası Hata Cevapları

Kullanım Notları

• API key’inizi üçüncü kişilerle paylaşmayın.
• Tarayıcı tarafında kullanımda key görünür olabilir; mümkünse sunucu tarafında kullanın.
• Yoğun kullanım için günlük limitler uygulanabilir.
• Geocoding verileri OpenCage / OpenStreetMap kaynaklı olabilir.