Android Automotive Intents için Google Haritalar

Android intent'leri aracılığıyla Android Automotive için Google Haritalar'da navigasyonu başlatabilirsiniz.

Genel Bakış

Bu sayfada, Google Haritalar Android Automotive'de kullanabileceğiniz amaçlar açıklanmaktadır. Ayrıntılı Android geliştirici belgeleri için aşağıdakilere bakın:

• Niyetler ve Niyet Filtreleri
• Android platformunda yaygın olarak kullanılan amaçlar

Amaç istekleri

Android Automotive için Google Haritalar'ı bir amaçla başlatmak üzere öncelikle işlemini, URI'sini ve paketini belirterek bir Intent nesnesi oluşturmanız gerekir.

• İşlem. Tüm Google Haritalar intent'leri, View işlemi olarak çağrılır. ACTION_VIEW.

• URI. Google Haritalar amaçları, seçilen bir işlemi belirten URI olarak kodlanmış dizeler ve işlemi gerçekleştirmek için kullanılan bazı veriler kullanır.

• Paket setPackage("com.google.android.apps.maps") işlevi, Android için Google Haritalar uygulamasının Intent'i işlemesini sağlar. Paket ayarlanmamışsa hangi uygulamaların Intent'i işleyebileceğini sistem belirler. Birden fazla uygulama varsa hangi uygulamayı kullanmak istediğiniz sorulabilir.

Amacı oluşturduktan sonra, sistemin ilgili uygulamayı çeşitli şekillerde başlatmasını isteyebilirsiniz. Yaygın bir yöntem, Intent'i startActivity() yöntemine iletmektir. Sistem, gerekli uygulamayı (bu örnekte Google Haritalar) başlatır ve ilgili Activity'ı başlatır.

// Create a Uri from an intent string. Use the result to create an Intent.
Uri mapIntentUri =
Uri.parse("google.navigation:q=Taronga+Zoo,+Sydney+Australia");
// Create an Intent from mapIntentUri. Set the action to ACTION_VIEW
Intent mapIntent = new Intent(Intent.ACTION_VIEW, mapIntentUri);
// Make the Intent explicit by setting the Google Maps package
mapIntent.setPackage("com.google.android.apps.maps");
// Attempt to start an activity that can handle the Intent
startActivity(mapIntent);

Sistem, Intent'e yanıt verebilecek bir uygulamayı tanımlayamazsa uygulamanız kilitlenebilir. Bu nedenle, kullanıcılara bu amaçlardan birini sunmadan önce alıcı uygulamanın yüklendiğini doğrulayın.

Bir uygulamanın amaç alıp alamadığını doğrulamak için Intent nesnenizde resolveActivity() yöntemini çağırın. Sonuç boş değilse (non-null), isteği işleyebilecek en az bir uygulama vardır ve startActivity() çağrısı yapmak güvenlidir. Sonuç boşsa amaç kullanılmamalıdır ve mümkünse amacı çağıran özellik devre dışı bırakılmalıdır.

if (mapIntent.resolveActivity(getPackageManager()) != null) {
...
}

Örneğin, Sidney'deki Taronga Hayvanat Bahçesi'ne adım adım navigasyonu başlatmak için aşağıdaki kodu kullanabilirsiniz:

Uri mapIntentUri = Uri.parse("google.navigation:q=Taronga+Zoo,+Sydney+Australia");
Intent mapIntent = new Intent(Intent.ACTION_VIEW, mapIntentUri);
mapIntent.setPackage("com.google.android.apps.maps");
if (mapIntent.resolveActivity(getPackageManager()) != null) {
startActivity(mapIntent);
}

URI kodlu sorgu dizeleri

Google Haritalar amaçlarına iletilen tüm dizeler URI kodlamasına sahip olmalıdır. Örneğin, "1st & Pike, Seattle" dizesi 1st%20%26%20Pike%2C%20Seattle olmalıdır. Dizedeki boşluklar %20 ile kodlanabilir veya artı işaretiyle (+) değiştirilebilir.

