Zorluk: Hindistan'daki adres kalitesini anlama
Hindistan'ın adres sistemi, çeşitliliği ve karmaşıklığıyla bilinir. Adresler çok açıklayıcı olabilir, standartlaştırılmamış olabilir, yerel simge yapıları içerebilir ve genellikle kesin posta kodları veya tutarlı bir bileşen sırası içermez. Bu durum, doğru konum verilerine dayanan kişiler, e-ticaret platformları, lojistik şirketleri ve hizmet sağlayıcılar için önemli zorluklar yaratır. Hindistan adresleriyle ilgili sık karşılaşılan sorunlar şunlardır:
- Eksik veya yanlış posta kodları: Posta ve paketlerin verimli bir şekilde yönlendirilmesi için gereklidir ancak sıklıkla yanlış veya eksiktir.
- Yazım hataları: Yerleşim yerlerinin, şehirlerin veya eyaletlerin adlarındaki yaygın hatalar yanlış yorumlamaya yol açabilir.
- Standart olmayan bileşen sırası: Adres öğelerinin (ör. bina numarası, sokak, yerleşim yeri, şehir) sırası büyük ölçüde değişebilir ve bu da otomatik işlemeyi zorlaştırır.
- Standartlaştırma eksikliği: Konuşma dilindeki terimler, kısaltmalar ve açıklayıcı referanslar (ör. "Eski tapınağın yakınında") yaygın olsa da standart sistemler tarafından anlaşılmaz.
- İlişki bilgilerinin eklenmesi: "S/o" (Son of), "D/o" (Daughter of) veya "C/o" (Care of) gibi terimler genellikle adrese yerleştirilerek konumla ilgili olmayan veriler eklenir.
- Alt tesis notasyonlarındaki varyasyonlar: Birim numaraları, bina numaraları veya arsa numaraları gibi bileşenler (ör. "2/1") gibi ifadeler "2/1", "2-1", "2 by 1" veya "No 2, 1st part" gibi birçok şekilde yazıldığından tutarlı bir şekilde ayrıştırılması zordur.
- Alt tesis ayrıntılarının yaygınlığı: Özellikle şehirlerdeki birçok adres, son kilometre teslimatı için hayati önem taşıyan ancak genellikle yapılandırılmamış olan daire numaraları, kat numaraları veya bina kanadı ayrıntıları gibi önemli alt tesis bilgileri içerir.
- Belirsizlik: Adresler bazen birden fazla şekilde yorumlanabilir ve bu da tam noktanın bulunmasında belirsizliğe yol açar.
Bu zorluklar; teslimat hatalarına, operasyonel maliyetlerin artmasına, kötü müşteri deneyimlerine ve veri analizi ile hizmet planlamasında zorluklara yol açabilir. Adres kalitesiyle ilgili hızlı ve uygulanabilir geri bildirimler almanın açık bir ihtiyacı var.
Çözüm: Yapay zeka destekli adres geri bildirimi
Bu zorlukları gidermek için üretken yapay zekayı kullanan bir çözüm sunuyoruz.
Bu sistem, Hindistan'daki kullanıcılara adresleriyle ilgili değerli geri bildirimler sunmak, olası sorunları anlamalarına ve daha iyi coğrafi kodlama sonuçları ve genel doğruluk için adreslerini nasıl daha iyi biçimlendireceklerine yardımcı olmak üzere tasarlanmıştır.
Temel amaç, Vertex AI'da Gemini modellerini kullanarak şunları yapmaktır:
- Karmaşık ve genellikle hatalı olan Hindistan adreslerini analiz edip yorumlayın.
- Sık karşılaşılan hataları ve tutarsızlıkları belirleyin.
- Standartlaştırılmış ve düzeltilmiş sürümler önerin.
- Yapılan değişikliklerle ilgili net açıklamalar sunun.
Sistem iki biçim faktöründe sunulur: - REST API - Web kullanıcı arayüzü
Hindistan'daki müşteriler bu aracı nasıl kullanabilir?
Asıl amaç adres kalitesi hakkında geri bildirim sağlamak olsa da bu geri bildirimlerin faydaları daha kapsamlıdır:
- Daha iyi teslimat: İşletmeler için adreslerin nasıl daha iyi yapılandırılacağını anlamak, başarısız teslimat girişimlerinin sayısını azaltabilir, operasyonel maliyetleri düşürebilir ve müşteri memnuniyetini artırabilir. Kişiler, iyi biçimlendirilmiş adresler kullanarak paketlerini ve postalarını daha güvenilir bir şekilde alabilir.
- Veri zenginleştirme: Şirketler, bu araçtan elde edilen analizleri (veya temel API'yi entegre ederek) mevcut müşteri adresi veritabanlarının temizlenmesi ve standartlaştırılması konusunda yol gösterici olarak kullanabilir. Bu sayede daha iyi analizler ve hedefli hizmetler sunulabilir.
- Görsel doğrulama: Çift raptiyeli harita gösterimi özellikle değerlidir. Kullanıcılar, orijinal ve düzeltilmiş adreslerin aynı konumu mu yoksa farklı konumları mı işaret ettiğini görsel olarak doğrulayabilir. Bu, "temizlenmiş" sürümün amaçlanan konumu doğru şekilde yansıtıp yansıtmadığını veya orijinal girişin doğru coğrafi kodlama için çok muğlak ya da hatalı olup olmadığını belirlemeye yardımcı olur.
Kullanıcılar, sağlanan geri bildirimler aracılığıyla adreslerindeki belirli sorunları anlayarak düzeltici işlem yapabilir, kayıtlarını güncelleyebilir ve konumlarını daha etkili bir şekilde iletebilir.
Bu uygulama nedir?
Bu web uygulaması, yapay zeka destekli adres geri bildirimi sistemine yönelik bir arayüz görevi görür. Bu araç, özellikle Hindistan adreslerinin nüanslarına odaklanarak kullanıcıların ve işletmelerin fiziksel adresleri doğrulamasına, anlamasına ve iyileştirmesine yardımcı olmak için tasarlanmıştır. Uygulama, kullanıcıların aşağıdakileri yapabileceği kullanıcı dostu bir arayüz sunar:
- Adres girme: Doğrudan yazarak veya toplu işleme için birden fazla adresi yapıştırarak.
- Temizlenmiş bir adres alma: Uygulama, girişi işler ve yapay zeka modelinin anlayışına dayalı olarak standartlaştırılmış, düzeltilmiş bir sürüm sağlar.
- Değişiklikleri anlama: Orijinal adreste yapılan belirli değişiklikleri vurgulayarak geri bildirim sürecinde şeffaflık sağlar.
- Farklılıkları görselleştirme: Hem orijinal hem de temizlenmiş adresler etkileşimli bir haritaya sabitlenir. Böylece kullanıcılar konumlarını görsel olarak karşılaştırabilir ve olası tutarsızlıkları bir bakışta belirleyebilir.
- Ayrıntılı bileşenler elde edin: Coğrafi kodlu (temizlenmiş) adres, yapılandırılmış bir görünüm sağlamak için bileşenlerine (ör. sokak numarası, yerleşim yeri, şehir, posta kodu) ayrılır.
Bu uygulama, özellikle adres kalitesini hızlı bir şekilde değerlendirmek, olası sorunları anlamak ve adreslerin standartlaştırılmış biçimlere dayanan sistemler için nasıl daha iyi yapılandırılacağını görmek açısından yararlıdır.
Arka Uç Mimarisi: Gemini ve Vertex AI tarafından desteklenir
Bu uygulamanın adresleri anlama ve iyileştirme yeteneğinin arkasındaki zeka, Google Cloud'un gelişmiş yapay zeka teknolojilerinden kaynaklanmaktadır:
- **Temel adres işleme: ** Adres dizelerini ayrıştırma, anlama, düzeltme ve standartlaştırma gibi temel görevler Google'ın Gemini 2.5 Flash modeli tarafından gerçekleştirilir. Bir adres gönderildiğinde
:
- Ön uç uygulaması, giriş adresini bir arka uç hizmetine gönderir.
- Bu arka uç hizmeti, Gemini API'den yararlanır. Gemini 2.5 Flash modeli, doğru ve standartlaştırılmış işlemeyi doğrulamak için ayrıntılı bir istemle yönlendirilir. Modele verilen temel talimatlar şunlardır:
You are an address cleaning expert. Your task is to take malformed addresses
and output cleaned and standardized versions. All addresses will be from India.
BEGIN:
Follow these instructions:
Remove any mention of "House Number," "H.No," "Door Number," "D.No,"
"Building No", "Flat No." etc. along with the number it's associated with
Remove any "C/O," "S/O," etc.
DO NOT REMOVE any name of building
It should also remove any name of person or actual house numbers etc which
appear after the texts mentioned in the previous point
Ensure there are no duplicate mentions of town names, state names, etc.
If no valid zip code is available, add an error in the Errors field:
"No valid zip code found. Please verify."
Remove mention of any Floors in the address
If there are any mention of "Near or landmark" put that in a new field called
"address_descriptors"
Expand any rd, ln, st and similar other abbreviations to road, lane, street etc.
END:
BEGIN: Structuring the output
Output the cleaned address in a single line.
Output address should put State, Country, Zip code at the end in that order.
If any critical component of the address is missing, mention that in errors section.
**Critically important:** Provide a detailed description of every change made
to the address in the "changes_made" field. Do not omit this field.
IF a House number or unit number was removed add that in a separate field
called "subpremise_details".
Output the errors in the field called "errors". If no errors, provide an empty
array.
Output all responses in JSON format.
END:
Bu yapılandırılmış istem, Gemini 2.5 Flash'i şu işlemleri yapmaya yönlendirir:
- Karmaşık ve genellikle yapılandırılmamış adres girişlerini analiz edin.
- Adreslerin önemli bileşenlerini (ör. ev /daire numarası, bina adı, sokak, yerleşim yeri, alt yerleşim yeri, şehir, eyalet, posta kodu).
- Yaygın yazım hatalarını ve varyasyonlarını düzeltir.
- Bileşenleri Hindistan'a uygun, daha standart bir biçimde yeniden sıralayın.
- Mümkün olduğunda eksik önemli bilgileri tahmin edin veya işaretleyin.
"Yapılan değişiklikler" ve hataların listesini oluşturarak şeffaflık sağlar. Modelin, çeşitli dil kalıplarını ve bağlamsal bilgileri işlerken bu ayrıntılı talimatlara uyma becerisi, farklı adres biçimleriyle etkinliği açısından çok önemlidir.
Sunma ve Ölçeklenebilirlik (Vertex AI/Google Cloud'da Cloud Run): Gemini API'ye yapılan çağrıları düzenleyen ve sonuçları ön uca döndüren arka uç hizmeti, sunucusuz container'lı bir uygulama olarak oluşturulur.
Bu sunucusuz mimari, söz konusu hizmetin nasıl dağıtılacağını gösterir. Bir demo uygulaması olarak temel amacı, müşterilerin adres kalitesiyle ilgili hızlı bir şekilde geri bildirim almasını sağlamaktır.
Uygulamayı kullanma
Uygulamaya Hindistan adres geri bildirimi uygulamasından erişebilirsiniz.
Bu özelliği kullanmak için:
- Adresinizi girin: Hindistan'daki adresinizi giriş alanına yazın veya yapıştırın.
- Adresi işleme: "Adresi Temizle" düğmesini tıklayın.
- Sonuçları inceleyin: Uygulama şunları gösterir:
- Temizlenmiş adres.
- Hem orijinal hem de temizlenmiş konumları gösteren bir harita.
- Adres bileşenlerinin dökümü.
- Yapay zeka tarafından yapılan değişikliklerin listesi.
- Algılanan hatalar.
Doğrudan API çağrısı örneği (geliştiriciler için)
Adres işleme işlevini doğrudan entegre etmek isteyen geliştiriciler veya sistemler için arka uç hizmeti programatik olarak çağrılabilir.
cURL kullanan bir örneği aşağıda bulabilirsiniz:
curl -X POST \
https://gemini-address-cleaner-480439120941.us-central1.run.app/clean_address \
-H "Content-Type: application/json" \
-d '{
"input_address": "S/O Laum Mirzapur Mirzapur Muzaffarpur Bihar India Mirzapur purani Darbhanga road SELAMBA BIHAR 843103"
}'
Bu komut, JSON yükünde adres dizesiyle birlikte bir POST isteği gönderir ve işlenmiş adresi ve diğer ilgili bilgileri içeren bir JSON yanıtı döndürür. Bu yanıt, uygulamada gösterilenlere benzer.
Bu uygulama, adreslerin karmaşıklığını basitleştirmeyi amaçlar. Özellikle Hindistan gibi çeşitli ve dinamik ortamlarda doğruluğu ve verimliliği artırmak için değerli bir araç sunar.