Coğrafi çitler
Coğrafi çitler araç özelliklerine, erişim koşullarına ve arazi özelliklerine göre planlama sırasında kısıtlamalar atamanıza olanak tanır. Bununla ilgili daha fazla bilgiye Araç bölümünde göz atabilirsiniz.
Siparişler dağıtılırken hem atanan genel seçenek hem bireysel kuryeler için tanımlanan coğrafi bölgelerin uygunsuzluğu dikkate alınır. Ayrıca planlama sırasında coğrafi bölgeler ile ilgili tüm sınırlamalar iptal edilebilir.
Arayüzdeki coğrafi bölgeler
Coğrafi çitler ile Planlama arayüzünü ve bir Excel dosyasını kullanarak çalışabilirsiniz:
- Coğrafi çitler Rehberler → Coğrafi çitler bölümünden belirleyin (daha fazla bilgi için bkz. Coğrafi çitler dizini).
- Bir Excel dosyası seçin ve arayüze yükleyin.
- Optimizasyon ayarlarını belirlerken Ayarlar sekmesinden Coğrafi çitleri dikkate al → Evet’i seçin.
Planlama sırasında siparişler otomatik olarak koordinatlara göre ilgili bölgelere atanacaktır.
API’deki coğrafi bölgeler
API’de coğrafi bölgeler ile aşağıdaki şekillerde çalışabilirsiniz:
- API yöntemleri yardımıyla.
- Dizindeki coğrafi bölgelernı kullanarak.
- Planlama görevinde coğrafi bölgeleri koordinatlar yardımıyla atayarak.
Coğrafi çitler ile çalışma için API yöntemleri
Şu durumlarda API yöntemleri kullanılması fayda sağlar:
- harici bir hizmette bölge oluşturuyor ve düzenliyor; coğrafi bölgeler oluşturma, değiştirme ve silme yöntemlerini kullanarak RouteQ’deki coğrafi bölgeler dizinini güncelliyor ve ardından bu dizini planlamada kullanıyorsanız;
- coğrafi bölgeleri RouteQ arayüzünde oluşturuyor ve düzenliyor, ardından bunları Şirket bölgesini al veya Şirket bölgeleri dizinini al yöntemlerini kullanarak kendi kurumsal sisteminize yüklüyorsanız.
Dizinden coğrafi bölgeler kullanma
Arayüz aracılığıyla dizinle çalışma prosedürü Coğrafi çitler dizini ile çalışma bölümünde ayrıntılı olarak açıklanmaktadır.
Dizindeki coğrafi bölgeleri kullanmak için kaynağa (yetkilendirme ile mvrp) bir istek gönderin:
curl -H "Content-Type: application/json" -H "Authorization: OAuth belirteciniz" -X POST -d <istek metni> https://courier.yandex.ru/api/v1/vrs/add/mvrp
Authorization: OAuth belirteciniz
başlı altında belirteciniz
yerine, Takip ile çalışmak için alınan OAuth-belirteciniz ögesini belirtin.
Uyarı
Yetkilendirme isteğindeki yol (OAuth belirteçli), spesifikasyonda belirtilen yoldan (API anahtarlı) farklıdır.
Koordinat yardımıyla coğrafi bölge açıklama
Coğrafi çitler koordinatlarını doğrudan planlama görevinden atamak için istekte bir zones
objesi oluşturun. Bu objenin her elemanı bir bölgeyi tanımlar ve poligonun köşelerinin koordinatlarını içerir.
Koordinatları elde etmek için Yandex Harita Sihirbazı araçlarını kullanın:
-
Bölgeyi Poligon aracının yardımıyla çizin (daha fazla bilgi için bkz. Harita Sihirbazı Yardım bölümündeki Obje oluşturma açıklamaları).
-
Kaydet ve devam et → Dışa aktar seçeneğine tıklayın (daha fazla bilgi için bkz. Harita Sihirbazı Yardım bölümündeki Harita objelerini dışa aktarma açıklamaları).
-
GeoJSON → İndir’i seçin.
-
zones
objesini oluşturma isteğindegeometry
objesini kullanın.İstekte coğrafi bölgeleri tanımlama örneği
"zones": [ { "id": "zone1", "geometry": { "type": "Polygon", "coordinates": [ [ [ 37.3890158054755, 55.8142956464218 ], [ 37.4755331394599, 55.7415407888477 ], [ 37.5716635105537, 55.7984405246533 ], [ 37.5847097752021, 55.799987651288 ], [ 37.3890158054755, 55.8142956464218 ] ] ] } } ]
Koordinat yardımıyla coğrafi bölge açıklama özelliğini kullanmak için kaynağa (mvrp) bir istek gönderin:
curl -H "Content-Type: application/json" -X POST -d <istek metni> https://courier.yandex.ru/vrs/api/v1/add/mvrp?apikey=<API anahtarı>