Varış noktası arama

Avrupa Ekonomik Alanı (AEA) geliştiricileri

A Destination bir kullanıcının ulaşmak veya gezinmek istediği belirli bir konumu veya yeri ifade eder. Destination, konum veya yerle ilgili bir bilgi koleksiyonunu da içerir. Örneğin, navigasyon noktaları, önemli yerler, girişler ve bina ana hatları.

Geocoding API'nin SearchDestinations yöntemi, adres, yer kimliği veya enlem ve boylam koordinatları gibi farklı giriş ölçütlerine göre çeşitli hedefler hakkında ayrıntılı bilgi almanıza olanak tanır.

Varış noktası arama isteği

Arama hedefleri isteği şu biçimde bir URL'ye yapılan HTTP POST isteğidir:

https://geocode.googleapis.com/v4/geocode/destinations

JSON istek gövdesindeki veya üstbilgilerdeki tüm parametreleri POST isteğinin bir parçası olarak iletin. Örneğin:

curl -X POST -d '{
  "place": "places/ChIJY8sv5-i2j4AR_S6BlDDR42w"
}' \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: *" \
https://geocode.googleapis.com/v4/geocode/destinations

Hedef aramak için konumu 3 şekilde belirtebilirsiniz:

  • Adres
  • Yer kimliği
  • Enlem ve boylam koordinatları

Adrese göre hedef arama

Adresi yapılandırılmamış bir dize olarak belirtebilirsiniz. Adres coğrafi kodlaması, enlem ve boylam koordinatlarını ya da adresleri temsil etmeyen diğer yapılandırılmamış dizeleri çözmez. Bu tür dizelerin kullanıldığı istekler desteklenmez ve hata yanıtlarına veya belirtilmemiş davranışlara yol açabilir. Desteklenmeyen sorgulara örnek olarak aşağıdakiler verilebilir:

Sorgu türü Örnek
Enlem ve boylam koordinatları. Bunun yerine konum sorgusu kullanın. "37.422131,-122.084801"
Tek bir sorguda birden fazla yerin, yolun veya şehrin adı gibi çok fazla kavram ya da kısıtlama olması "Market Street San Francisco San Jose Airport"
Posta adresi öğeleri Google Haritalar'da gösterilmiyor "C/O John Smith 123 Main Street"
"P.O. Box 13 San Francisco"
İşletmelerin, zincirlerin veya kategorilerin adları, bu öğelerin bulunmadığı konumlarla birlikte kullanılamaz. "Tesco near Dallas, Texas" (Teksas, Dallas yakınlarındaki Tesco)
Birden fazla yorumu olan belirsiz sorgular "Şarj cihazı terk etme"
Artık kullanılmayan eski adlar "Middlesex United Kingdom"
Coğrafi olmayan öğeler veya amaç "Ventura Limanı'nda kaç tekne var?"
Resmi olmayan veya kişisel adlar "The Jenga"
"The Helter Skelter"
Büyük siyasi birimler (şehirler, eyaletler, ülkeler) "New York City"
"California"
"USA"
Belirli adreslerin olmadığı rotalar "1st Ave., NYC, NY"
"I-95" 
curl -X POST -d '{
  "addressQuery": {
    "addressQuery": "601 S Bernardo Ave, Sunnyvale, CA 94087, USA"
  }
}' \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: *" \
https://geocode.googleapis.com/v4/geocode/destinations

veya postalAddress olarak:

curl -X POST -d '{
  "addressQuery": {
    "address": {
      "addressLines": ["601 S Bernardo Ave"],
      "locality": "Sunnyvale",
      "postalCode": "94087",
      "administrativeArea": "CA",
      "regionCode": "US"
    }
  }
}' \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: *" \
https://geocode.googleapis.com/v4/geocode/destinations

Genellikle bir HTML formunda yakalanan adres bileşenlerini işlerken postalAddress biçimini kullanırsınız.

Yer kimliğine göre hedef arama

Yer kimliği sağlayarak bir hedefi alabilirsiniz:

curl -X POST -d '{
  "place": "places/ChIJY8sv5-i2j4AR_S6BlDDR42w"
}' \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: *" \
https://geocode.googleapis.com/v4/geocode/destinations

Desteklenen yer kimlikleri

Arama Hedefleri yöntemi, belirli ve gezilebilir hedefleri temsil eden yer kimlikleriyle en iyi şekilde çalışır. establishment, point_of_interest, premise, street_address ve subpremise gibi türler için yer kimlikleri genellikle desteklenir. Adres aralıklarından (ör. "10-20 Main St"), belirli bir numarası olmayan bir rotanın bölümlerinden veya artı kodlardan çıkarılanlar gibi ayrı konumları temsil etmeyen yer kimlikleri desteklenmez. Alanı çok büyük olan sonuçlar (ör. "Pasifik Okyanusu") için yer kimlikleri de desteklenmez.

Arama hedefleriyle otomatik tamamlama (yeni) özelliğini kullanma

Uyumluluğu sağlamak için Arama Hedefleri ile kullanılacak yer kimliklerini bulmak üzere Autocomplete (New)'u kullanın. Autocomplete (New) özelliğini kullanırken includedPrimaryTypes parametresini kullanarak sonuçları türe göre filtrelemeniz gerekir. Aşağıdaki önerilen filtre kullanılarak Otomatik Tamamlama (Yeni) tarafından döndürülen yer kimlikleri, Arama Hedefleri tarafından desteklenir:

"includedPrimaryTypes": [ "establishment", "point_of_interest", "premise", "street_address", "subpremise" ]

Ayrıca, Otomatik Tamamlama (Yeni) isteğinizde include_pure_service_area_businesses işaretini true olarak ayarlamamalısınız.

Konuma göre hedef arama

Enlem ve boylam koordinatlarını girerek bir hedef arayabilirsiniz:

curl -X POST -d '{
  "locationQuery": {
    "location": {
      "latitude": 37.37348780,
      "longitude": -122.05678064
    }
  }
}' \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: *" \
https://geocode.googleapis.com/v4/geocode/destinations

İstek göndermek için OAuth'u kullanma

Geocoding API v4, kimlik doğrulama için OAuth 2.0'ı destekler. OAuth'u Geocoding API'si ile kullanmak için OAuth jetonuna doğru kapsam atanmalıdır. Geocoding API, Destinations yöntemiyle kullanılmak üzere aşağıdaki kapsamları destekler:

  • https://www.googleapis.com/auth/maps-platform.geocode — Tüm Geocoding API yöntemleriyle kullanılabilir.

Ayrıca, tüm Geocoding API yöntemleri için genel https://www.googleapis.com/auth/cloud-platform kapsamını kullanabilirsiniz. Bu kapsam, tüm yöntemlere erişime izin veren genel bir kapsam olduğundan geliştirme sırasında kullanışlıdır ancak üretimde kullanışlı değildir.

Daha fazla bilgi ve örnek için OAuth'u kullanma başlıklı makaleyi inceleyin.

Hedef arama yanıtı

Arama Hedefleri yanıtı, konum hakkında zengin ve yakın çevreye özel bağlam bilgisi sağlar.

Arama Hedefleri yanıtındaki PlaceView nesneleri (ör. primary, containingPlaces içindeki öğeler ve landmarks), yer türünü belirtmek için alanları kullanır:

  • types: Yer türlerini belirten bir dizeler dizisi.
  • primaryType: Yerleşim yerinin birincil türünü belirten dize.

Hem types hem de primaryType için olası dize değerleri, Yer Türleri (Yeni) sayfasındaki A Tablosu ve B Tablosu'ndan alınır.

Bu bölümde, temel yanıt alanları açıklanmaktadır. Tüm yanıt alanları hakkında ayrıntılı bilgi için API Referansı'na bakın.

primary

İstekteki sorgu tarafından tanımlanan ana yer.

addressComponents

Bu adres için geçerli olan ayrı bileşenleri içeren bir dizi.

Her adres bileşeni genellikle aşağıdaki alanları içerir:

  • types[], adres bileşeninin türünü belirten bir dizidir. Desteklenen türlerin listesine bakın.
  • longText, adres bileşeninin Geocoder tarafından döndürülen tam metin açıklaması veya adıdır.
  • shortText, varsa adres bileşeninin kısaltılmış metin adıdır. Örneğin, Alaska eyaletinin adres bileşeninde iki harfli posta kısaltması kullanılarak longText "Alaska" ve shortText "AK" olabilir.
  • languageCode, bu bileşeni biçimlendirmek için kullanılan dildir (CLDR gösterimiyle).

containingPlaces

Birincil hedefin parçası olduğu daha büyük öğeler (örneğin, bir mağazanın bulunduğu alışveriş merkezi).

subDestinations

Birincil hedefteki daha ayrıntılı konumlar (örneğin, bir binadaki daireler).

entrances

entrances[] dizisindeki nesnelerde aşağıdaki alanlar bulunur:

  • location

    Bir yere giriş ve çıkış noktasının konumunu tanımlayan tek bir enlem/boylam koordinat çifti.

  • entrance_tags[]

    Girişin özelliklerini açıklayan bir giriş etiketi dizisi. Aşağıdaki değer desteklenir:

    • "PREFERRED"

    Bu girişin, döndürülen yere fiziksel erişim sağlama olasılığının yüksek olduğunu gösterir. Bir yerin birden fazla tercih edilen girişi olabilir. Bir giriş bu etikete sahip değilse girişin fiziksel olarak aynı binada olduğu ancak mekana erişim sağlamadığı anlamına gelir.

    Örneğin, döndürülen yer bir alışveriş merkezindeki bir restoransa "PREFERRED" girişleri, restoranın kendi girişleri olurken döndürülen diğer girişler, binanın diğer girişleri (ör. alışveriş merkezindeki diğer restoranların girişleri) olur.

    Döndürülen yerin kendisi bir binaysa "PREFERRED" girişleri, binanın "ana" kısmına giden girişler olur. Örneğin, bir alışveriş merkezinde "PREFERRED" girişleri, ana fuaye alanına erişime izin veren girişlerdir. Ancak bir giriş yalnızca binanın yan tarafındaki bir mağazaya erişim sağlıyorsa bu giriş "PREFERRED" girişi olmaz.

  • streetViewThumbnail ve streetViewAnnotation

    Street View Static API'nin parametreleri sayesinde bu konumlarla ilgili görüntüleri gösterebilirsiniz. Bu alanlar hakkında daha fazla bilgi edinin.

structureType

Bu yerin temsil ettiği yapı türü.

  • POINT

    Nokta konumu.

  • SECTION

    Bir binanın alt bölümü.

  • BUILDING

    Bir bina.

  • GROUNDS

    Genellikle üniversite kampüsü, apartman kompleksi veya alışveriş merkezi gibi birden fazla binanın bulunduğu geniş bir alan.

Coğrafi kodlama yanıtındaki navigationPoints alanı, yere gitmek için yararlı olan noktaların listesini içerir. Özellikle, bir yerden bir yere yol ağı üzerinde rota oluştururken başlangıç veya bitiş noktası olarak kullanılmalıdır.

Her gezinme noktası aşağıdaki değerleri içerir:

  • navigationPointToken, navigationPoints alanındaki bağlamsal bilgileri içeren bir jetondur. Bu jetonu, uygulamanızdaki rota oluşturma ve nehir deneyimini iyileştirmek için rota oluşturma ve gezinme API'lerine gönderebilirsiniz. Daha fazla bilgi için Gezinme noktası jetonlarını kullanarak rota oluşturma başlıklı makaleyi inceleyin.
  • location, gezinme noktasının enlem ve boylam değerini içerir. Bu konum her zaman yol ağına çok yakın olur ve bir yere gitmek veya bir yerden gelmek için ideal bir durma ya da başlangıç noktasını temsil eder. Nokta, yerin bulunduğu yol tarafını net bir şekilde işaretlemek için kasıtlı olarak yolun merkez çizgisinden biraz uzağa yerleştirilir.
  • travelModes, gezinme noktasına erişilebilen seyahat modlarının listesidir:
    • "DRIVE", arabayla yol tariflerine karşılık gelen ulaşım şeklidir.
    • "WALK", yaya yol tariflerine karşılık gelen ulaşım şeklidir.
  • usages, gezinme noktası tarafından desteklenen kullanımların listesidir. Kullanımlar şu şekilde olabilir:
    • "DROPOFF"
    • "PICKUP"
    • "PARKING"

Alış ve bırakma noktaları için seyahat modunun DRIVE, kullanımın ise PICKUP veya DROPOFF olduğu gezinme noktasını kullanın. Teslim alma veya bırakma noktaları yoksa en üstteki sürüş navigasyon noktasını kullanın.

  • altitude_meters, gezinme noktasının WGS-84 elipsoidine göre metre cinsinden yüksekliğini içerir. Dikey olarak üst üste yerleştirilmiş yol segmentlerinin olduğu durumlarda, sisteminizin gideceği en iyi yol segmentini seçmek için altitude_meters alanını kullanın.

landmarks

Kullanıcıların varış noktasının çevresini anlamasına yardımcı olacak, yakındaki önemli yerler.

arrivalSummary

Varış konusunda yardımcı olacak yapay zeka destekli analizler. Yapay zeka destekli özetler bölümüne bakın.

parkingOptions

Ayrıntılı otopark bilgileri.

Yanıt biçimi

SearchDestinations, aşağıdaki JSON biçiminde bir SearchDestinationsResponse döndürür:

{
  "destinations": [
    {
      "primary": {
        "place": "places/ChIJY8sv5-i2j4AR_S6BlDDR42w",
        "displayName": {
          "text": "Arby's",
          "languageCode": "en"
        },
        "primaryType": "fast_food_restaurant",
        "types": [
          "fast_food_restaurant",
          "sandwich_shop",
          "deli",
          "meal_takeaway",
          "food_delivery",
          "american_restaurant",
          "restaurant",
          "food_store",
          "store",
          "food",
          "point_of_interest",
          "establishment"
        ],
        "formattedAddress": "Arby's, 601 S Bernardo Ave, Sunnyvale, CA 94087, USA",
        "postalAddress": {
          "regionCode": "US",
          "languageCode": "en",
          "postalCode": "94087",
          "administrativeArea": "CA",
          "locality": "Sunnyvale",
          "addressLines": [
            "601 S Bernardo Ave"
          ]
        },
        "structureType": "BUILDING",
        "location": {
          "latitude": 37.3734545,
          "longitude": -122.05693269999998
        },
        "displayPolygon": {
          "type": "Polygon",
          "coordinates": [
            [
              [
                -122.056930138027,
                37.3735253692531
              ],
              [
                -122.056960139391,
                37.3735372663597
              ],
              [
                -122.056994129366,
                37.3734828786847
              ],
              [
                -122.056969677395,
                37.3734731161089
              ],
              [
                -122.057061762447,
                37.3733261309656
              ],
              [
                -122.056979388817,
                37.3732935577128
              ],
              [
                -122.056798860285,
                37.3735818838642
              ],
              [
                -122.056875858081,
                37.3736121235316
              ],
              [
                -122.056930138027,
                37.3735253692531
              ]
            ]
          ]
        }
      },
      "containingPlaces": [
        {
          "place": "places/ChIJYfdAFum2j4ARIcL2tjME3Sw",
          "displayName": {
            "text": "Cherry Chase Shopping Center",
            "languageCode": "en"
          },
          "primaryType": "shopping_mall",
          "types": [
            "shopping_mall",
            "point_of_interest",
            "establishment"
          ],
          "formattedAddress": "Cherry Chase Shopping Center, 663 S Bernardo Ave, Sunnyvale, CA 94087, USA",
          "postalAddress": {
            "regionCode": "US",
            "languageCode": "en",
            "postalCode": "94087-1020",
            "administrativeArea": "CA",
            "locality": "Sunnyvale",
            "addressLines": [
              "663 S Bernardo Ave"
            ]
          },
          "structureType": "GROUNDS",
          "location": {
            "latitude": 37.3731231,
            "longitude": -122.0578211
          },
          "displayPolygon": {
            "type": "Polygon",
            "coordinates": [
              [
                [
                  -122.057112227103,
                  37.3714618008523
                ],
                [
                  -122.057076849821,
                  37.3715743611411
                ],
                [
                  -122.056963607756,
                  37.3719081793948
                ],
                [
                  -122.056865279559,
                  37.3722026053835
                ],
                [
                  -122.056687872374,
                  37.3727258358476
                ],
                [
                  -122.056580005889,
                  37.3730511370747
                ],
                [
                  -122.056498845827,
                  37.3732994782583
                ],
                [
                  -122.056338259713,
                  37.3737878663325
                ],
                [
                  -122.056618678291,
                  37.373887693582
                ],
                [
                  -122.056912102521,
                  37.3740010327191
                ],
                [
                  -122.057532418159,
                  37.3742476426462
                ],
                [
                  -122.057673926626,
                  37.3742441740031
                ],
                [
                  -122.057735663106,
                  37.3742328516943
                ],
                [
                  -122.057766531332,
                  37.3742220604378
                ],
                [
                  -122.057797572967,
                  37.37420520725
                ],
                [
                  -122.057828267759,
                  37.3741852342085
                ],
                [
                  -122.058060299297,
                  37.3740060842535
                ],
                [
                  -122.058199726081,
                  37.3737861673422
                ],
                [
                  -122.05836707267,
                  37.373524542556
                ],
                [
                  -122.058569622393,
                  37.3732018598683
                ],
                [
                  -122.0587638478,
                  37.3728890198039
                ],
                [
                  -122.058934661823,
                  37.3726036257774
                ],
                [
                  -122.059164956851,
                  37.3722498383629
                ],
                [
                  -122.058997784906,
                  37.3721804442035
                ],
                [
                  -122.057936479838,
                  37.3717605636234
                ],
                [
                  -122.057495827092,
                  37.3715860151634
                ],
                [
                  -122.057112227103,
                  37.3714618008523
                ]
              ]
            ]
          }
        }
      ],
      "landmarks": [
        {
          "place": {
            "place": "places/ChIJXXTe7Oi2j4ARoMTA-D6Hjpg",
            "displayName": {
              "text": "Chase Bank",
              "languageCode": "en"
            },
            "primaryType": "bank",
            "types": [
              "bank",
              "atm",
              "finance",
              "point_of_interest",
              "establishment"
            ],
            "formattedAddress": "Chase Bank, 1234 W El Camino Real, Sunnyvale, CA 94087, USA",
            "postalAddress": {
              "regionCode": "US",
              "languageCode": "en",
              "postalCode": "94087",
              "administrativeArea": "CA",
              "locality": "Sunnyvale",
              "addressLines": [
                "1234 W El Camino Real"
              ]
            },
            "structureType": "POINT",
            "location": {
              "latitude": 37.373579,
              "longitude": -122.05752700000001
            }
          },
          "relationalDescription": {
            "text": "Near Chase Bank",
            "languageCode": "en"
          },
          "tags": [
            "ARRIVAL",
            "ADDRESS"
          ],
          "straightLineDistanceMeters": 61.182193756103516,
          "travelDistanceMeters": 63.075645446777344
        },
        {
          "place": {
            "place": "places/ChIJteQ0Fum2j4ARGi3tqK4Zm14",
            "displayName": {
              "text": "Safeway",
              "languageCode": "en"
            },
            "primaryType": "grocery_store",
            "types": [
              "grocery_store",
              "butcher_shop",
              "florist",
              "deli",
              "supermarket",
              "bakery",
              "food_delivery",
              "market",
              "manufacturer",
              "food_store",
              "store",
              "food",
              "service",
              "point_of_interest",
              "establishment"
            ],
            "formattedAddress": "Safeway, 639 S Bernardo Ave, Sunnyvale, CA 94087, USA",
            "postalAddress": {
              "regionCode": "US",
              "languageCode": "en",
              "postalCode": "94087",
              "administrativeArea": "CA",
              "locality": "Sunnyvale",
              "addressLines": [
                "639 S Bernardo Ave"
              ]
            },
            "structureType": "POINT",
            "location": {
              "latitude": 37.3727912,
              "longitude": -122.0581172
            }
          },
          "relationalDescription": {
            "text": "Around the corner from Safeway",
            "languageCode": "en"
          },
          "tags": [
            "ARRIVAL",
            "ADDRESS"
          ],
          "straightLineDistanceMeters": 158.65606689453125,
          "travelDistanceMeters": 131.1669921875
        },
        {
          "place": {
            "place": "places/ChIJu-PSYui2j4ARNiwOwBApGqk",
            "displayName": {
              "text": "Oil Changers",
              "languageCode": "en"
            },
            "types": [
              "car_repair",
              "service",
              "point_of_interest",
              "establishment"
            ],
            "formattedAddress": "Oil Changers, 1240 W El Camino Real, Sunnyvale, CA 94087, USA",
            "postalAddress": {
              "regionCode": "US",
              "languageCode": "en",
              "postalCode": "94087",
              "administrativeArea": "CA",
              "locality": "Sunnyvale",
              "addressLines": [
                "1240 W El Camino Real"
              ]
            },
            "structureType": "POINT",
            "location": {
              "latitude": 37.3743054,
              "longitude": -122.0584272
            }
          },
          "relationalDescription": {
            "text": "Down the road from Oil Changers",
            "languageCode": "en"
          },
          "tags": [
            "ARRIVAL"
          ],
          "straightLineDistanceMeters": 140.52459716796875,
          "travelDistanceMeters": 143.24220275878906
        },
        {
          "place": {
            "place": "places/ChIJKRbl5oG3j4ARwuvPGUmtCj0",
            "displayName": {
              "text": "Apni Mandi Farmers Market Sunnyvale",
              "languageCode": "en"
            },
            "primaryType": "grocery_store",
            "types": [
              "grocery_store",
              "cake_shop",
              "supermarket",
              "asian_grocery_store",
              "indian_restaurant",
              "meal_takeaway",
              "bakery",
              "manufacturer",
              "wholesaler",
              "restaurant",
              "food_store",
              "store",
              "food",
              "point_of_interest",
              "establishment"
            ],
            "formattedAddress": "Apni Mandi Farmers Market Sunnyvale, 1111 W El Camino Real, Sunnyvale, CA 94087, USA",
            "postalAddress": {
              "regionCode": "US",
              "languageCode": "en",
              "postalCode": "94087-1056",
              "administrativeArea": "CA",
              "locality": "Sunnyvale",
              "addressLines": [
                "1111 W El Camino Real"
              ]
            },
            "structureType": "POINT",
            "location": {
              "latitude": 37.3737199,
              "longitude": -122.0522958
            }
          },
          "relationalDescription": {
            "text": "Near Apni Mandi Farmers Market Sunnyvale",
            "languageCode": "en"
          },
          "tags": [
            "ADDRESS"
          ],
          "straightLineDistanceMeters": 410.37435913085938,
          "travelDistanceMeters": 479.49893188476562
        },
        {
          "place": {
            "place": "places/ChIJ8enMlui2j4AR2xXK5EHDhBs",
            "displayName": {
              "text": "Starbird Chicken",
              "languageCode": "en"
            },
            "primaryType": "chicken_restaurant",
            "types": [
              "chicken_restaurant",
              "fast_food_restaurant",
              "restaurant",
              "food",
              "point_of_interest",
              "establishment"
            ],
            "formattedAddress": "Starbird Chicken, 1241 W El Camino Real, Sunnyvale, CA 94087, USA",
            "postalAddress": {
              "regionCode": "US",
              "languageCode": "en",
              "postalCode": "94087-1028",
              "administrativeArea": "CA",
              "locality": "Sunnyvale",
              "addressLines": [
                "1241 W El Camino Real"
              ]
            },
            "structureType": "BUILDING",
            "location": {
              "latitude": 37.3746764,
              "longitude": -122.05708860000001
            },
            "displayPolygon": {
              "coordinates": [
                [
                  [
                    -122.057003840785,
                    37.3747648209809
                  ],
                  [
                    -122.057136852459,
                    37.3747919153144
                  ],
                  [
                    -122.057205005705,
                    37.3745815131859
                  ],
                  [
                    -122.057071994114,
                    37.3745544186944
                  ],
                  [
                    -122.057003840785,
                    37.3747648209809
                  ]
                ]
              ],
              "type": "Polygon"
            }
          },
          "relationalDescription": {
            "text": "Near Starbird Chicken",
            "languageCode": "en"
          },
          "tags": [
            "ADDRESS"
          ],
          "straightLineDistanceMeters": 87.348007202148438,
          "travelDistanceMeters": 214.08084106445312
        }
      ],
      "entrances": [
        {
          "location": {
            "latitude": 37.3735328,
            "longitude": -122.05694879999999
          },
          "tags": [
            "PREFERRED"
          ],
          "place": "places/ChIJY8sv5-i2j4AR_S6BlDDR42w"
        }
      ],
      "navigationPoints": [
        {
          "navigationPointToken": "ChIJeMt61tqvQkARWT2716SDXsASEgljyy_n6LaPgBH9LoGUMNHjbBoSCWPLL-foto-AEf0ugZQw0eNsIhIJhf5y6ei2j4ARz7yBW5KAPI4",
          "location": {
            "latitude": 37.3738659,
            "longitude": -122.05693620000001
          },
          "travelModes": [
            "DRIVE",
            "WALK"
          ],
          "usages": [
            "PARKING"
          ]
        }
      ]
    }
  ]
}

Gerekli parametreler

  • Hedef için aranacak adresi, yeri veya konumu belirten aşağıdaki 3 parametreden biri API isteğinde olmalıdır:
    • addressQuery: Aranacak adres.
    • place: Aranacak yerin yer kimliği.
    • locationQuery: Aranacak konumun enlem ve boylam koordinatları.

  • FieldMask

    Yanıt alan maskesi oluşturarak yanıtta döndürülecek alanların listesini belirtin. Yanıt alan maskesini, $fields veya fields URL parametresini ya da X-Goog-FieldMask HTTP üst bilgisini kullanarak yönteme aktarın. Örneğin, aşağıdaki istek yalnızca birincil hedefin girişlerini, gezinme noktalarını ve yer kimliğini döndürür.

      curl -X POST -d '{"place": "places/ChIJG3kh4hq6j4AR_XuFQnV0_t8"}' \
    -H "X-Goog-Api-Key: API_KEY" \
    -H "Content-Type: application/json" \
    -H "X-Goog-FieldMask: destinations.entrances,destinations.navigationPoints,destinations.primary.place" \
    https://geocode.googleapis.com/v4/geocode/destinations

    Yanıtta döndürülen alanların varsayılan bir listesi yoktur. Alan maskesini atlarsanız yöntem hata döndürür. Tüm alanları döndürmek için alan maskesini * olarak ayarlayın. Daha fazla bilgi için Döndürülecek alanları seçme bölümüne bakın.

İsteğe bağlı parametreler

  • travelModes

    Hangi navigationPoints türlerinin döndürüleceğini belirtir. Diğer seyahat modlarına ait gezinme noktaları filtrelenir. travelModes ayarlanmamışsa tüm ulaşım şekillerinin gezinme noktaları döndürülebilir.

  • languageCode

    Sonuçların döndürüleceği dil.

    • Desteklenen dillerin listesini inceleyin. Google, desteklenen dilleri sık sık güncellediği için bu liste eksiksiz olmayabilir.
    • languageCode sağlanmazsa API varsayılan olarak en değerini kullanır. Geçersiz bir dil kodu belirtirseniz API INVALID_ARGUMENT hatası döndürür.
    • API, hem kullanıcı hem de yerel halk için okunabilir bir açık adres sağlamak üzere elinden geleni yapar. Bu hedefi gerçekleştirmek için tercih edilen dili dikkate alarak gerekirse kullanıcının okuyabileceği bir alfabeye çevrilmiş, yerel dildeki sokak adreslerini döndürür. Diğer tüm adresler tercih edilen dilde döndürülür. Adres bileşenlerinin tümü aynı dilde döndürülür. Bu dil, ilk bileşenden seçilir.
    • Ad, tercih edilen dilde mevcut değilse API en yakın eşleşmeyi kullanır.
    • Tercih edilen dil, API'nin döndürmeyi seçtiği sonuç kümesi ve bu sonuçların döndürülme sırası üzerinde küçük bir etkiye sahiptir. Coğrafi kodlayıcı, kısaltmaları dile bağlı olarak farklı şekilde yorumlar. Örneğin, sokak türlerinin kısaltmaları veya bir dilde geçerli olup başka bir dilde geçerli olmayan eş anlamlılar.

  • regionCode

    Bölge kodu, iki karakterlik CLDR kodu değeri olarak. Varsayılan değer yoktur. Çoğu CLDR kodu, ISO 3166-1 kodlarıyla aynıdır.

    Bir adresin coğrafi kodlaması yapılırken (ileri coğrafi kodlama) bu parametre, hizmetten gelen sonuçları belirtilen bölgeyle sınırlayabilir ancak tamamen kısıtlayamaz. Bir konum veya yer coğrafi olarak kodlanırken (ters coğrafi kodlama veya yer coğrafi kodlama), bu parametre adresi biçimlendirmek için kullanılabilir. Bu parametre, her durumda geçerli yasaya göre sonuçları etkileyebilir.

  • placeFilter

    locationQuery arama sonuçlarını, yalnızca binalar olan hedefleri veya yalnızca açık adresleri olan hedefleri döndürme gibi gereksinimlerinizi karşılayacak şekilde filtrelemenize olanak tanır.

    Yapısal ayrıntı düzeyine göre filtreleme

    structureType filtresi, sorgu tarafından döndürülen yapı türlerini belirtmenize olanak tanır:

    • Binaları Ayırma: Haritada bina ana hatlarını göstermek veya belirli bir yapı hakkında ayrıntılı bilgi edinmek için "structureType": "BUILDING" simgesini kullanın.
    • Tesisleri Anlama: Birincil sonucun genel alan olduğundan emin olmak için "structureType": "GROUNDS" simgesini kullanın. Bu özellik, üniversite kampüsleri veya alışveriş merkezleri gibi daha büyük alanlar için sorgu gönderirken kullanışlıdır.
    • Birimlere/Bölümlere Odaklanma: Bir binadaki bölümleri tanımlamak için "structureType": "SECTION" öğesini kullanın.

    Faydalı adresler sağlama

    Bazı yerlerin açık adresleri yoktur. addressability filtresi, sonuçlarınızdaki adreslerin kalitesini kontrol etmenize yardımcı olur:

    • Net Birincil Adres Gerektir: Ana hedef sonucun her zaman sokak düzeyinde bir adresi veya adı olmasını sağlamak için "addressability": "PRIMARY" kullanın. Bu, net bir adresin önemli olduğu gezinme veya görüntüleme amaçları için yararlıdır.
    • Alt Hedeflerde Adreslere İzin Ver: Birincil yerin adresi olmayabilir ancak içindeki birimlerin (ör. bir binadaki daireler) adresi olabilir. Bu gibi durumlarda "addressability": "WEAK", en azından birincil yerin veya alt hedeflerinden birinin adresinin olmasını sağlar.
    • Herhangi bir sonuç: Adres varlığı kullanım alanınızla alakalı değilse "addressability": "ANY" kullanın. Bu yöntem, yalnızca bina ana hatları ve gezinme noktaları gibi geometrik özelliklere ihtiyacınız olduğunda kesinlikle önerilir. Bu sonuçların doğruluğunu artırır.
    Örnek: Adreslenebilir binalar için filtreleme 
    curl -X POST -d '{
  "locationQuery": {
    "location": {
      "latitude": 37.37348780,
      "longitude": -122.05678064
    },
    "placeFilter": {
      "structureType": "BUILDING",
      "addressability": "PRIMARY"
    }
  },
  "languageCode": "en"
}' \\
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \\
-H "X-Goog-FieldMask: place" \\
https://geocode.googleapis.com/v4/geocode/destinations