# Ziyaretler ve konum

> Ziyaret listesi, ayrıntı sayfası, harita ve ekibin günü; Konumdayım ile varış, kayıtta çıkış konumu, firmaya uzaklık, ziyaret süresi — kipler, gizlilik, firma konumu.

**Ziyaretler** sayfası bütün görüşmeleri gün gün gösterir; her ziyaretin kendi ayrıntı sayfası vardır. Yöneticinin açtığı **ziyaret konumu** ile satışçı firmaya vardığında **Konumdayım** der, ziyareti kaydederken çıkış konumu eklenir — firmaya uzaklık ve ziyaret süresi kendiliğinden kaydedilir.

:::note
Konum yalnız iki anda alınır: **Konumdayım**'a basıldığında ve ziyaret kaydedildiğinde. Gün boyu takip, arka plan konumu ya da rota kaydı yoktur.
:::

## Ziyaretler sayfası {#list}

Soldaki menüden **Ziyaretler** (mobilde *Menü › Ziyaretler*). Üç sekme:

| Sekme | Ne gösterir |
|---|---|
| **Liste** | Gün gün ziyaretler: saat (ve süre), firma, tür · konu · kişi · satışçı, not → sonuç, sonraki adım, konum rozeti |
| **Harita** | Dönemin ziyaretleri haritada — renk konum durumunu gösterir; yandaki listeye tıklayınca haritada açılır |
| **Ekibin günü** | Yalnız yönetici — satışçı başına günün durakları, mini harita, ilk–son saat, sahada süre, yol |

Süzgeçler: **Benim / Ekip**, dönem (bugün, bu hafta, bu ay, son 30 / 90 gün, tümü), tür, satışçı, arama (firma, not, sonuç), **Aksiyon bekleyen**, **Konumsuz** (yerinde ziyaretlerden konum bırakılmayanlar) ve **Firmadan uzak**. Üstteki özet ziyaret sayısını, yüz yüze oranını, konumlu ve firmada yapılan ziyaret oranını gösterir. **Excel** süzgeçteki ziyaretleri konum sütunlarıyla indirir.

## Ziyaret ayrıntısı {#detail}

Bir satıra tıklayınca açılır: görüşme notu ve sonuç, fırsat / ürün / hat, **sonraki adım** (aksiyon kartına gider), **Konum** kartı ve firmanın önceki ziyaretleri. **Düzenle** ve **Sil** buradadır; Kayıt ID bağlantıları da bu sayfaya gelir.

## Ziyaret konumu {#location}

**Ayarlar → Ziyaret ve konum** (yönetici):

| Kip | Davranış |
|---|---|
| **Kapalı** | Konum alınmaz; Konumdayım görünmez |
| **İsteğe bağlı** (varsayılan) | Satışçı Konumdayım diyebilir; kayıtta izin verilmişse konum eklenir; konumsuz kayıt da olur |
| **Yüz yüze ziyarette zorunlu** | Yerinde yapılan ziyaret konumsuz kaydedilmez — konum alınamazsa satışçı nedenini seçer |

**Firmada sayılma yarıçapı** (100 m – 2 km, varsayılan 300 m): giriş noktası firma konumuna bu mesafe içindeyse ziyaret **Firmada**, dışındaysa **Firmadan uzakta** sayılır. Büyük fabrika sahalarında 500 m – 1 km seçin.

Konum yalnız **Yüz yüze** ve **Deneme** ziyaretlerinde ve **bugünün tarihiyle** girilen kayıtta işlenir. Telefon, online görüşme ve geçmiş tarihli girişte alınmaz.

### Konumdayım {#checkin}

:::steps
### Firmaya varınca
Web'de **Ziyaretler** sayfasındaki ya da firma kartındaki **Konumdayım**; mobilde firma kartında, **Bugün**'de ya da Ziyaretler'de. Tarayıcı / telefon konum izni ister.

### Firmayı seçin
Firma kartından açıldıysa doğrudan o firma. Değilse yakındaki firmalar (konumu bilinen, uzaklığa göre — yarıçap içindekiler *burada*) ve son ziyaret ettikleriniz listelenir; arayarak da seçebilirsiniz.

