📍 Base URL
https://sehiranaliz.com/complete_real_data_integration.php
Tüm API istekleri bu base URL üzerinden gerçekleştirilir. API JSON formatında yanıt döner ve UTF-8 karakter encoding destekler.
🎯 API Endpoints
GET Sistem Durumu
GET /complete_real_data_integration.php?endpoint=status
Sistem durumu ve veri kaynaklarının bilgilerini getirir.
Parametreler:
endpoint (string): "status" - Zorunlu
Örnek İstek:
curl -X GET "https://sehiranaliz.com/complete_real_data_integration.php?endpoint=status"
Örnek Yanıt:
{
"success": true,
"system_status": "OPERATIONAL",
"data_sources": {
"tuik_api": "ACTIVE - Real government building permit data",
"geojson_api": "ACTIVE - Real demographic and infrastructure data"
},
"data_coverage": {
"building_permits": "51,480+ TÜİK records (2014-2024)",
"demographics": "1,425 neighborhoods, 5.8M population"
}
}
GET Kapsamlı Analiz
GET /complete_real_data_integration.php?endpoint=comprehensive-analyze
Belirtilen koordinat için TÜİK + GeoJSON verilerinin entegre analizini gerçekleştirir.
Parametreler:
endpoint (string): "comprehensive-analyze" - Zorunlu
lat (float): Enlem koordinatı (varsayılan: 39.9334)
lon (float): Boylam koordinatı (varsayılan: 32.8597)
year (int): Analiz yılı (varsayılan: 2021)
Örnek İstek:
curl -X GET "https://sehiranaliz.com/complete_real_data_integration.php?endpoint=comprehensive-analyze&lat=39.9334&lon=32.8597&year=2021"
Örnek Yanıt:
{
"success": true,
"data": {
"location": {
"latitude": 39.9334,
"longitude": 32.8597,
"analysis_year": 2021
},
"comprehensive_analysis": {
"urban_intelligence_score": 78.5,
"infrastructure_score": 82.1,
"development_potential": 74.3,
"building_permits_analysis": {
"turkey_total_buildings": 156789,
"ankara_buildings": 5609,
"ankara_share_percent": 3.58
},
"investment_analysis": {
"recommendation": "BUY - Good investment potential with moderate risk"
}
}
}
}
GET TÜİK Veri
GET /complete_real_data_integration.php?endpoint=tuik-data
Belirtilen bölge ve yıl için TÜİK yapı ruhsat verilerini getirir.
Parametreler:
endpoint (string): "tuik-data" - Zorunlu
region (string): Bölge kodu (TR, TR51) (varsayılan: "TR")
year (int): Analiz yılı (varsayılan: 2021)
Örnek İstek:
curl -X GET "https://sehiranaliz.com/complete_real_data_integration.php?endpoint=tuik-data®ion=TR51&year=2021"
GET GeoJSON Veri
GET /complete_real_data_integration.php?endpoint=geojson-data
Belirtilen koordinat için demografik ve altyapı verilerini getirir.
Parametreler:
endpoint (string): "geojson-data" - Zorunlu
lat (float): Enlem koordinatı (varsayılan: 39.9334)
lon (float): Boylam koordinatı (varsayılan: 32.8597)
Örnek İstek:
curl -X GET "https://sehiranaliz.com/complete_real_data_integration.php?endpoint=geojson-data&lat=39.9334&lon=32.8597"
💻 Entegrasyon Örnekleri
JavaScript (Frontend)
// Kapsamlı analiz örneği
async function getUrbanAnalysis(lat, lon, year = 2021) {
const response = await fetch(
`https://sehiranaliz.com/complete_real_data_integration.php?endpoint=comprehensive-analyze&lat=${lat}&lon=${lon}&year=${year}`
);
const data = await response.json();
return data;
}
// Kullanım
getUrbanAnalysis(39.9334, 32.8597, 2021)
.then(data => {
console.log('Urban Intelligence Score:', data.data.comprehensive_analysis.urban_intelligence_score);
console.log('Investment Recommendation:', data.data.comprehensive_analysis.investment_analysis.recommendation);
});
Python
import requests
def get_urban_analysis(lat, lon, year=2021):
url = f"https://sehiranaliz.com/complete_real_data_integration.php"
params = {
'endpoint': 'comprehensive-analyze',
'lat': lat,
'lon': lon,
'year': year
}
response = requests.get(url, params=params)
return response.json()
# Kullanım
data = get_urban_analysis(39.9334, 32.8597, 2021)
print(f"Urban Intelligence Score: {data['data']['comprehensive_analysis']['urban_intelligence_score']}")
PHP
function getUrbanAnalysis($lat, $lon, $year = 2021) {
$url = "https://sehiranaliz.com/complete_real_data_integration.php?" . http_build_query([
'endpoint' => 'comprehensive-analyze',
'lat' => $lat,
'lon' => $lon,
'year' => $year
]);
$data = file_get_contents($url);
return json_decode($data, true);
}
// Kullanım
$analysis = getUrbanAnalysis(39.9334, 32.8597, 2021);
echo "Urban Intelligence Score: " . $analysis['data']['comprehensive_analysis']['urban_intelligence_score'];
⚠️ Hata Yönetimi
API hataları aşağıdaki formatta JSON yanıtı döner:
{
"success": false,
"error": "Hata açıklaması",
"error_code": "ERROR_CODE"
}
Yaygın Hata Kodları:
INVALID_ENDPOINT: Geçersiz endpoint parametresi
INVALID_COORDINATES: Geçersiz koordinat değerleri
DATA_NOT_FOUND: Belirtilen parametreler için veri bulunamadı
RATE_LIMIT_EXCEEDED: Rate limit aşıldı