Dizelerinizi kodlamak için android.net.Uri encode() yöntemini kullanabilirsiniz. Örneğin:

Uri mapIntentUri = Uri.parse("google.navigation:q=" + Uri.encode("1st & Pike, Seattle"));

Harita görüntüleme

Belirli bir konumda ve yakınlaştırma düzeyinde harita görüntülemek için geo: amacını kullanın. Örneğin:

geo:latitude,longitude?z=zoom

Parametreler

• latitude ve longitude, haritanın merkez noktasını ayarlar.

• z, isteğe bağlı olarak haritanın ilk yakınlaştırma düzeyini ayarlar. Kabul edilen değerler 0 (tüm dünya) ile 21 (binalar) arasındadır. Üst sınır, seçilen konumda bulunan harita verilerine bağlı olarak değişebilir.

Örnek

// Creates an intent that will load a map of San Francisco
Uri gmmIntentUri = Uri.parse("geo:37.7749,-122.4194");
Intent mapIntent = new Intent(Intent.ACTION_VIEW, gmmIntentUri);
mapIntent.setPackage("com.google.android.apps.maps");
startActivity(mapIntent);

Konum arayın

Belirli bir görünüm alanındaki arama sorgularını göstermek için bu amaca yönelik işlemi kullanın:

geo:latitude,longitude?q=query
geo:0,0?q=my+street+address

Parametreler

Arama, harita görüntülemek için kullanılan parametrelere ek olarak şu parametreyi de destekler:

• q, haritada vurgulanacak yerleri tanımlar. q parametresi tüm arama istekleri için zorunludur. Konum, yer adı veya adres olarak kabul edilir. Dize, URL'de kaçış karakteri kullanılarak kodlanmalıdır. Bu nedenle, "City Hall, New York, NY" gibi bir adres City+Hall%2CNew+York%2CNY olarak dönüştürülmelidir.

Arama sonuçlarını koordinatlarla önyargılı hale getirme

Çok spesifik bir konum aranırken q parametresine dahil edilmişse enlem ve boylam kesinlikle gerekli değildir. Ancak tam adresi bilmiyorsanız veya sorgu belirsizse bir koordinat belirterek arama sonuçlarını etkilemeye çalışabilirsiniz. Örneğin, "Ana Cadde" için adres araması yapıldığında çok fazla sonuç döndürülebilir:

// Searching for "101 Main Street" with no lat/long might return too many results
Uri gmmIntentUri = Uri.parse("geo:0,0?q=101+main+street");
Intent mapIntent = new Intent(Intent.ACTION_VIEW, gmmIntentUri);
mapIntent.setPackage("com.google.android.apps.maps");
startActivity(mapIntent);

Niyet URI'sine enlem ve boylam eklemek sonuçları belirli bir alana yönlendirir:

// Searches for "101 Main Street" near San Francisco
Uri gmmIntentUri = Uri.parse("geo:37.7749,-122.4194?q=101+main+street");
Intent mapIntent = new Intent(Intent.ACTION_VIEW, gmmIntentUri);
mapIntent.setPackage("com.google.android.apps.maps");
startActivity(mapIntent);

Rota boyunca arayın

Navigasyon sırasında bir arama amacı geo:latitude,longitude?q=query gönderilirse rota boyunca arama tetiklenir ve enlem ile boylam yoksayılır.

Önceden tanımlanmış kategorileri arama

Google Haritalar'ın araçla entegrasyonunu desteklemek için araçtaki Google Haritalar, şu önceden tanımlanmış kategorileri gösteren bir amaca yönelik işlemi destekler:

Kategori amacı geo:lat,lng?c=category biçimindedir.

Kullanıcının yerel ayarından bağımsız olarak c=<pre-defined category> kullanın. Google Haritalar, bu kategori için uygun yerel ayarda alakalı sonuçlar gösterir. Örneğin:

// Search for gas stations nearby
Uri gmmIntentUri = Uri.parse("geo:0,0?c=gas_station");
Intent mapIntent = new Intent(Intent.ACTION_VIEW, gmmIntentUri);
mapIntent.setPackage("com.google.android.apps.maps");
startActivity(mapIntent);

Diğer kategorik arama

Kullanıcının yerel ayarında genel bir arama terimi ("restoranlar" veya "kafeler" gibi) iletirseniz Android Automotive için Google Haritalar, ölçütlere uyan işletme listelemelerini arar. geo: amacında belirli bir enlem ve boylam sağlanıyorsa arama bu konumun etrafında ortalanır. Konum belirtilmemişse (ör. geo:0,0) Google Haritalar, yakındaki işletme listelemelerini bulmaya çalışır. Örneğin:

// Search for restaurants nearby
Uri gmmIntentUri = Uri.parse("geo:0,0?q=restaurants");
Intent mapIntent = new Intent(Intent.ACTION_VIEW, gmmIntentUri);
mapIntent.setPackage("com.google.android.apps.maps");
startActivity(mapIntent);

Sorgu dizesiyle birlikte bir yakınlaştırma parametresi belirterek arama sonuçlarını daha da etkileyebilirsiniz. Aşağıdaki örnekte, 10 yakınlaştırma eklenerek yakındaki restoranlar yerine şehir düzeyinde restoranlar bulunmaya çalışılıyor:

Uri gmmIntentUri = Uri.parse("geo:37.7749,-122.4194?z=10&q=restaurants");
Intent mapIntent = new Intent(Intent.ACTION_VIEW, gmmIntentUri);
mapIntent.setPackage("com.google.android.apps.maps");
startActivity(mapIntent);

Adım adım navigasyonu başlatma

Diğer Android cihazlarda adım adım navigasyonu başlatma ile ilgili dokümanlar için Android için Google Haritalar Amaçlarında Adım Adım Navigasyonu Başlatma başlıklı makaleyi inceleyin.

Bu amaca yönelik işlemi kullanarak, belirtilen bir veya daha fazla adrese ya da koordinata adım adım yol tarifleriyle Google Haritalar'da gezinmeyi başlatın. Yol tarifleri her zaman kullanıcının mevcut konumundan başlar.

google.navigation:q=a+street+address
google.navigation:q=latitude,longitude
google.navigation:place=placename

Parametreler

Navigasyonu başlatmak için place veya q ile birlikte waypoints'ı (isteğe bağlı) kullanın. Bir ara noktayı isteğe bağlı olarak şarj istasyonu şeklinde işaretlemek için Elektrikli araç seyahat planını Google Haritalar'a gönderme başlıklı makaleyi inceleyin.

• q, gezinme aramaları için uç noktayı ayarlar. Bu, enlem ve boylam veya biçimlendirilmiş bir adres sorgusu olabilir. Birden fazla sonuç döndüren bir sorgu dizesiyse ilk sonuç seçilir.

• place, bitiş noktasını ev veya iş olarak ayarlar. Kullanıcının evine gitmek için "ev"i, iş yerine gitmek için "iş"i belirtin.

• avoid, rotanın kaçınmaya çalışması gereken özellikleri belirler. avoid isteğe bağlıdır ve aşağıdaki değerlerden biri veya daha fazlası olarak ayarlanabilir:

  • Geçiş ücretleri için t
  • h otoyollar için
  • f feribotlar için

• waypoints, q tarafından belirtilen nihai hedefe yol tarifi vermek için bir veya daha fazla ara yer belirtir. Yerleri ayırmak için dikey çizgi karakterini (|) kullanarak birden fazla ara nokta belirtebilirsiniz. Örneğin, Berlin,Germany|Paris,France. İhtiyacınız kadar ara nokta kullanabilirsiniz. Ara noktalar, URL'de listelendikleri sırayla rotaya eklenir. Her bir ara nokta, adres veya virgülle ayrılmış enlem ve boylam koordinatları olabilir. Aynı amaçta adresler ve enlem/boylam koordinatları bulunabilir. Dizeler URL'de kaçış karakteri kullanılarak kodlanmalıdır. Bu nedenle, "Berlin,Almanya|Paris,Fransa" gibi ara noktalar Berlin%2CGermany%7CParis%2CFrance şeklinde dönüştürülmelidir.