### Sonuç
*Firmadasınız (40 m)*, *Firmadan 1,2 km uzaktasınız*, *Firma adresinden 70 km uzaktasınız* (firmanın konumu kayıtlı değilse — [adrese göre](#address)) ya da *Firma konumu kaydedildi*. Sayfaların üstünde ince bir şerit kalır (firma · geçen süre · durum): **Kaydet** Hızlı Giriş'i firma seçili açar, **⋯ › Girişi iptal et** girişi siler.
:::

Açık giriş 12 saatte düşer. Başka firmaya Konumdayım denirse önceki giriş *ayrıldı* olur.

### Çıkış ve süre {#checkout}

Ziyaret [Hızlı Giriş](/guides/quick-entry)'ten ya da firma kartındaki ziyaret formundan kaydedilirken o anki konum **çıkış** olur. Formda (mobilde de) **Konum** kartı görünür: açık giriş varsa *Giriş 10:42 · Firmada*, yoksa konum alınınca firmaya **canlı uzaklık** — *Firmadasınız · 40 m*, *Firmadan 8,5 km uzaktasınız*, *Firma adresinden 70 km uzaktasınız* ya da *Firma adresiyle uyumlu*. İzin önceden verilmişse konum forma dokununca sessizce alınır; verilmemişse **Konum ekle** ile sorulur — sayfa açılır açılmaz izin istenmez. Açık giriş varsa giriş saati ondan gelir ve **süre** = kayıt anı − giriş. Konumdayım denmediyse kayıttaki konum hem giriş hem çıkış olur; süre boş kalır.

### Zorunlu kipte konum alınamazsa {#reasons}

Satışçı nedenini seçer: *Konum izni verilmedi* · *Konum alınamadı (kapalı alan / GPS yok)* · *Görüşme firmada değil, başka yerde yapıldı* · *Diğer*. Ziyaret **Konumsuz** olarak, nedeniyle kaydedilir; yönetici bunları **Konumsuz** süzgeciyle görür. [Claude bağlayıcısı](/mcp/overview) ile girilen ziyaretler engellenmez, *Claude üzerinden girildi* notuyla konumsuz kaydedilir.

### Konum izni {#permission}

Konum alınamazsa form nedenini ve nasıl açılacağını yazar:

| Ne yazıyor | Ne yapılır |
|---|---|
| *Bu site için konum engellenmiş* | Adres çubuğunun solundaki site ayarları simgesi › **Konum › İzin ver** (Safari: *Ayarlar › Web Siteleri › Konum*; iPhone Safari: *aA › Web Sitesi Ayarları › Konum*), sonra sayfayı yenileyin |
| *Site izni açık ama cihaz konum vermiyor* | Mac: **Sistem Ayarları › Gizlilik ve Güvenlik › Konum Servisleri** açık ve tarayıcı işaretli · Windows: **Ayarlar › Gizlilik ve güvenlik › Konum** — *Konum hizmetleri* ve *Masaüstü uygulamalarının konumunuza erişmesine izin ver* açık |
| *Konum izni verilmedi* | Yeniden deneyip tarayıcının sorusunda **İzin ver**'i seçin |
| Mobil uygulama: *Konum izni kapalı* | **Ayarlar** düğmesi → *Konum › Uygulamayı kullanırken* |

### Konum durumları {#status}

| Durum | Anlamı |
|---|---|
| **Firmada** | Giriş firma konumuna yarıçap içinde |
| **Firmadan uzakta** | Yarıçap dışında — uzaklık yazılır. Firmanın konumu yoksa *Firma adresinden … uzakta* (adrese göre) |
| **Firma konumu kaydedildi** | Firmanın konumu bilinmiyordu; bu ziyaretin konumu firma konumu oldu |
| **Konum belirsiz** | Doğruluk 1,5 km'den kötü ya da firma konumu bilinmiyor |
| **Konumsuz** | Konum bırakılmadı (neden yazılır) |

## Firma konumu {#firm}

Firma konumu iki yoldan gelir:

- **İlk konumlu ziyaret** — konumu bilinmeyen firmada doğruluğu ±250 m'den iyi ilk giriş firma konumu olur.
- **Firma kartı → ⋯ → Firma konumu** (yönetici ya da firmanın sorumlusu) — haritada tıklayın, işaretçiyi sürükleyin, **Şu anki konumumu kullan** ya da **Adresten bul** (adresten yaklaşık nokta; işaretçiyi firmanın girişine sürükleyip kaydedin). Pencere, konum yoksa haritayı firmanın adresine ortalar. Mobilde firma kartındaki *Firma konumu* satırı.

Ziyaret ayrıntısında *Firmadan uzakta* görünen ziyaret yanlış firma konumundan kaynaklanıyorsa **Firma konumunu bu ziyaretten kaydet**.

## Adrese göre uzaklık {#address}

Konumu kayıtlı olmayan firmada uzaklık, firmanın **adresinden** (adres + il) bulunan yaklaşık noktaya göre hesaplanır:

- Giriş adresten uzaksa *Firma adresinden … uzakta* yazılır ve bu giriş **firma konumu yapılmaz** — yanlış yerde yapılan ilk giriş artık firma konumu olmaz.
- Adresle uyumluysa ve doğruluk ±250 m'den iyiyse giriş firma konumu olur (adres yalnız yaklaşık olduğundan firma konumu yine girişten gelir).
- Adres sokak ya da ilçe düzeyinde bulunabildiği için pay geniştir: bina 100 m · cadde / sokak 1 km · mahalle 2 km · ilçe 8 km · il 60 km. Uzun caddelerde ve aynı adlı sokaklarda yanlış *uzakta* yazmak yerine kaçırmak yeğlenir.
- İli bilinmeyen adres sorulmaz (*Merkez*, *Atatürk Cad.* gibi adresler başka ile düşer). Adres bulunamazsa ya da adres yoksa eski kural geçerlidir.
- Sonuç firmada saklanır, adres değişince yeniden sorulur. Sağlayıcıyı [Harita ve adresten konum](#provider) belirler. Gönderilen yalnız firmanın adres ve il metnidir.

## Harita ve adresten konum {#provider}

**Ayarlar → Ziyaret ve konum → Harita ve adresten konum** (yönetici):

| Seçenek | Ne olur |
|---|---|
| **Otomatik** (varsayılan) | Solk'un Google Haritalar hesabı açıksa o, değilse OpenStreetMap |
| **Solk — Google Haritalar** | Adres Google'a Solk üzerinden sorulur (çoğu zaman bina düzeyinde), web haritaları Google Maps. Ek ücret yok |
| **Kendi Google anahtarınız** | Sorgular ve haritalar sizin Google Cloud hesabınızdan — **sunucu anahtarı** (Geocoding API, sunucu IP'siyle sınırlı) + **tarayıcı anahtarı** (Maps JavaScript API, `https://<firma>.solk.app/*` ile sınırlı). Ücreti Google size faturalar (her API'de ayda 10.000 ücretsiz) |
| **OpenStreetMap** | Ücretsiz, anahtar yok; Türkiye adreslerinde çoğu zaman mahalle / ilçe düzeyinde |

**Bağlantıyı dene** kayıtlı sağlayıcıyla bir deneme adresi sorar, **Haritayı dene** haritayı sayfada açar (Google anahtarı bu adreste çalışmıyorsa söyler).

:::note
Google'ın koşulları gereği Google'dan gelen adres noktası yalnız Google haritasında gösterilir — bu yüzden Google seçiliyken web haritaları da Google Maps olur. Koordinat en çok 30 gün saklanır, sonra Google'ın yer kimliğiyle tazelenir. Firma konumu penceresinde *Adresten bul* adresi haritada gösterir; firma konumu, girişe tıkladığınız noktadır.
:::

Google'a ulaşılamazsa ya da Solk'un aylık sorgu sınırı dolarsa o sorgu OpenStreetMap'le yapılır.

## Gizlilik {#privacy}

- Koordinat, uzaklık, giriş / çıkış saati ve süre yalnız **ziyareti girene ve yöneticilere** görünür. Ekip arkadaşları ziyareti görür, konumunu görmez; haritada ziyaret firma konumunda gösterilir.
- Konum yalnız Konumdayım ve kayıt anında, cihazın *uygulamayı kullanırken* izniyle alınır.
- Mobil uygulama arka plan konumu istemez.
- Firmanın adresi (kişisel veri değil) koordinata çevrilmek için konum sağlayıcısına gönderilir.

## API {#api}

[Ziyaretler](/rest-api/activities/visits), [Ziyaret](/rest-api/activities/visit), [Açık giriş](/rest-api/activities/checkin-state), [Konumdayım](/rest-api/activities/checkin), [Girişi iptal et](/rest-api/activities/checkin-cancel), [Yakındaki firmalar](/rest-api/activities/nearby), [Firmaya uzaklığın dayanağı](/rest-api/activities/firm-geo), [Ekibin günü](/rest-api/activities/team-day), [Firma konumu](/rest-api/companies/geo). [Görüşme kaydet](/rest-api/activities/log) ve [Hızlı Giriş 2.0](/rest-api/quickentry/qe-submit) `geo_lat`, `geo_lng`, `geo_acc` ya da `geo_note` alır; zorunlu kipte konumsuz kayıt `400 geo_required` döner. Girişte ve ziyaret `geo`'sunda `base` (`firm` · `addr`). `/me` → `caps.visits2`, `caps.geo`, `geo66` (`set_acc`, `low_acc`, `firm_geo`).