Coğrafi Kontrol Noktaları (Geo Checkpoints)

Gişeler, sınır kapıları ve vinyet kontrol noktaları gibi coğrafi kontrol noktalarını sorgulayın. Kontrol noktaları, o konum için satılan vinyet biletleriyle ilişkilendirilebilir; böylece bir müşteri güzergâh planlarken doğru ürünü önüne çıkarabilirsiniz.

Kontrol Noktalarını Listele

text

GET /products/geo/checkpoints

Yalnızca API anahtarı gerekir, imza gerekmez.

Sorgu Parametreleri (Query Parameters)

Ad	Tür	Zorunlu	Açıklama
`country`	string	Hayır	İki harfli ülke ISO kodu (ör. `SI`)
`type`	string	Hayır	Kontrol noktası tipi ayırt edici değeri
`minLat`	number	Hayır	Sınırlayıcı kutu: minimum enlem
`maxLat`	number	Hayır	Sınırlayıcı kutu: maksimum enlem
`minLng`	number	Hayır	Sınırlayıcı kutu: minimum boylam
`maxLng`	number	Hayır	Sınırlayıcı kutu: maksimum boylam
`lang`	string	Hayır	Yerelleştirilmiş metinler için dil kodu
`page`	integer	Hayır	Sayfa numarası (varsayılan: 1)
`limit`	integer	Hayır	Sayfa başına öğe sayısı (varsayılan: 50)

Örnek İstek (Example Request)

GET/v2/partners/products/geo/checkpoints

curl "https://api.vignetim.com/v2/partners/products/geo/checkpoints" \
  -H "X-API-Key: $VIGNETIM_API_KEY"

Yanıt

json

{
	"data": [
		{
			"id": "9a8b7c6d-5e4f-3210-fedc-ba0987654321",
			"countryIsocode": "SI",
			"type": "toll_gate",
			"latitude": 46.0569,
			"longitude": 14.5058,
			"title": {
				"en": "Ljubljana Ring Toll Point",
				"sl": "Cestninska tocka Ljubljana"
			},
			"description": {
				"en": "Vignette required beyond this point."
			},
			"infoText": {
				"en": "Applies to all vehicles up to 3.5t."
			},
			"iconType": "toll",
			"color": "#E53935",
			"productType": "ticket",
			"sortOrder": 10,
			"ticketIds": ["a1b2c3d4-e5f6-7890-abcd-ef1234567890"]
		}
	],
	"metadata": {
		"total": 87,
		"page": 1,
		"limit": 50,
		"totalPages": 2,
		"environment": "LIVE"
	}
}

Kontrol Noktası Nesnesi

Alan	Tür	Açıklama
`id`	UUID	Kontrol noktası ID'si
`countryIsocode`	string	Kontrol noktasının bağlı olduğu ülke
`type`	string	Kontrol noktası tipi ayırt edici değeri (opsiyonel)
`latitude`	number	Enlem
`longitude`	number	Boylam
`title`	object	Dil koduna göre anahtarlanmış yerelleştirilmiş başlık eşlemesi
`description`	object	Yerelleştirilmiş açıklama eşlemesi
`infoText`	object	Yerelleştirilmiş bilgi metni eşlemesi (opsiyonel)
`iconType`	string	Harita gösterimi için ikon ipucu (opsiyonel)
`color`	string	Görüntüleme rengi (opsiyonel)
`productType`	string	İlişkili ürün tipi ipucu (opsiyonel)
`sortOrder`	integer	Önerilen görüntüleme sıralaması
`ticketIds`	string[]	Bu kontrol noktası için satılan vinyet biletlerinin ID'leri (opsiyonel)