Örnekler

Bu niyet, Avustralya'nın Sidney şehrindeki Taronga Hayvanat Bahçesi'ne adım adım navigasyon isteğinde bulunacak:

Uri mapIntentUri = Uri.parse("google.navigation:q=Taronga+Zoo,+Sydney+Australia");
Intent mapIntent = new Intent(Intent.ACTION_VIEW, mapIntentUri);
mapIntent.setPackage("com.google.android.apps.maps");
startActivity(mapIntent);

Gişelerden geçmek veya feribota binmek istemiyorsanız aşağıdaki durumlardan kaçınmaya çalışan bir rota isteğinde bulunabilirsiniz:

Uri mapIntentUri = Uri.parse("google.navigation:q=Taronga+Zoo,+Sydney+Australia&avoid=tf");
Intent mapIntent = new Intent(Intent.ACTION_VIEW, mapIntentUri);
mapIntent.setPackage("com.google.android.apps.maps");
startActivity(mapIntent);

Ev adresinize gitmeyi tercih ederseniz şunları kullanın:

Uri mapIntentUri = Uri.parse("google.navigation:place=home");
Intent mapIntent = new Intent(Intent.ACTION_VIEW, mapIntentUri);
mapIntent.setPackage("com.google.android.apps.maps");
startActivity(mapIntent);

Sırasıyla aşağıdaki üç adrese adım adım navigasyonu başlatmak, Taronga Hayvanat Bahçesi'ni son hedef q, Google Sidney ve Sidney Opera Binası'nı ise ara nokta olarak geçmek için:

1. Google Sidney

2. Sidney Opera Binası

3. Taronga Hayvanat Bahçesi, Sidney, Avustralya

Uri mapIntentUri = Uri.parse("google.navigation:q=Taronga+Zoo,+Sydney+Australia&waypoints=Google+Sydney%7CSydney+Opera+House");
Intent mapIntent = new Intent(Intent.ACTION_VIEW, mapIntentUri);
mapIntent.setPackage("com.google.android.apps.maps");
startActivity(mapIntent);

q'ya benzer şekilde, ara noktaların herhangi birini adres yerine virgülle ayrılmış enlem ve boylam olarak da gösterebilirsiniz. Örneğin, adres yerine Sidney Opera Binası'nın enlem ve boylamını iletirken aynı navigasyonu başlatmak için:

Uri mapIntentUri = Uri.parse("google.navigation:q=Taronga+Zoo,+Sydney+Australia&waypoints=Google+Sydney%7C-33.856159,151.215256");
Intent mapIntent = new Intent(Intent.ACTION_VIEW, mapIntentUri);
mapIntent.setPackage("com.google.android.apps.maps");
startActivity(mapIntent);

Google Haritalar'a elektrikli araç gezi planı gönderme

Bazı hedefleri elektrikli araç (EV) şarj noktası olarak belirtmek için bu çok hedefli gezinme amacını kullanın. Çok noktalı rota oluşturma amacını genişleten bu amaç, elektrikli araç gezi planlama uygulamaları ile Google Haritalar arasında şarj noktası bilgilerini senkronize ederek sürücülerin gidecekleri yere ulaşmak için yeterli elektrikli araç pili şarjını korumalarına yardımcı olur.

Şarj noktaları ve seyahat amaçları için:

• Ad ve enlem-boylam bilgisi içermelidir.
• Şarj süresini hesaplamak için kullanılacak güç çıkışını isteğe bağlı olarak içerebilir.

