Maps Static API'yi kullanmayla ilgili en iyi uygulamalar

Google Haritalar Platformu statik web API'leri, doğrudan web sayfanıza yerleştirebileceğiniz resimler oluşturan Google hizmetlerine yönelik bir HTTP arayüzleri koleksiyonudur.

Bu kılavuzda, resim isteklerinizi ayarlamak ve hizmet yanıtlarını işlemek için uygulayabileceğiniz bazı yaygın uygulamalar açıklanmaktadır. Maps Static API hakkında daha fazla bilgi için geliştirici kılavuzuna bakın.

Statik web API'si nedir?

Google Haritalar Platformu statik web API'leri, JavaScript veya dinamik sayfa yükleme gerektirmeden web sayfanıza bir Google Haritalar resmi yerleştirmenize olanak tanır. Statik web API'leri, standart bir HTTPS isteği kullanılarak gönderilen URL parametrelerine dayalı bir resim oluşturur.

Tipik bir Maps Static API isteği şu biçimdedir:

  https://www.googleapis.com/staticmap/z/x/y?parameters

Not: Tüm Maps Static API uygulamaları için kimlik doğrulama gerekir. Daha fazla bilgi için kimlik doğrulama kimlik bilgileri başlıklı makaleyi inceleyin.

TLS erişimi

API anahtarlarının kullanıldığı veya kullanıcı verilerinin bulunduğu tüm Google Haritalar Platformu istekleri için HTTPS gereklidir. HTTP üzerinden yapılan ve hassas veriler içeren istekler reddedilebilir.

Geçerli bir URL oluşturma

"Geçerli" bir URL'nin ne anlama geldiği açıkça anlaşılıyor gibi görünse de durum tam olarak böyle değildir. Örneğin, bir tarayıcıdaki adres çubuğuna girilen bir URL özel karakterler (ör."上海+中國") içerebilir. Tarayıcının, bu karakterleri iletimden önce farklı bir kodlamaya çevirmesi gerekir. Aynı şekilde, UTF-8 girişi oluşturan veya kabul eden tüm kodlar, UTF-8 karakterleri içeren URL'leri "geçerli" olarak değerlendirebilir ancak bu karakterleri bir web sunucusuna göndermeden önce çevirmesi gerekir. Bu işleme URL kodlama veya yüzde kodlama adı verilir.

Özel karakterler

Tüm URL'lerin Tekdüzen Kaynak Tanımlayıcı (URI) spesifikasyonunda belirtilen söz dizimine uyması gerektiğinden özel karakterleri çevirmemiz gerekir. Bu, URL'lerin yalnızca ASCII karakterlerinin özel bir alt kümesini içermesi gerektiği anlamına gelir: tanıdık alfanümerik semboller ve URL'lerde kontrol karakteri olarak kullanılmak üzere ayrılmış bazı karakterler. Bu karakterler aşağıdaki tabloda özetlenmiştir:

Geçerli bir URL oluştururken yalnızca tabloda gösterilen karakterleri içerdiğinden emin olmanız gerekir. Bir URL'nin bu karakter kümesini kullanacak şekilde uyarlanması genellikle iki soruna yol açar: biri eksiklik, diğeri ise değiştirme.

• İşlemek istediğiniz karakterler yukarıdaki kümenin dışında yer alıyor. Örneğin, yabancı dillerdeki 上海+中國 gibi karakterlerin yukarıdaki karakterler kullanılarak kodlanması gerekir. Yaygın bir uygulamaya göre, URL'lerde izin verilmeyen boşluklar genellikle artı '+' karakteriyle de gösterilir.
• Yukarıdaki kümede ayrılmış karakterler bulunur ancak bunların olduğu gibi kullanılması gerekir. Örneğin, ?, URL'lerde sorgu dizesinin başlangıcını belirtmek için kullanılır. "? and the Mysterions" dizesini kullanmak istiyorsanız '?' karakterini kodlamanız gerekir.

URL kodlu olacak tüm karakterler, '%' karakteri ve UTF-8 karakterlerine karşılık gelen iki karakterli bir onaltılık değer kullanılarak kodlanır. Örneğin, 上海+中國 UTF-8'de URL olarak kodlanmış şekilde %E4%B8%8A%E6%B5%B7%2B%E4%B8%AD%E5%9C%8B olur. ? and the Mysterians dizesi, %3F+and+the+Mysterians veya %3F%20and%20the%20Mysterians olarak URL kodlamalı olur.

Kodlanması gereken yaygın karakterler

Kodlanması gereken bazı yaygın karakterler şunlardır:

Kullanıcı girişinden aldığınız bir URL'yi dönüştürmek bazen zor olabilir. Örneğin, bir kullanıcı adresi "5th&Main St." olarak girebilir. Genel olarak, URL'nizi parçalarından oluşturmalı ve kullanıcı girişlerini değişmez karakterler olarak ele almalısınız.

Ayrıca, tüm Google Haritalar Platformu web hizmetleri ve statik web API'leri için URL'ler 16.384 karakterle sınırlıdır. Çoğu hizmette bu karakter sınırına nadiren yaklaşılır. Ancak, belirli hizmetlerin uzun URL'lere neden olabilecek çeşitli parametreleri olduğunu unutmayın.