Google Haritalar bağlantısı

Places API (Yeni), çeşitli yöntemlerle yer verileri isteklerini kabul eder. Places API (Yeni) yanıtı, bir yerle ilgili verileri (konum verileri ve görüntüleri, coğrafi konumlar ve önemli ilgi alanları dahil) içerir.

Metin Arama (Yeni), Yakınlardaki Arama (Yeni) ve Yer Ayrıntıları (Yeni) hizmetlerinin yanıtları Google Haritalar bağlantılarını da içerebilir. Kullanıcılarınız, yanıttaki bir yer hakkında ek bilgi görmek için bu Google Haritalar bağlantılarına göz atabilir.

Örneğin, Kaliforniya, San Francisco'daki havaalanlarını aradığınızı varsayalım. Yanıtta, yerler listesine İstanbul Sabiha Gökçen Havaalanı (SFO) ekleniyor. Yanıttaki SFO için Place nesnesi, Google Haritalar'ı yerde açmak, yere yol tarifi almak, yerin yorumlarını ve yer fotoğraflarını görmek için Google Haritalar bağlantılarını içeren googleMapsUri alanını ekler.

Place nesnesine eklenen bağlantıların yanı sıra yanıttaki Reviews ve Photos nesnelerine googleMapsUri alanı da eklenir:

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

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

API Gezgini, bu yeni seçeneklere alışabilmeniz için canlı isteklerde bulunmanıza olanak tanır:

Deneyin.

Bir yer için desteklenen Google Haritalar bağlantıları

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

Yerler yanıtına tüm bağlantıları dahil et

Yerler yanıtındaki bağlantılar googleMapsLinks alanında yer alır. Yanıt içinde görünmesini istediğiniz googleMapsLinks alanını, isteğin alan maskesine eklediğinizden emin olun.

Örneğin, aşağıdaki Metin Arama (Yeni) yanıtında tüm Haritalar bağlantıları yer alır:

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 biçimde olmalıdır:

{
  "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ıta belirli bir bağlantı ekleme

Yanıtta tüm bağlantıları döndürmeniz gerekmez. Örneğin, yanıtta yalnızca fotoğraflar bağlantısının olmasını istiyorsanız alan maskesini yalnızca photosUri alanını içerecek şekilde aşağıdaki 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ı oluşturmayı destekler. Kaynak olarak geçerli konum, hedef olarak yer konumu ve seyahat modu olarak araba kullanılır.

Aşağıdaki örnekte, yanıttaki harita yol tarifi bağlantısını directionsUri alanına eklemek için Yakında Arama (Yeni) kullanılı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

Yorum ve fotoğraf bağlantılarını ekleyin.

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

Örneğin, aşağıdaki Metin Arama (Yeni) yanıtında her bir yer için yorumlar ve fotoğraflar yer alıyor:

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ıtın yorumlar ve fotoğraflar dizisindeki her öğe, yorumu veya fotoğrafı tarayıcıda açmak için googleMapsUri alanını içerir.

Deneyin.

API Gezgini, API ve API seçeneklerine alışabilmeniz için örnek istekler göndermenize olanak tanır.

1. Sayfanın sağ tarafındaki api API simgesini 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 Request body (İstek gövdesi) bölümünü 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 fullscreen simgesini seçin.

   API Gezgini penceresini genişletmek için Tam ekran'ı tıklayın.