Google, bağlayıcı türleri, toplamlar, hızlar ve gerçek zamanlı müsaitlik durumu, desteklenen ödeme yöntemleri ve ilgi çekici yerler (POI) gibi zengin verileri göstermek için eşleşen bir şarj istasyonu yeri bulmak üzere şarj istasyonu adını ve enlem-boylamı kullanır. Örneğin, navigasyonun son bölümü için açık hava otoparklarındaki sürüş yol tarifleri, çalışma saatleri, puanlar. Şarj istasyonlarının Google'ın verileriyle iyi eşleşmesini sağlamak için belirli bir <brand name> kullanın (ör. ChargePoint).

Parametreler

Aşağıdaki parametreler, son varış noktası ve elektrikli araç şarj istasyonları olarak belirlenenler de dahil olmak üzere tüm ara noktalarla ilgili ayrıntıları belirtmenize olanak tanır.

Son varış noktası

Şarj istasyonunu son hedef olarak ayarlamak için şunu kullanın:

• q: Şarj istasyonunun enlem-boylam değerini içermelidir.
• q_type: 1, son varış noktasının bir şarj istasyonu olduğunu belirtir.
• q_name: Son varış noktasının adı. q_type, 1 ise zorunludur.
• q_power_output_kw: Kilovat cinsinden şarj istasyonu güç çıkışı için çift sayı. İsteğe bağlıdır.

Ara noktalar

Ara noktalar için tüm parametreler, son hedef hariç ara noktalarla aynı sıradaki değerlerin paralel, dikey çizgiyle ayrılmış (|) dizileridir. Paralel dizilerdeki öğe sayısındaki uyuşmazlık, hatalı biçimlendirilmiş niyet olarak değerlendirilir.

Bir veya daha fazla şarj istasyonu ara noktası eklemek için aşağıdaki parametreleri kullanın. Bu parametrelerin tümü isteğe bağlıdır. Hedeflerden biri şarj istasyonu olarak işaretlenirse bu hedef için ara nokta adı zorunlu hale gelir.

• waypoints: Adım adım navigasyon amacında açıklandığı şekilde yol noktalarının listesi. Şarj istasyonu yol noktaları için enlem-boylam değeri olmalıdır.

• waypoint_types: Rota noktası başına türler sayı olarak belirtilir. 0 herhangi bir durak (varsayılan değer), 1 ise şarj istasyonudur.

• waypoint_names: Ara nokta adları. Bu alan, şarj istasyonları için zorunludur.

• waypoint_power_outputs_kw: Şarj istasyonu gücü için kilovat cinsinden sayılar. Şarj istasyonları için isteğe bağlı olarak bir ara nokta güç çıkışı değeri belirtebilirsiniz. Bu değer, eşleşen istasyon bulunamazsa yedek olarak kullanılır. Boş yuva, değer sağlanmadığı anlamına gelir.

Kullanıcı deneyimi (UX) davranışı

Birden fazla hedef içeren gezi amaçlarında rota genel bakış ekranı gösterilir ancak navigasyon otomatik olarak başlamaz.

Doğru biçimlendirilmiş bir amaç için Google Haritalar, seyahatin rota genel görünümü ekranını gösterir. Rotaya genel bakış ekranında, amaçtan alınan tüm ara noktalar ve nihai hedef gösterilir. Uygun durumlarda şarj önerileri de gösterilir.

Şarj istasyonu olarak işaretlenen tüm ara noktalar veya nihai hedefler için Google Haritalar, Google'ın veritabanında eşleşen bir yer arar. Şarj istasyonları için mümkün olan en iyi bilgilerin gösterilmesini sağlamak üzere:

• Bir eşleşme bulunursa Google Haritalar, şarj istasyonunu kullanıcı arayüzünde (UI) göstermek ve şarj istasyonu için şarj önerisi sunmak üzere Google verilerini kullanır.

