Google Haritalar bağlantısı

Places API, yer verileri istekleri için çeşitli yöntemler kullanır. Places API yanıtı, konum verileri ve görüntüleri, coğrafi konumlar ve önemli ilgi çekici yerler dahil olmak üzere bir yerle ilgili veriler içerir.

Bu sürümle birlikte, metin arama, yakınlarda arama ve yer ayrıntıları için verilen yanıtlar Google Haritalar'ın bağlantılarını da içerebilir. Kullanıcılarınız, yanıttaki bir yerle ilgili ek bilgileri görmek için bu Google Haritalar bağlantılarına göz atabilir.

Örneğin, Kaliforniya'nın San Francisco kentindeki havaalanları için arama yaparsınız. Yanıt, yerler listesine İstanbul Sabiha Gökçen Havaalanı'nı (SAW) ekler. Bu sürümde, yanıttaki SFO için Place nesnesi, Google Haritalar'ı ilgili yere açmak için Google Haritalar bağlantılarını, yere giden yol tariflerini, yerle ilgili yorumları ve yer fotoğraflarını içeren googleMapsUri alanını ekler.

Bu sürüm, Place nesnesine eklenen bağlantıların yanı sıra yanıttaki Reviews ve Photos nesnelerine googleMapsUri alanını da ekler:

  • Reviews.googleMapsUri: Yorumu tarayıcıda görüntüleyebilmeniz için Google Haritalar bağlantısını içerir.

  • Photos.googleMapsUri: Fotoğrafı tarayıcıda görüntüleyebilmeniz için fotoğrafın Google Haritalar bağlantısını içerir.

API Gezgini, bu yeni seçeneklerle tanışabilmeniz için canlı istek göndermenize olanak tanır:

Deneyin.

Aşağıdaki tabloda, yanıta ekleyebileceğiniz Google Haritalar bağlantıları gösterilmektedir:

Google Haritalar bağlantısı Açıklama Alan adı
Yer Google Haritalar'ı ilgili yerde açmak için bağlantı. googleMapsLinks.placeUri
Yol tarifi Bağlantıyı tıklayarak Google Haritalar'da ilgili yere giden yol tarifini açabilirsiniz. googleMapsLinks.directionsUri
Yorum yazın Google Haritalar'da yer için yorum yazma bağlantısı. googleMapsLinks.writeAReviewUri
Yorumları oku Yerle ilgili Google Haritalar yorumlarını gösteren bağlantı. googleMapsLinks.reviewsUri
Fotoğraflar Google Haritalar'da yerin fotoğraflarını gösterme bağlantısı. googleMapsLinks.photosUri

Fiyatlandırma

Bu özellik GKST öncesi önizleme aşamasındadır ve ücretsizdir. Yani önizleme sırasında kullanım için faturalandırma 0 ABD dolarıdır. Önerilen fiyatlandırmayla ilgili ayrıntılar için Places API Kullanımı ve Faturalandırması başlıklı makaleyi inceleyin.

Yerler yanıtındaki bağlantılar googleMapsLinks alanında bulunur. Yanıtta görünmesini istiyorsanız googleMapsLinks alanını isteğin alan maskesine eklediğinizden emin olun.

Örneğin, aşağıdaki metin araması, yanıttaki tüm Haritalar bağlantılarını içerir:

curl -X POST -d '{
  "textQuery" : "San Francisco International Airport"
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \
-H 'X-Goog-FieldMask: places.displayName,places.formattedAddress,places.priceLevel,places.googleMapsLinks' \
'https://places.googleapis.com/v1/places:searchText'

Yanıt şu şekildedir:

{
  "places": [
    {
      "formattedAddress": "San Francisco, CA 94128, USA",
      "displayName": {
        "text": "San Francisco International Airport",
        "languageCode": "en"
      },
      "googleMapsLinks": {
        "placeUri": "https://maps.google.com/?cid=11885663895765773631",
        "directionsUri": "https://www.google.com/maps/dir//''/data=!4m7!4m6!1m1!4e2!1m2!1m1!1s0x808f778c55555555:0xa4f25c571acded3f!3e0",
        "writeAReviewUri": "https://www.google.com/maps/place//data=!4m3!3m2!1s0x808f778c55555555:0xa4f25c571acded3f!12e1",
        "reviewsUri": "https://www.google.com/maps/place//data=!4m4!3m3!1s0x808f778c55555555:0xa4f25c571acded3f!9m1!1b1",
        "photosUri": "https://www.google.com/maps/place//data=!4m3!3m2!1s0x808f778c55555555:0xa4f25c571acded3f!10e5"
      }
    }
  ]
}

Yanıtta tüm bağlantıları döndürmeniz gerekmez. Örneğin, yanıtta yalnızca fotoğraf bağlantısının gösterilmesini istiyorsanız alan maskesini yalnızca photosUri alanını içerecek şekilde aşağıda gösterildiği gibi değiştirin:

curl -X POST -d '{
  "textQuery" : "San Francisco International Airport"
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \
-H 'X-Goog-FieldMask: places.displayName,places.formattedAddress,places.priceLevel,places.googleMapsLinks.photosURI' \
'https://places.googleapis.com/v1/places:searchText'

Yanıta yol tarifi ekleme

Tüm Places yöntemleri, yanıtta yol tarifi bağlantısının oluşturulmasını destekler. Mevcut konum başlangıç, yer konumu hedef olarak kullanılır ve seyahat modu sürüş olarak belirlenir.

Aşağıdaki örnekte, Haritalar yol tarifi bağlantısını directionsUri alanındaki yanıta dahil etmek için Yakındaki Arama kullanılmaktadır:

curl -X POST -d '{
  "includedTypes": ["restaurant"],
  "maxResultCount": 10,
  "locationRestriction": {
    "circle": {
      "center": {
        "latitude": -33.8688,
        "longitude": 151.1957362},
      "radius": 500.0
    }
  }
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key:API_KEY' \
-H 'X-Goog-FieldMask: places.displayName,places.googleMapsLinks.directionsUri' \
https://places.googleapis.com/v1/places:searchNearby

Bu sürüm, yanıttaki Reviews ve Photos nesnelerine googleMapsUri alanını ekler. Bu bağlantılara göz atarak yorumu veya fotoğrafı Google Haritalar'da açabilirsiniz.

Örneğin, aşağıdaki metin araması, yanıttaki her yer için yorumları ve fotoğrafları içerir:

curl -X POST -d '{
  "textQuery" : "Spicy Vegetarian Food in Sydney, Australia"
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \
-H 'X-Goog-FieldMask: places.displayName,places.reviews,places.photos' \
'https://places.googleapis.com/v1/places:searchText'

Yanıtta, yorumlar ve fotoğraflar dizisinin her öğesi, yorumu veya fotoğrafı tarayıcıda açmak için googleMapsUri alanını içerir.

Deneyin!

API Gezgini, API'ye ve API seçeneklerine aşina olabilmeniz için örnek istekler göndermenize olanak tanır.

  1. Sayfanın sağ tarafındaki API simgesini API Gezgini'ni genişletin. seçin.

  2. İsteğe bağlı olarak Standart parametreleri göster'i genişletin ve fields parametresini alan maskesine ayarlayın.

  3. İsteğe bağlı olarak İstek gövdesini düzenleyin.

  4. Yürüt düğmesini seçin. İletişim kutusunda, isteği göndermek için kullanmak istediğiniz hesabı seçin.

  5. API Gezgini panelinde, API Gezgini penceresini genişletmek için genişlet simgesini API Gezgini'ni genişletin. seçin.