Haritalar URL'leri hızlı referansı

Haritalar URL'leri; arama yapmak, yol tarifi ve navigasyon almak, harita görünümlerini görüntülemek, yerlerin kısa listesini oluşturmak veya Street View panoramalarını göstermek için Google Haritalar'ı başlatan evrensel, platformlar arası bir URL oluşturmanıza olanak tanır. URL söz dizimi her platformda aynıdır ve API anahtarı gerekmez.

Haritalar URL'leri: Temel bilgiler

  • Ürün: Haritalar URL'leri
  • Diğer adları: Google Haritalar URL'leri
  • Kategori: Haritalar
  • Platform: URL şeması
  • Lansman aşaması: GA
  • Yaşam döngüsü: Etkin
  • Genel bakış: Haritalar URL'lerine genel bakış

Haritalar URL'leri: Ne zaman kullanılır?

Haritalar URL'lerini şu durumlarda kullanın:

  • Bir yeri aramak veya arama sonuçlarını göstermek için Android uygulamanızdan, iOS uygulamanızdan ya da web sitenizden Google Haritalar'ı açan bir bağlantıya ihtiyacınız vardır.
  • Google Haritalar'ı noktalar arasındaki yol tarifleriyle (isteğe bağlı olarak yol noktaları, seyahat modu veya adım adım rota ile) açmanız gerekir.
  • Google Haritalar'ı API anahtarı kullanmadan harita görünümü, kısa bir yer listesi veya Street View panoraması olarak açmanız gerekir.
  • Android, iOS ve masaüstü tarayıcılarda aynı şekilde çalışan bir URL söz dizimine ihtiyacınız vardır.

Haritalar URL'lerini şu durumlarda kullanmayın:

  • Zaten Yer Ayrıntıları isteğinde bulunuyorsunuz ve bir yer için önceden biçimlendirilmiş Google Haritalar bağlantıları (googleMapsUri veya googleMapsLinks alanları) istiyorsunuz. Bunun yerine Places API'yi (Yeni) kullanın.
  • Google Haritalar uygulamasını başlatırken yalnızca mobil cihazlara yönelik özelliklere ihtiyacınız varsa Android için Google Haritalar intent'lerini veya iOS için Google Haritalar URL şemasını kullanın.

Haritalar URL'leri: kurulum

  • Kullanım ilişkilendirmesi: Haritalar URL'lerine isteğe bağlı utm_source (uygulamanızın adı) ve utm_campaign (kullanıcının amaçlanan işlemi, örneğin place_details_search) sorgu parametrelerini ekleyin.
  • Başlayın: Haritalar URL'lerini ayarlama

Haritalar URL'leri: Sık yapılan yanlışlar

  • Sorun: query parametresinde yalnızca enlem/boylam içeren bir arama URL'si, haritada veya yan panelde raptiye gösterir ancak yer ayrıntılarını göstermez. Düzeltme: Belirli bir yerin ayrıntılarını göstermek için query=PLACE_NAME,ADDRESS kullanın veya query ile birlikte query_place_id ekleyin. /maps/documentation/urls/get-started adresini inceleyin.
  • Sorun: Yer kimliği parametreleri (query_place_id, origin_place_id, destination_place_id, waypoint_place_ids) tek başına çalışmaz. Düzeltme: Bir yer kimliği parametresi ilettiğinizde her zaman eşleşen temel parametreyi (query, origin, destination veya waypoints) ekleyin. /maps/documentation/urls/get-started adresini inceleyin.
  • Sorun: waypoints parametresi, yol noktalarını desteklemeyen ve platforma bağlı sayı sınırları olan Google Haritalar ürünlerinde yoksayılır. dir_action=navigate ise navigasyonun kullanılamadığı yerlerde yoksayılır. Düzeltme: Mobil tarayıcılarda açılan bağlantılar için en fazla üç yol noktası kullanın (diğer durumlarda dokuz) ve waypoints veya dir_action=navigate parametrelerinin her Google Haritalar ürününde ya da rotasında çalışacağını varsaymayın. /maps/documentation/urls/get-started#directions-action adresini inceleyin.
  • Sorun: Haritalar ve Street View aynı @ uç noktasını paylaştığından, doğru işlem içermeyen bir harita URL'si haritayı görüntülemeyebilir. Düzeltme: Harita görünümleri için map_action=map, Street View panoramaları için map_action=pano değerini ayarlayın. /maps/documentation/urls/get-started adresini inceleyin.
  • Sorun: Haritalar URL'sinde api=1 eksikse tüm parametreler yoksayılır ve Google Haritalar varsayılan görünümünü açar. Düzeltme: Her Haritalar URL'sine api=1 parametresini ekleyin (1, geçerli tek değerdir). /maps/documentation/urls/get-started#forming-the-url adresini inceleyin.