• Eşleşme bulunamazsa bu şarj istasyonunu kullanıcı arayüzünde göstermek ve bu şarj istasyonunda şarj önerisi sunmak için şarj istasyonuyla ilgili amaçta sağlanan veriler (enlem-boylam, ad ve güç çıkışı) kullanılır.

Örnekler

Aşağıdaki örneklerde, birden fazla şarj istasyonundan geçerek gezinme ve bilinmeyen güç çıkışlarını işleme gibi çeşitli elektrikli araç seyahat planlama senaryoları için niyetlerin nasıl oluşturulacağı gösterilmektedir.

Birden fazla şarj istasyonundan geçerek nihai varış noktasına gitme

Aşağıdaki amaç, iki şarj istasyonu (ChargePoint ve Evie) üzerinden son varış noktası olan Port Macquarie NSW'ye gidiyor.

Hedefler (sıralı):

1. ChargePoint Şarj İstasyonu (konum: -32.9599188,151.6240806, güç çıkışı: 6,6 kW)

2. Evie Şarj İstasyonu (konum: -31.9432539,152.4699808, güç çıkışı: 350 kW)

3. Port Macquarie NSW

Uri mapIntentUri =
    Uri.parse(
        "google.navigation:q=Port+Macquarie+NSW"
            + "&waypoints=-32.9599188%2C151.6240806%7C-31.9432539%2C152.4699808"
            + "&waypoint_types=1%7C1"
            + "&waypoint_names=ChargePoint+Charging+Station%7CEvie+Charging+Station"
            + "&waypoint_power_outputs_kw=6.6%7C350");
Intent mapIntent = new Intent(Intent.ACTION_VIEW, mapIntentUri);
mapIntent.setPackage("com.google.android.apps.maps");
startActivity(mapIntent);

Bilinmeyen güç çıkışı

Güç çıkışı değeri bilinmiyorsa waypoint_power_outputs_kw ile ilgili yuva boş bırakılır. Alternatif olarak, tüm yuvalar boşsa waypoint_power_outputs_kw parametresini belirtmeniz gerekmez.

Hedefler (sıralı):

1. ChargePoint Şarj İstasyonu (konum: -32.9599188,151.6240806, güç çıkışı: bilinmiyor)

2. Port Macquarie NSW

Uri mapIntentUri =
    Uri.parse(
        "google.navigation:q=Port+Macquarie+NSW"
            + "&waypoints=-32.9599188%2C151.6240806"
            + "&waypoint_types=1"
            + "&waypoint_names=ChargePoint+Charging+Station");
Intent mapIntent = new Intent(Intent.ACTION_VIEW, mapIntentUri);
mapIntent.setPackage("com.google.android.apps.maps");
startActivity(mapIntent);

Son varış noktasını şarj istasyonu olarak işaretleme

Son varış noktasını şarj istasyonu olarak işaretlemek için q_type, q_name ve q_power_output_kw parametrelerini belirtin.

Hedefler (sıralı):

1. Taronga Hayvanat Bahçesi, Sidney, Avustralya

2. ChargePoint Şarj İstasyonu (konum: -32.9599188,151.6240806, güç çıkışı: bilinmiyor)

3. Evie Şarj İstasyonu (konum: -31.9432539,152.4699808, güç çıkışı: 350 kW)

Uri mapIntentUri =
    Uri.parse(
        "google.navigation:q=-31.9432539,152.4699808&q_type=1&q_name=Evie+Charging+Station&q_power_output_kw=350"
            + "&waypoints=Taronga+Zoo%2C+Sydney+Australia%7C-32.9599188%2C151.6240806"
            + "&waypoint_types=0%7C1"
            + "&waypoint_names=%7CChargePoint+Charging+Station"
            + "&waypoint_power_outputs_kw=%7C");
Intent mapIntent = new Intent(Intent.ACTION_VIEW, mapIntentUri);
mapIntent.setPackage("com.google.android.apps.maps");
startActivity(mapIntent);

İşlem amaçları

Aşağıdaki işlem amaçları arayüzlerle kullanılabilir: